Files

T

funman300 6fe558ad00 Rename project: battlenet-manager → umutray

Binary, crate, clap app name, ksni tray id, HTTP user-agent, systemd unit,
XDG config dir (co.aleshym/umutray), README, and all log prefixes.

Config path changes from ~/.config/battlenet-manager/ to ~/.config/umutray/.
Existing users should `mv` the old directory if they've customised it;
otherwise defaults get rewritten on next run.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-04-16 17:28:13 -07:00

2.9 KiB

Raw Blame History

umutray

A small system-tray daemon and CLI for running the Battle.net launcher on Linux via umu-launcher and GE-Proton.

Features

Tray icon with Launch / Kill / Update-Proton menu (KDE, GNOME+AppIndicator, Xfce, any SNI-capable desktop).
Background poller that reflects Battle.net's running state in the tray.
update-proton subcommand that downloads GE-Proton releases directly from GitHub and installs them under the Steam compat tools directory.
diagnose subcommand that sanity-checks the environment (umu-run, prefix, Proton install, Vulkan, display server, stale agent.lock).

Install

cargo build --release
install -Dm755 target/release/umutray ~/.local/bin/umutray

Requires umu-launcher and tar on PATH. On Arch:

sudo pacman -S umu-launcher vulkan-tools

The Battle.net Launcher.exe itself is not bundled — run your existing battlenet-umu-setup.sh (or install it manually into the prefix) before first launch.

Usage

Command	What it does
`umutray`	Start the tray daemon (default)
`umutray launch`	Launch Battle.net and return (for `.desktop` shortcuts)
`umutray kill`	SIGTERM → wait 3 s → SIGKILL on all Battle.net procs
`umutray diagnose`	Run environment health checks
`umutray update-proton`	Interactive GE-Proton picker
`update-proton --latest`	Install newest GE-Proton release
`update-proton --version X`	Install a specific tag (e.g. `GE-Proton10-34`)
`update-proton --list`	Show recent releases without installing
`config show` / `config path`	Print current config or its path
`config edit`	Open config in `$EDITOR`
`config set --prefix PATH`	Change the Wine prefix (also `--compat-dir`, `--gameid`)
`service install`	Write + enable a `systemd --user` unit for autostart
`service uninstall` / `status`	Remove the unit / show its status

Config

Lives at ~/.config/umutray/config.toml, written with defaults on first run:

prefix_dir = "~/Games/battlenet-umu"
proton_version = "GE-Proton"        # or a pinned tag like "GE-Proton10-34"
gameid = "umu-battlenet"
proton_compat_dir = "~/.local/share/Steam/compatibilitytools.d"

proton_version = "GE-Proton" tells umu-launcher to auto-fetch the latest on each run. Setting it to a specific tag (done automatically by update-proton) pins that version.