Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 1,016 Commits
.github		.github
.vscode		.vscode
app		app
extras		extras
release		release
vendor		vendor
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE.md		LICENSE.md
README.md		README.md
SECURITY.md		SECURITY.md

Repository files navigation

Important

FreeSO has shut down its servers as ofDecember 9th 2024. The launcher’s installation features may stop working in the near future.

Please read this blog post for more information:https://freeso.org/the-end/

An archive client is expected to become available in the future, allowing players to visit the archived version of Sunrise Crater. Stay tuned to FreeSO.org for updates.

To uninstall the launcher and/or the software it installed, follow these steps:https://github.com/ItsSim/fsolauncher/wiki/Uninstalling-the-launcher-and-or-installed-software

Thank you for playing FreeSO!

FreeSO Launcher

The official FreeSO Launcher for Windows, macOS, and Linux.

Prerequisites for Development

Latest Node.js LTS on a Windows, macOS, or Ubuntu machine.

Running the Launcher Locally

Clone the repository.
Navigate to theapp folder.
Runnpm install.
Runnpm run start.

Building the Launcher

After cloning and runningnpm install, build the launcher by following the steps below:

For Windows: In theapp folder, runnpm run buildwin.
For macOS: In theapp folder, runnpm run builddarwin.
For Linux: In theapp folder, runnpm run builddeb.

Built binaries are generated in therelease folder (FreeSO Launcher.dmg for macOS,FreeSO Launcher Setup.exe for Windows, andFreeSO Launcher.deb for Linux).

Notes on building for multiple platforms:

If you're using a macOS machine for development, you can generate builds for both macOS and Windows using the commands above. You need to havewine installed before runningnpm run buildwin.
If you're using a Windows machine for development, you can only generate builds for Windows vianpm run buildwin. This is due to the .dmg creation process during macOS builds, which is incompatible with Windows systems.
To build the launcher for Linux vianpm run builddeb, you need to be on a macOS or Linux machine.

Latest Releases

Visit theReleases page to download the latest version of FreeSO Launcher for Windows, macOS, or Linux.

Linux Support

We currently support 64-bit Debian-based distros, like Ubuntu.

From version 1.12.x onwards, a .deb package is included in therelease assets.

Dropped Support for Windows 7/8/8.1 and macOS < 10.15

As of launcher version 1.11.x and onward, we no longer support:

macOS versions < 10.15 (Catalina)
Windows 7, 8, and 8.1.

Users of these operating systems will need to remain on launcher version 1.10.x or earlier. You can find the last 1.10.x releasehere.

This change follows the discontinuation of support for these versions by Electron (and Chromium also) starting with Electron 23. For further details, please refer tothis informative article on the Electron blog.