DignitySAMP/open.mp-linux-launcher

open.mp Linux Launcher

open.mp launcher for Linux written in Rust with Ratatui.

Browse the open.mp server list in the terminal and join servers through Wine. The SA-MP and open.mp client files are downloaded from open.mp automatically.

This was built to serve my personal need for having a server browser on Arch. If you find any issues, feel free to open an issue or a PR.

Requirements

• Wine and winetricks
• GTA San Andreas 1.0 US installed in a Wine prefix

Install

Download the binary from the releases and run omp-tui --install-desktop, or build it:

rustup target add i686-pc-windows-msvc   # for the embedded Windows helper, needs lld
cargo build --release
./target/release/omp-tui --install-desktop

Usage

Run omp-tui. The first boot finds Wine and the game, downloads the client files and opens the server list. Additionally, you can also use the mouse to select or join a server, browse the tabs or search. It also works in the popups (click outside of one to close it) and on the links in the server details.

Keys

It comes with some shortcuts: ENTER to join a server, F to favourite, / to search, w to open a server's website, D to open a server's discord (open.mp servers only), , to open settings and ? to list all usable keys.

Command line

Alternatively, you can join straight from a link:

omp-tui omp://1.2.3.4:7777
omp-tui samp://1.2.3.4:7777

You can launch the game directly without the UI by using the same flags as the original launcher:

omp-tui -h 1.2.3.4 -p 7777 -n Nick -g "/path/to/GTA San Andreas" -P password

If the server does not require a password, you don't have to pass the optional -P flag.

Other flags

You can also use --help to see all flags, --no-omp to play without open.mp injected and --version.

Files

For debugging, you can change the logging state to debug to get detailed information. OMPTUI_LOG=debug.

Notes

Not affiliated with the open.mp or SA-MP projects. AI was used for the injector and package management.

Saved server passwords are encrypted with XChaCha20-Poly1305. A 32-byte random key is generated once and stored in ~/.local/share/omp-tui/secret.key, so sharing or backing up lists.toml does not leak them.

For troubleshooting, use omp-tui --check to see why the game failed to launch.

If the game crashes when you press Esc or right after you spawn, the prefix is probably missing the Arial font. The launcher installs it automatically when you first do a clean boot, but for existing prefixes head to Settings > Install Arial into the prefix, or run winetricks arial yourself.

Optionally, you can go to Settings > Install DXVK into the prefix. It downloads the latest DXVK release from Github and needs a Vulkan driver. omp-tui --check shows which of wined3d or DXVK the prefix uses.

Network disclosure: by default, when the launcher starts, it sends a request to Github and compares the latest release with the one you are running. This is done to show you a notice if there's a new update. You can turn it off in Settings.