# ESLauncher2
A program for organizing Endless Sky installations.

### Currently supported features:
- Install [Continuous Builds](https://github.com/endless-sky/endless-sky/releases/tag/continuous)
- Install Development build of PRs
- Install specific versions
- Update instances
- Play instances
- Install & manage plug-ins

### Installation
[![Download for Windows](https://badgen.net/badge/Windows/Download/green?icon=windows)](https://github.com/EndlessSkyCommunity/ESLauncher2/releases/latest/download/eslauncher2-x86_64-pc-windows-msvc.exe)
[![Download for Linux](https://badgen.net/badge/Linux/Download/green?icon=terminal)](https://github.com/EndlessSkyCommunity/ESLauncher2/releases/latest/download/eslauncher2-x86_64-unknown-linux-gnu)
[![Download for Linux](https://badgen.net/badge/DEB/Download/green?icon=terminal)](https://github.com/EndlessSkyCommunity/ESLauncher2/releases/latest/download/eslauncher2.deb)
[![Download for Linux](https://badgen.net/badge/RPM/Download/green?icon=terminal)](https://github.com/EndlessSkyCommunity/ESLauncher2/releases/latest/download/eslauncher2.rpm)
[![Download for Linux](https://badgen.net/badge/OSX/Download/green?icon=apple)](https://github.com/EndlessSkyCommunity/ESLauncher2/releases/latest/download/ESLauncher2.app.zip)
- Download the latest version for your OS from these^ icons, or [the release page](https://github.com/EndlessSkyCommunity/ESLauncher2/releases).
- For Arch Linux, there's also an AUR package [`eslauncher2`](https://aur.archlinux.org/packages/eslauncher2) maintained by @DisableGraphics.

### Additional instructions for Mac
**Important**: the security mechanisms of newer MacOS systems do not allow running
unsigned applications. Therefore, please follow the steps below the first time
you run the launcher on MacOS.

#### Instructions ####
- Download the release to a location of your choice
- Open Finder and navigate to that location
- Unzip the file (usually double clicking on it is enough)
- Right click on the extracted ESLauncher2.app and select "Open"

![Screenshot 1](doc/mac_screenshot_0.png?raw=true)


- If you get presented with a dialogue with 2 options, click cancel and repeat
above step

![Screenshot 2](doc/mac_screenshot_1.png?raw=true)


- Once you see the dialogue with 3 options, select "Open"

![Screenshot 3](doc/mac_screenshot_2.png?raw=true)


- The Launcher should open and from now on you can run it by just double-clicking
on it.

**Instructions for MacOS Sonoma, Sequoia and later:** On the newest versions of MacOS (15.x 26.x+)
you may see a different error message when trying to run the application. If you see a dialogue
saying that the app is damaged and cannot be opened then you need to remove the MacOS quarantine flags:

![Screenshot 3](doc/mac_screenshot_3.png?raw=true)

- Take note of where you downloaded and extracted the application. You'll need to run a command against the unzipped `.app`
- Open the Terminal (use your Launchpad or press command-space on your keyboard to bring up Spotlight Search and start typing `terminal.app`)
- Once the Terminal opens, you'll need to change directory to your download location `cd ~/Downloads`
- Run this command `xattr -d com.apple.quarantine ESLauncher2.app`
- The command will not produce any output if it is successful. If you see an error "No such file" check your location
- Close the Terminal. You should now be able to run the launcher, or move it to a location of your choice using Finder

Please note: sometimes the launcher may open in the background. If you hear the music playing, check in the Dock, you should find it running there.