OneLauncher

An enhanced launcher for both LOTRO and DDO with many features including an addons manager for plugins, skins, and music.

Features

• Multiple accounts support
• Password saving
• Plugins, skins, and music manager
• External scripting support for addons
• Auto WINE setup for Linux and macOS
• Multiple clients support
• more

Installation

The easiest way to get OneLauncher is with a compiled release. It can also be run with Python or Nix.

• Latest Release
• macOS Instructions
• System Requirements
• Running From Source Code

macOS

• Download the latest release:
  • arm64 (Apple Silicon)
  • x86_64 (Intel)
• Double click the OneLauncher-macOS-*.zip file to extract it.
• Drag the extracted OneLauncher to your Applications folder if you'd like.
• You can double click OneLauncher to open it.
• If you see a message like "OneLauncher can't be opened because it is from an unidentified developer", you'll have to go to the Privacy and Security section of your System Settings where there will be an option to allow opening OneLauncher.

Have fun adventuring! Note that there may be some stuttering the first time you play. This is expected and will go away quickly.

System Requirements

Windows

Windows 10 (1809 or later) or Windows 11 is required. These are what Qt6 supports.

Linux

Most people should just need to install WINE. Review the rest of these requirements if you have trouble after that.

• WINE dependencies. See these commands.
• OS version supported by Qt
• Either libxcb-cursor0 or xcb-cursor0 if using X11.
• libz
• A Secret Service backend such as Gnome Keyring or KWallet

Command Line Usage

All settings can be overridden from the command line. This is especially useful for making custom shortcuts. For example, loading the LOTRO preview client in French could be done with --game lotro-preview --locale fr.

Usage: onelauncher COMMAND [OPTIONS]

Environment variables can also be used. For example, --config-directory can be  
set with ONELAUNCHER_CONFIG_DIRECTORY.

╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ --help (-h)           Display this message and exit.                         │
│ --install-completion  Install shell completion for this application.         │
│ --version             Display application version.                           │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Parameters ─────────────────────────────────────────────────────────────────╮
│ --game              Which game to load. Can be either a game type or game    │
│                     config ID. [choices: lotro, lotro-preview, ddo,          │
│                     ddo-preview]                                             │
│ --config-directory  Where OneLauncher settings are stored [default:          │
│                     /home/june/.config/onelauncher]                          │
│ --games-directory   Where OneLauncher game specific data is stored [default: │
│                     /home/june/.local/share/onelauncher/games]               │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Program Options ────────────────────────────────────────────────────────────╮
│ --default-locale              Default language for games and UI              │
│ --always-use-default-locale-  Use default language for UI regardless of game │
│   for-ui --no-always-use-def  language                                       │
│   ault-locale-for-ui                                                         │
│ --games-sorting-mode          Order to show games in UI [choices: priority,  │
│                               last-played, alphabetical]                     │
│ --on-game-start               What OneLauncher should do when a game is      │
│                               started [choices: stay, close]                 │
│ --log-verbosity               Minimum log severity that will be shown in the │
│                               console and log file [choices: debug, info,    │
│                               warning, error, critical]                      │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Game Options ───────────────────────────────────────────────────────────────╮
│ --game-directory              The game's install directory                   │
│ --locale                      Language used for game                         │
│ --client-type                 Which version of the game client to use        │
│                               [choices: win64, win32, win32-legacy,          │
│                               win32-legacy]                                  │
│ --high-res-enabled            If the high resolution game files should be    │
│   --no-high-res-enabled       used                                           │
│ --standard-game-launcher-fil  Name of the standard game launcher executable. │
│   ename                       Ex. LotroLauncher.exe                          │
│ --patch-client-filename       Name of the dll used for game patching. Ex.    │
│                               patchclient.dll                                │
│ --game-settings-directory     Custom game settings directory. This is where  │
│                               user preferences, screenshots, and addons are  │
│                               stored.                                        │
│ --newsfeed                    URL of the feed (RSS, ATOM, etc) to show in    │
│                               the launcher                                   │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Game Account Options ───────────────────────────────────────────────────────╮
│ --username              Login username                                       │
│ --display-name          Name shown instead of account name                   │
│ --last-used-world-name  World last logged into. Will be the default at next  │
│                         login                                                │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Game Addons Options ────────────────────────────────────────────────────────╮
│ --startup-scripts          Python scripts run before game launch. Paths are  │
│   --empty-startup-scripts  relative to the game's documents config directory │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Game WINE Options ──────────────────────────────────────────────────────────╮
│ --builtin-prefix-enabled      If WINE should be automatically managed        │
│   --no-builtin-prefix-enable                                                 │
│   d                                                                          │
│ --user-wine-executable-path   Path to the WINE executable to use when WINE   │
│                               isn't automatically managed                    │
│ --user-prefix-path            Path to the WINE prefix to use when WINE isn't │
│                               automatically managed                          │
│ --wine-debug-level            Value for the WINEDEBUG environment variable   │
╰──────────────────────────────────────────────────────────────────────────────╯

Contributing

See CONTRIBUTING.md

Information For Addon Developers

Getting Your Addon in OneLauncher

I follow the RSS feed on LotroInterface and will add any addons that look to be in the correct format. Compendium files are not required. You can open an issue or email me if your addon still needs to be added.

Archive Format

• Addons must be uploaded as a zip!
• Archive should have a descriptive name (i.e. not "skin" or "plugin")
• It's okay but not recommended if the archive has no root folder, multiple root folders, or includes part of the path to the data folder like "ui/skins" or "Plugins".

Compendium Files

Compendium files should be placed inside the top-level directory of your addon, and their names follow the format:

{NAME}.{plugin/skin/music}compendium An example is Example Plugin.plugincompendium

The contents of compendium files follow the format:

<{Plugin/Skin/Music}Config>
    <Id>{LOTRO INTERFACE ID}</Id>
    <Name>{NAME}</Name>
    <Description>{DESCRIPTION}</Description>
    <Version>{VERSION}</Version>
    <Author>{AUTHOR}</Author>
    <InfoUrl>http://www.lotrointerface.com/downloads/info{LOTRO INTERFACE ID}</InfoUrl>
    <DownloadUrl>http://www.lotrointerface.com/downloads/download{LOTRO INTERFACE ID}</DownloadUrl>
    <!--Descriptors only needed for plugins-->
    <Descriptors>
        <descriptor>{AUTHOR}\{NAME}.plugin</descriptor>
        <!--More descriptors can b