astra/README.md

# Astra

[![sourcehut](https://img.shields.io/badge/repository-sourcehut-lightgrey.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSINCiAgICB3aWR0aD0iMTI4IiBoZWlnaHQ9IjEyOCI+DQogIDxkZWZzPg0KICAgIDxmaWx0ZXIgaWQ9InNoYWRvdyIgeD0iLTEwJSIgeT0iLTEwJSIgd2lkdGg9IjEyNSUiIGhlaWdodD0iMTI1JSI+DQogICAgICA8ZmVEcm9wU2hhZG93IGR4PSIwIiBkeT0iMCIgc3RkRGV2aWF0aW9uPSIxLjUiDQogICAgICAgIGZsb29kLWNvbG9yPSJibGFjayIgLz4NCiAgICA8L2ZpbHRlcj4NCiAgICA8ZmlsdGVyIGlkPSJ0ZXh0LXNoYWRvdyIgeD0iLTEwJSIgeT0iLTEwJSIgd2lkdGg9IjEyNSUiIGhlaWdodD0iMTI1JSI+DQogICAgICA8ZmVEcm9wU2hhZG93IGR4PSIwIiBkeT0iMCIgc3RkRGV2aWF0aW9uPSIxLjUiDQogICAgICAgIGZsb29kLWNvbG9yPSIjQUFBIiAvPg0KICAgIDwvZmlsdGVyPg0KICA8L2RlZnM+DQogIDxjaXJjbGUgY3g9IjUwJSIgY3k9IjUwJSIgcj0iMzglIiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjQlIg0KICAgIGZpbGw9Im5vbmUiIGZpbHRlcj0idXJsKCNzaGFkb3cpIiAvPg0KICA8Y2lyY2xlIGN4PSI1MCUiIGN5PSI1MCUiIHI9IjM4JSIgc3Ryb2tlPSJ3aGl0ZSIgc3Ryb2tlLXdpZHRoPSI0JSINCiAgICBmaWxsPSJub25lIiBmaWx0ZXI9InVybCgjc2hhZG93KSIgLz4NCjwvc3ZnPg0KCg==)](https://git.sr.ht/~redstrate/astra)
[![GitHub
mirror](https://img.shields.io/badge/mirror-GitHub-black.svg?logo=github)](https://github.com/redstrate/astra)

Astra is a FFXIV launcher that supports
**multiple profiles**, **Dalamud mods**, _and_ **macOS and Linux**!

At the moment, there are a few caveats that are good to know if you use these features:
* There is no **game patching** support, but the launcher will prompt you to launch another launcher anyway.
* There is no **news list** yet.
* The **Steam support is untested.**

Despite this, the launcher is still usable and I use it myself on a regular basis on Linux. I suggest you read more in the [FAQ](https://github.com/redstrate/astra/wiki/Frequently-Asked-Questions)!

![screenshot](misc/screenshot.webp?raw=true)

## Features
* Can use native (Windows) and Wine-based (macOS, Linux) versions of FFXIV.
* You can use Dalamud, which is downloaded within the launcher just like XIVQuickLauncher. 
* Can connect to the official Square Enix servers _as well_ as Sapphire servers.
* Multiple profile support!
  * For example, you can have a regular Square Enix profile and a testing Sapphire profile. Or maybe one for DX11 and another for DX9?
  * These also have seperate, saved logins.
  * All settings can be configured per-profile! 
* Securely saving username and/or password. These are saved per-profile, and are encrypted using your system wallet, and will never be stored unencrypted.
* Encrypted game argument support similiar to what XIVQuickLauncher and the official ffxivboot does, preventing other programs from snooping your login token.
* Enable several (Linux) Wine-specific performance enhancements such as enabling Esync.
* On Linux, take advantafe of Watchdog to help notify you if you've moved in the login queue.
  * Only works on X11.
  * Will send you a notification on any change in the login queue. (moving up, logged in, lobby error, etc)
  * You can view your spot in the queue easily by using the system tray icon.

## Usage
* On [Windows](https://github.com/redstrate/astra/wiki/Windows-Usage)
* On [macOS](https://github.com/redstrate/astra/wiki/macOS-Usage)
* On [Linux](https://github.com/redstrate/astra/wiki/Linux-Usage)
Rename to Astra 2022-02-23 19:00:17 -05:00			`# Astra`
Add initial files 2021-11-01 09:54:58 -04:00
Update README to include shrt repository 2022-02-28 21:07:13 -05:00			[![sourcehut](https://img.shields.io/badge/repository-sourcehut-lightgrey.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSINCiAgICB3aWR0aD0iMTI4IiBoZWlnaHQ9IjEyOCI+DQogIDxkZWZzPg0KICAgIDxmaWx0ZXIgaWQ9InNoYWRvdyIgeD0iLTEwJSIgeT0iLTEwJSIgd2lkdGg9IjEyNSUiIGhlaWdodD0iMTI1JSI+DQogICAgICA8ZmVEcm9wU2hhZG93IGR4PSIwIiBkeT0iMCIgc3RkRGV2aWF0aW9uPSIxLjUiDQogICAgICAgIGZsb29kLWNvbG9yPSJibGFjayIgLz4NCiAgICA8L2ZpbHRlcj4NCiAgICA8ZmlsdGVyIGlkPSJ0ZXh0LXNoYWRvdyIgeD0iLTEwJSIgeT0iLTEwJSIgd2lkdGg9IjEyNSUiIGhlaWdodD0iMTI1JSI+DQogICAgICA8ZmVEcm9wU2hhZG93IGR4PSIwIiBkeT0iMCIgc3RkRGV2aWF0aW9uPSIxLjUiDQogICAgICAgIGZsb29kLWNvbG9yPSIjQUFBIiAvPg0KICAgIDwvZmlsdGVyPg0KICA8L2RlZnM+DQogIDxjaXJjbGUgY3g9IjUwJSIgY3k9IjUwJSIgcj0iMzglIiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjQlIg0KICAgIGZpbGw9Im5vbmUiIGZpbHRlcj0idXJsKCNzaGFkb3cpIiAvPg0KICA8Y2lyY2xlIGN4PSI1MCUiIGN5PSI1MCUiIHI9IjM4JSIgc3Ryb2tlPSJ3aGl0ZSIgc3Ryb2tlLXdpZHRoPSI0JSINCiAgICBmaWxsPSJub25lIiBmaWx0ZXI9InVybCgjc2hhZG93KSIgLz4NCjwvc3ZnPg0KCg==)](https://git.sr.ht/~redstrate/astra)
			`[![GitHub`
			`mirror](https://img.shields.io/badge/mirror-GitHub-black.svg?logo=github)](https://github.com/redstrate/astra)`

Rename to Astra 2022-02-23 19:00:17 -05:00			`Astra is a FFXIV launcher that supports`
			`multiple profiles, Dalamud mods, _and_ macOS and Linux!`
Add initial files 2021-11-01 09:54:58 -04:00
Rename to Astra 2022-02-23 19:00:17 -05:00			`At the moment, there are a few caveats that are good to know if you use these features:`
			`* There is no game patching support, but the launcher will prompt you to launch another launcher anyway.`
			`* There is no news list yet.`
			`* The Steam support is untested.`
Update README 2021-11-10 05:37:45 -05:00
Rename to Astra 2022-02-23 19:00:17 -05:00			`Despite this, the launcher is still usable and I use it myself on a regular basis on Linux. I suggest you read more in the [FAQ](https://github.com/redstrate/astra/wiki/Frequently-Asked-Questions)!`
Add initial files 2021-11-01 09:54:58 -04:00
Update README to include shrt repository 2022-02-28 21:07:13 -05:00			`![screenshot](misc/screenshot.webp?raw=true)`
Add screenshot to README 2021-11-02 20:19:50 -04:00
Add initial files 2021-11-01 09:54:58 -04:00			`## Features`
Rename to Astra 2022-02-23 19:00:17 -05:00			`* Can use native (Windows) and Wine-based (macOS, Linux) versions of FFXIV.`
Note in README that Dalamud is now supported 2021-11-23 14:41:30 -05:00			`* You can use Dalamud, which is downloaded within the launcher just like XIVQuickLauncher.`
Add initial files 2021-11-01 09:54:58 -04:00			`* Can connect to the official Square Enix servers _as well_ as Sapphire servers.`
Update README for multiple profile support 2021-11-09 13:56:35 -05:00			`* Multiple profile support!`
Rename to Astra 2022-02-23 19:00:17 -05:00			`* For example, you can have a regular Square Enix profile and a testing Sapphire profile. Or maybe one for DX11 and another for DX9?`
			`* These also have seperate, saved logins.`
Update README 2021-11-10 05:37:45 -05:00			`* All settings can be configured per-profile!`
Rename to Astra 2022-02-23 19:00:17 -05:00			`* Securely saving username and/or password. These are saved per-profile, and are encrypted using your system wallet, and will never be stored unencrypted.`
			`* Encrypted game argument support similiar to what XIVQuickLauncher and the official ffxivboot does, preventing other programs from snooping your login token.`
Update README for multiple profile support 2021-11-09 13:56:35 -05:00			`* Enable several (Linux) Wine-specific performance enhancements such as enabling Esync.`
Rename to Astra 2022-02-23 19:00:17 -05:00			`* On Linux, take advantafe of Watchdog to help notify you if you've moved in the login queue.`
			`* Only works on X11.`
Add Watchdog Helps you get through the queue with instant access to your place, as well as giving you notifications on lobby errors and what else. At the moment, only supported under X11 and Linux but will grow in the future assuming the queues are still terrible. 2021-12-06 21:15:31 -05:00			`* Will send you a notification on any change in the login queue. (moving up, logged in, lobby error, etc)`
Rename to Astra 2022-02-23 19:00:17 -05:00			`* You can view your spot in the queue easily by using the system tray icon.`
Update README 2021-11-10 05:37:45 -05:00
			`## Usage`
Rename to Astra 2022-02-23 19:00:17 -05:00			`* On [Windows](https://github.com/redstrate/astra/wiki/Windows-Usage)`
			`* On [macOS](https://github.com/redstrate/astra/wiki/macOS-Usage)`
			`* On [Linux](https://github.com/redstrate/astra/wiki/Linux-Usage)`