You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Daniel Scalzi f3c1e42a03
18 hours ago
.github Electron 23, Node 18. 1 month ago
app Fix style violation. 2 weeks ago
build Rebrand to Helios Launcher. 4 years ago
docs 1.17+ Support / Java Settings by Instance (#261) 4 months ago
libraries/java Update PackXZExtract. 2 years ago
.eslintignore Node v12, Dependency Upgrade. 4 years ago
.eslintrc.json Improve logging. 3 months ago
.gitignore Begining to transition over to electron-builder for building the app. Currently in a testing phase for this, gradually refining the build options. Once electron-builder has been fully implemented, the electron-packager scripts will be removed. Also updated electron to address a security issue. 5 years ago
.nvmrc Electron 23, Node 18. 1 month ago
LICENSE.txt Show GitHub actions build status in the README. 1 year ago Electron 23, Node 18. 1 month ago
dev-app-update.yml Rebrand to Helios Launcher. 4 years ago
electron-builder.yml Show GitHub actions build status in the README. 1 year ago
index.js Update to Electron 17, fix deleting drop-in mods from the settings view. 1 year ago
package-lock.json v1.10.0 18 hours ago
package.json v1.10.0 18 hours ago

aventium softworks

Helios Launcher

(formerly Electron Launcher)

gh actions downloads winter-is-coming

Join modded servers without worrying about installing Java, Forge, or other mods. We'll handle that for you.

Screenshot 1 Screenshot 2


  • 🔒 Full account management.
    • Add multiple accounts and easily switch between them.
    • Microsoft (OAuth 2.0) + Mojang (Yggdrasil) authentication fully supported.
    • Credentials are never stored and transmitted directly to Mojang.
  • 📂 Efficient asset management.
    • Receive client updates as soon as we release them.
    • Files are validated before launch. Corrupt or incorrect files will be redownloaded.
  • Automatic Java validation.
    • If you have an incompatible version of Java installed, we'll install the right one for you.
    • You do not need to have Java installed to run the launcher.
  • 📰 News feed natively built into the launcher.
  • Intuitive settings management, including a Java control panel.
  • Supports all of our servers.
    • Switch between server configurations with ease.
    • View the player count of the selected server.
  • Automatic updates. That's right, the launcher updates itself.
  • View the status of Mojang's services.

This is not an exhaustive list. Download and install the launcher to gauge all it can do!

Need Help? Check the wiki.

Like the project? Leave a star on the repository!


You can download from GitHub Releases

Latest Release

Latest Pre-Release

Supported Platforms

If you download from the Releases tab, select the installer for your system.

Platform File
Windows x64 Helios-Launcher-setup-VERSION.exe
macOS x64 Helios-Launcher-setup-VERSION-x64.dmg
macOS arm64 Helios-Launcher-setup-VERSION-arm64.dmg
Linux x64 Helios-Launcher-setup-VERSION.AppImage


To open the console, use the following keybind.

ctrl + shift + i

Ensure that you have the console tab selected. Do not paste anything into the console unless you are 100% sure of what it will do. Pasting the wrong thing can expose sensitive information.

Export Output to a File

If you want to export the console output, simply right click anywhere on the console and click Save as..

console example


This section details the setup of a basic developmentment environment.

Getting Started

System Requirements

Clone and Install Dependencies

> git clone
> cd HeliosLauncher
> npm install

Launch Application

> npm start

Build Installers

To build for your current platform.

> npm run dist

Build for a specific platform.

Platform Command
Windows x64 npm run dist:win
macOS npm run dist:mac
Linux x64 npm run dist:linux

Builds for macOS may not work on Windows/Linux and vice-versa.

Visual Studio Code

All development of the launcher should be done using Visual Studio Code.

Paste the following into .vscode/launch.json

  "version": "0.2.0",
  "configurations": [
      "name": "Debug Main Process",
      "type": "node",
      "request": "launch",
      "cwd": "${workspaceFolder}",
      "program": "${workspaceFolder}/node_modules/electron/cli.js",
      "args" : ["."],
      "outputCapture": "std"
      "name": "Debug Renderer Process",
      "type": "chrome",
      "request": "launch",
      "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron",
      "windows": {
        "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron.cmd"
      "runtimeArgs": [
      "webRoot": "${workspaceFolder}"

This adds two debug configurations.

Debug Main Process

This allows you to debug Electron's main process. You can debug scripts in the renderer process by opening the DevTools Window.

Debug Renderer Process

This allows you to debug Electron's renderer process. This requires you to install the Debugger for Chrome extension.

Note that you cannot open the DevTools window while using this debug configuration. Chromium only allows one debugger, opening another will crash the program.

Note on Third-Party Usage

Please give credit to the original author and provide a link to the original source. This is free software, please do at least this much.

For instructions on setting up Microsoft Authentication, see


The best way to contact the developers is on Discord.


See you ingame.