Why does installation fail at "Minimal Qt setup"?
NodeGui currently relies on the Qt framework to acheive cross-platform native interfaces. The library uses a minimal configuration of specific open source Qt components which are downloaded upon installation.
If the server which hosts the component binaries is down or unavailable, the installation will fail and you might see something along the lines of:
In this scenario, you would need to find a mirror (alternate domain) for the binaries which can then be substituted using the
QT_LINK_MIRROR environment variable. Let's assume we've found an active mirror, for example,
https://qt-mirror.dannhauer.de, we can then follow these steps to configure the installation:
Unix / MacOS
Now, instead of requesting the resource from
as in the example above, the script responsible for installing these components would use
If this does not solve your problem, please make sure you have installed all the necessary requirements
Why am I having trouble installing Qode?
npm install @nodegui/qode, some users occasionally encounter
In almost all cases, these errors are the result of network problems and not
actual issues with the
@nodegui/qode npm package. Errors like
ETIMEDOUT are all indications of such
network problems. The best resolution is to try switching networks, or
wait a bit and try installing again.
You can also attempt to download Qode directly from
if installing via
npm is failing.
As you would have noticed, the list of methods and properties are less compared to what is present in the Qt's corresponding widget class. This is because we havent written wrappers for them yet. You can help add more methods by following the development guide for contributors. Overtime this gap would reduce.
When will Qode upgrade to latest Node.js / Qt version?
When a new version of Node.js/Qt gets released, we usually wait for about a month before upgrading the one in Qode. So we can avoid getting affected by bugs introduced in new Node.js/Qt versions, which happens very often.
My app's window/widgets/tray disappeared after a few minutes.
This happens when the variable which is used to store the window/tray gets garbage collected.
If you encounter this problem, the following articles may prove helpful:
If you want a quick fix, you can make the variables global by changing your code from this: