Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/legendary-gl/legendary/llms.txt

Use this file to discover all available pages before exploring further.

Legendary can be installed in several ways depending on your platform and preferences. The PyPI package is the recommended method for all platforms because it always delivers the latest release and makes upgrades straightforward. Prebuilt standalone binaries are available for users who do not want to install Python, and Linux users can also use their distribution’s package manager.
32-bit operating systems are not supported on any platform. Make sure you are running a 64-bit OS before proceeding. Windows users must use Python below 3.14 — pythonnet is not yet compatible with Python 3.14+.
1

Install via PyPI (Recommended)

First, upgrade pip to avoid permission issues during installation:
python3 -m pip install -U pip --user
Then install Legendary:
pip install legendary-gl
To enable the optional embedded webview login (recommended for a smoother authentication experience), install the webview extra. On Ubuntu and other GTK-based distros, install the system dependency first:
sudo apt install python3-gi-cairo
pip install legendary-gl[webview]
Alternatively, the GTK backend can be installed directly — this may require you to manually install dependencies needed to build PyGObject:
pip install legendary-gl[webview_gtk]
Using pywebview’s Qt engine may not work correctly. If the legendary command is not found after installation, add ~/.local/bin to your PATH (see Step 2).
2

Add Legendary to your PATH

If the legendary executable is not found after a pip install --user installation, add the local bin directory to your shell’s PATH:
echo 'export PATH=$PATH:~/.local/bin' >> ~/.profile && source ~/.profile
3

Alternative: Prebuilt standalone binary

If you prefer not to install Python, download the prebuilt legendary binary from the latest GitHub release.Move the binary to a directory that is already on your PATH, then make it executable:
chmod +x legendary
mv legendary ~/.local/bin/legendary
The Linux prebuilt binary is created with PyInstaller and requires glibc ≥ 2.25. Older distributions such as Ubuntu 16.04 or Debian Stretch are not supported by this method.
4

Alternative: Linux package managers

Several distributions ship community-maintained Legendary packages. Note that third-party packages may lag behind the latest release — use PyPI if you always want the newest version.
DistributionRepository
Arch LinuxAUR (legendary)
FedoraOfficial repositories
openSUSEOfficial repositories
GentooThird-party overlay
See the Available Linux Packages wiki page for installation details for each distro.
5

Alternative: Install from source (dev/testing)

Clone the repository and use uv to set up the environment. This installs Legendary in non-editable mode:
git clone https://github.com/derrod/legendary.git
cd legendary
uv sync --no-editable
For development (editable mode), where any changes to the source code take effect immediately:
uv sync
See the uv installation docs to install uv if you do not have it yet.

​
Verify the Installation

Once installed, confirm Legendary is working by checking the version: 
legendary --version
You should see output like Legendary vX.X.X - "Codename". If the command is not found, revisit the PATH setup step for your platform. You are now ready to authenticate and start playing.

Build docs developers (and LLMs) love

Get started for freeTalk to us