() Converting to ReactjS > Follow progress here: https://github.com/FalixNodes-Software/FalixNodes-Desktop/tree/reactjs-revamp
Simple and stylish to use! Access FalixNodes features such as your client and game panel, help center, phpMyAdmin, status, and more all from a centralized place.
Q: Why and what's the point of this software?
A: Originally, a member of the community developed the software to avoid having to use their web browser to access FalixNodes. FalixNodes Desktop was designed to be a simple and quick method to access FalixNodes' services, and it still is.
Q: Who is the developer of FalixNodes Desktop?
A: FalixNodes Desktop is developed and owned by Korbs Studio. To be clear, Korbs Studio owns the code to ONLY FalixNodes Desktop for desktop and does NOT have ownership over FalixNodes itself.
Q: Can I use FalixNodes Desktop?
A: It supports Windows 7/8/10/11, macOS Yosemite and up, and Linux. You may be able to run FalixNodes Desktop on a chromebook as well.
As for mobile, you can try out our mobile app, which serves the same purpose as our desktop software.
Q: Is this official software by FalixNodes?
A: Yes, FalixNodes Desktop has been approved official software for FalixNodes.
Q: How do I update it?
A: This is done automatically on Windows and Linux. We recommend that you wait at least 1 - 2 minutes for the update to download in the background, or depending on your internet speed.
On macOS, each update must be installed manually by the user. No, you are not required to do this on a regular basis; nevertheless, upgrading is recommended if you want the most up-to-date version in general. Given the fact that updates need the signing of the DMG file, we are already working on certifying the DMG file using our Apple Certificate.
FAQ - For Developers
Q: Why is Font Awesome included offline? Just use a script instead.
A: I understand that using one line of code, in this case a link to the Font Awesome script, will do the trick. Yes, you can do that, but the reason why I'm including Font Awesome locally with the software is for offline usage.
If the user is not connected to the internet, the software's icons will not load unless Font Awesome is installed locally.
Q: Why Electron and what is it?
A.2 (What): Electron is an open-source software framework developed and maintained by GitHub. It allows for the development of desktop GUI applications using web technologie. It combines the Chromium rendering engine and the Node.js runtime. - Wikipedia
Development and Building
- Using latest version of ElectronJS
- Using latest version of Electron Builder
- Using latest version of Glasstron
- Update server is pointed to correct source
- FalixNodes Desktop starts up with no errors on all platforms
- Linux (Bad Atom error allowed if on GNOME(X11) Desktop)
Preparing to Develop FalixNodes Desktop
To run FalixNodes Desktop in development mode and later build it, you must have the following installed on your workstation:
- NodeJS 16 and up
- Pyton 3.10 and up
- g++ (Linux)
- Visual Studio (Windows)
- Development with C++
- Visual C++ Redistributable (Windows)
- At least 8GB of storage
It's also a good idea to have a capable code editor and be familiar with the fundamentals of the ElectronJS framework.
Building FalixNodes Desktop
Electron Builder Environment
You should probably adjust a few additional things for Electron Builder before building.
First off, what is Electron Builder?
We can easily distribute FalixNodes Desktop cross-platform using Electron Builder, which has auto-update support out of the box. We can also distribute our software in other formats if we wanted to like Snap, MSI, PKG, etc.
What needs to be changed?
We include assets with our setup files like banners, backgrounds, and licenes. If you're planning on building your software on top of a fork of FalixNodes Desktop, it's best you change these to not confuse users who will use your fork.
Everything you need to change is located in the
/build folder, also note that any files in this folder won't be distrbuted as part of the software itself. So if you were to set the software icon, and point to the icon file in the build folder, it won't work in production. The build folder is for Electron Builder only.
You need to change the following files as they may include the name "FalixNodes" or include screenshots of previous versions of FalixNodes Desktop:
/build/background.png- Background of the DMG installer (macOS)
/build/installSidebar.bmp- Sidebar banner of the NSIS installer (Windows)
/build/license_*.txt- All license files
/build/icons/ - Obviously the icon, the icon included is trademark of FalixNodes Limited
A Figma file is included if you want to the same layout for the background and banner, Figma is a free tool to use.
Another thing to change is the metadata of FalixNodes Desktop like the ID, name, versions, update server location, and more.
The following should be changed in package.json:
- Under build config:
- This tells the software where to pull new updates from
- Example: com.electron.app
Also if you plan to leave the settings page mostly as is, make sure to update the version number manually in there.
Now to build the actual software, this process has been made more simple over time during the development of FalixNodes Desktop, all thanks to GitHub Actions and Electron Builder.
With Electron Builder, you can simply run:
npm run build
Then Electron builder will start building for your operating system.
If you desire to, or are required to, create the software for multiple operating systems, you may leverage GitHub Actions. Using GitHub Actions, you can write software on many operating systems without having to use them. You can build a DMG file for macOS, for example, without owning or having access to a Mac. Workflow files have been added and are ready to be deployed.