winget install --id=Lonestill.OnyxLauncher -e Onyx Launcher is a modern Minecraft launcher for Windows and Linux. It manages isolated game instances, Vanilla and popular mod loaders, Modrinth modpacks and mods, automatic Eclipse Temurin runtimes, crash diagnostics, world snapshots, backups, and per-instance performance settings.
A modern, fast, zero-bloat Minecraft launcher for Windows and Linux, built with Electron, React, and TypeScript. Onyx features 1-click universal migration from all major launchers, built-in 3D skin & cape studio, automated crash bisect diagnostics, and isolated instance management.
Download the latest release (v1.6.11) · 💬 Discord Community · Good first issues · Contribute
Got questions, hit a crash, want to suggest a feature, or test upcoming beta builds? Join our official Discord server:
| Home | Library |
|---|---|
 |  |
| Modrinth Catalog | CurseForge Official Catalog |
|---|---|
 |  |
| Mod Details (Overview & Gallery) | Mod Versions & 1-Click Install |
|---|---|
 |  |
| Curated Onyx Picks | Universal 1-Click Migration |
|---|---|
 |  |
| Instance Details & Flight Recorder | 3D Skin & Cape Studio |
|---|---|
 |  |
| Settings & Live Auto-Updater |
|---|
 |
All screenshots are generated from the current English UI with npm run capture:screenshots.
.onyxprofile..onyxpack backups, and repair tools..mrpack and CurseForge manifest installation, dependency resolution, and updates.safeStorage; tokens remain memory-only when secure storage is unavailable.Via Scoop:
scoop bucket add onyx https://github.com/lonestill/scoop-onyx
scoop install onyx/onyx-launcher
Direct download:
Download an installer or portable archive from the latest GitHub Release:
Onyx.Launcher.Setup.1.6.8.exeOnyx.Launcher.1.6.8.exeWindows builds are unsigned, so SmartScreen may display a warning on first launch.
Arch Linux (AUR):
yay -S onyx-launcher-bin
# or build manually with makepkg from packaging/aur
Direct download:
Download from the latest GitHub Release:
Onyx-Launcher-1.6.8-x86_64.AppImageOnyx-Launcher-1.6.8-linux-x64.tar.gzThe SHA-256 checksum files attached to each release can be used to verify that a downloaded file matches the published release asset.
Open PowerShell in the directory containing the downloaded .exe file and run:
Get-FileHash -Algorithm SHA256 .\*.exe
Compare the resulting Hash value with the matching entry in SHA256SUMS-windows.txt.
Open a terminal in the directory containing the downloaded AppImage and run:
sha256sum --ignore-missing --check SHA256SUMS-linux.txt
The command prints OK when the downloaded AppImage matches its entry in SHA256SUMS-linux.txt.
A matching SHA-256 checksum confirms that the downloaded file matches the published release asset. It does not provide a code signature or prove who created the file.
Small, focused pull requests are welcome. You can start with a curated good first issue, pick any task marked help wanted, or discuss a larger change in Ideas.
The contribution guide contains the codebase map, local setup, and verification commands. If an issue is unassigned, leave a short comment and start working on it; you do not need to wait for a formal assignment.
Requirements:
npm ci
npm run dev
Run the complete local verification suite:
npm run check
Individual commands are also available:
npm run typecheck
npm run lint
npm test
npm run build:renderer
Regenerate every README screenshot from a deterministic local fixture:
npm run capture:screenshots
The repository uses two GitHub Actions workflows:
CI validates every pull request.Release batches merged changes into a weekly Friday release and can also be started manually for an urgent release. A scheduled run exits without creating a version when there are no commits since the latest tag.A successful release workflow:
npm ci and runs npm run check;package.json and package-lock.json;chore(release): vX.Y.Z and creates the matching Git tag;Set Settings → Actions → General → Workflow permissions to Read and write permissions. If the release branch is protected, allow github-actions[bot] to push the release commit and tag.
# Windows NSIS installer and portable executable
npm run dist:windows
# Linux AppImage
npm run dist:linux
# Linux portable tar.gz
npm run dist:linux:archive
Build output is written to release/ and is intentionally excluded from Git.
On Windows:
%APPDATA%\onyx-launcher\state.json;%APPDATA%\onyx-launcher\account.json;%APPDATA%\.onyx\instances;%APPDATA%\.onyx\shared;%APPDATA%\.onyx\runtimes;%APPDATA%\.onyx\packs;%APPDATA%\.onyx\backups.On Linux, launcher state follows XDG under ~/.config/onyx-launcher, while game data is stored in ~/.local/share/onyx. A legacy ~/.config/.onyx data directory is detected automatically.
src/ is an isolated React renderer without Node.js access.electron/preload.cjs exposes a narrow IPC bridge.electron/main.cjs owns windows, state, filesystem access, and system operations.electron/services/ contains authentication, Minecraft installation, Modrinth, networking, backups, diagnostics, performance, and data-safety services.The renderer uses contextIsolation, Electron sandboxing, and disabled nodeIntegration. Navigation, webviews, and browser permissions are restricted. Network and filesystem operations stay in the main process.
Diagnostic exports redact tokens, personal paths, email addresses, and server IPs. Please review SECURITY.md before reporting a vulnerability.
Onyx currently defaults to the public Prism Launcher Microsoft OAuth client ID and its consumer device-code flow. A custom client ID can be supplied for development:
$env:ONYX_MICROSOFT_CLIENT_ID="your-client-id"
npm run dev
Refresh tokens are tied to the client ID. Accounts must be added again after changing it.
See CONTRIBUTING.md for the development and pull-request workflow.
Onyx does not distribute Minecraft or bypass its license. Game files are downloaded directly from Mojang, and third-party content is downloaded from URLs provided by Modrinth APIs and manifests. A licensed Microsoft account is required for the full Minecraft: Java Edition experience.
Onyx Launcher is an independent project and is not affiliated with Microsoft, Mojang Studios, or Modrinth. Minecraft is a trademark of Microsoft.
Released under the MIT License. Third-party attributions are listed in THIRD_PARTY_NOTICES.md.