tgeorgiadis / quiver-launcher

# Quiver Launcher
> **About** - **Quiver Launcher** is a fork of GithubLauncher, extended with the features I wanted: **tag filters**, **library management with the Quiver catalog**, **mod management support**, **UI improvements** and more. It was rebranded from GithubLauncher to avoid using the GitHub trademark.
A modern launcher for downloading, installing, and running apps from GitHub and GitLab releases. With a personal library, the Quiver catalog, and flexible filtering.
## Features
- **Tag filters** - Organize and filter your library with custom tags
- **Library search** - Filter the current list by name, tags, repository, or folder
- **Manually managed apps** - Add apps with no GitHub/GitLab repository; drop files into the app folder and open it from the library
- **App Catalog** - Search the quiverlauncher.com catalog by project type, platform, console and AI use, see how apps run for other players, and add them to your library
- **GitHub & GitLab releases** - Install and update apps from GitHub or gitlab.com release assets
- **Mod Management Support** - Browse, install and update mods from Thunderstore and GameBanana
- **Automated updates** - Download and install the latest releases automatically
- **Version management** - Automatic version checking and in-app update checks
- **UI improvements** - Refined layout and top-bar controls
## Getting Started
### Installation
**Note if you are upgrading from 2.4.x or older:** the in-app update cannot migrate Quiver Launcher 2.4.x onto version 3.0 or higher. Download a fresh 3.x version of Quiver Launcher and copy your library over. See MIGRATING.md.
**Windows**
1. Download `QuiverLauncher-win-Portable.zip` from Releases
2. Extract it
3. Run `QuiverLauncher.exe` from the extracted folder
Your library stays in that same folder (`apps.json`, `settings.json`, `Apps/`, `Cache/` next to `current/`), so you can move the whole directory wherever you want.
 [code] 
To verify a signed `QuiverLauncher.exe`: right-click → Properties → Digital Signatures, or `Get-AuthenticodeSignature .\QuiverLauncher.exe` in PowerShell.
**Linux**
1. Download `QuiverLauncher-linux-x64.AppImage` or `QuiverLauncher-linux-arm64.AppImage` from Releases
2. Put the AppImage in its own folder (it creates library files beside itself), mark it executable, then run it:
 [code] 
 Or right-click → Properties → Permissions → **Allow executing file as a program**. 
 GitHub downloads do not keep the executable bit; you need to set it locally after download.
Library data (`apps.json`, `settings.json`, `Apps/`, `Cache/`) is stored **beside the AppImage** so you can move that folder together. If the AppImage’s directory is not writable (e.g. `/usr/local/bin`), Quiver Launcher falls back to `~/.local/share/QuiverLauncher/` (or `$XDG_DATA_HOME/QuiverLauncher`).
 [code] 
**macOS**
Currently macOS support is a work in progress.
1. Download the macOS package from Releases
2. Keep `QuiverLauncher.app` in a writable folder (not only `/Applications`