1
Fork 0
mirror of https://github.com/redstrate/Astra.git synced 2025-04-22 20:47:45 +00:00
astra/README.md
Joshua Goins 16420b7421 Complete rewrite to Kirigami
Giant commit overhauling the interface to use KDE's Kirigami framework,
which is based on Qt Quick. The logic is all but rewritten, allowing
accounts to be separate from profiles.
2023-07-30 08:49:34 -04:00

3.3 KiB

Astra

A custom FFXIV launcher that supports multiple accounts, Dalamud plugins and runs natively on Linux!

Notice

Astra is beta software. Despite this, the launcher is feature complete, but you may find it lacking for the use-cases below:

Main Screenshot

If you still have questions, please read the FAQ first.

Features

  • Handles running Wine for you, creating a seamless and native-feeling launcher experience!
    • Can also easily enable several Linux-specific enhancements such as Fsync or configuring Gamescope.
  • Multiple account support!
    • Can associate a Lodestone character with an account to use as an avatar.
  • Easily install and use Dalamud plugins.
  • Game patching support.
  • Securely login to the official Square Enix lobbies, as well as Sapphire servers.
    • Game arguments are encrypted by default, providing the same level of security as other launchers.
    • Saving account usernames and passwords are also supported, and is never stored plaintext.
  • Can install FFXIV on new systems for you, bypassing the normal InstallShield installer.

Installation

Precompiled binaries are available to download from the website.

There are also numerous options available:

Distribution packaging is encouraged, so please send an email through the mailing list for any concerns.

Building

Note: Some dependencies will automatically be downloaded from the Internet if not found on your system. This functionality will change in the future to ease distribution packaging. You can control this functionality using the USE_OWN_LIBRARIES CMake option.

The wiki has dedicated platform-specific pages for build instructions as well as important usage information.

Contributing and Support

The best way you can help Astra is by monetarily supporting me or by submitting patches to fix bugs or add functionality. I work on Astra and my other FFXIV projects in my free time, so any support helps to let me continue what I do!

If you have changes you wish to submit, you can use git send-email or the sourcehut web contributor interface!

If you wish to file a bug report, or feature request please see the bug tracker.

For general discussion about the launcher, potential features and so on, send an email through the mailing list. I discourage contacting me privately unless necessary, so that everyone can benefit from the discussion.