open.mp Launcher TUI

[deft sleet]

Disclaimer: this code is heavily generated by AI and I create it to resolve my problems.

I've an issue while launch open.mp launcher in Wine, but the UI is not showing and it's documented on the open.mp docs. So, I created my own launcher that should compatible in any platforms.

https://github.com/rsetiawan7/omp-launcher-tui/

Any feedbacks are welcome!

[deft sleet]

Update v1.1.0:

• Version filtering (0.3.7, 0.3.DL, open.mp)
• Smart caching with 24-hour validity
• 500ms debounce on server selection to prevent unnecessary fetch on browsing
• Combined search and filter display
• Manual refresh behavior
• Cache data preservation (ping, players, rules)
• Enhanced sorting (0 ping servers at bottom)

[deft sleet]

Changes and Features in v1.2.0

CLI Mode Features
Export/Import Commands

• Export entire configuration to single JSON file (config + favorites + master lists)
• Import with confirmation prompt and data preview
• Automatic directory creation for export
• Versioned export format with metadata and timestamps
• Summary statistics shown (favorites count, master lists count)

Init Command Enhancements

• --gta-path flag for automated GTA SA path setup
• --omp-launcher flag for automated launcher path setup
• Enables scripted/CI deployment without manual configuration

Connect Command Improvements

• Port defaults to 7777 when not specified
• Better error messages guiding users to run init first
• Supports both 127.0.0.1 and 127.0.0.1:7777 formats

Windows Platform Support

• Automatic architecture detection (32-bit vs 64-bit)
• Default GTA SA paths:
• 64-bit: C:\Program Files (x86)\Rockstar Games\GTA San Andreas
• 32-bit: C:\Program Files\Rockstar Games\GTA San Andreas
• Default OMP launcher paths:
• 64-bit: C:\Program Files (x86)\Open Multiplayer Launcher
• 32-bit: C:\Program Files\Open Multiplayer Launcher

TUI (Interactive) Mode Features

Server Alias System

• Custom aliases for favorite servers
• Alias prompt when adding to favorites
• Alias field in manual add dialog
• Display alias instead of server name in listings
• Search by alias in favorites view
• Validation: alphanumeric, dash, underscore only
• Uniqueness check prevents duplicate aliases

Enhanced Search

• Favorites search now covers server name, alias, and address

Core Improvements
Launcher Module

• Refactored path resolution logic
• Better directory-based launcher detection
• Supports both omp-launcher.exe and omp-launcher executables

Configuration System

• Alias field added to FavoriteServer structure
• Alias uniqueness validation
• Random nickname generation following SA-MP rules (3-20 chars, alphanumeric + special chars)
• Export data structure with versioning and timestamps

[rapid fractal]

we got a tui samp launcher before gta 6

[vivid stratus]

good job

[lusty bison]

good job

[deft sleet]

Changes and Features in v1.3.0

• CrossOver support for macOS, you can browse and connect from macOS and launch it without open CrossOver window (TUI element render not correctly from CMD in Wine)

[vivid kindle]

That's what I was looking for!

[vivid kindle]

@deft sleet hope you are fine! I'm using this one, but actually it just starts the default SAMP Mode, nothing injected by omp, did you experience this issue as well?

SAMP loading screen etc.