---

Tempest is a command-line tool that handles Wine/Proton configuration, authentication, URI scheme registration, and game launching for Vortex.

---

Install

curl -fsSL https://raw.githubusercontent.com/simplyIeaf/Tempest/master/install.sh | bash
tempest setup

setup installs Wine, creates a dedicated Wine prefix, downloads Vortex, and registers the vortex:// URI scheme. When the GE-Proton backend is enabled it skips the separate DXVK/vkd3d-proton install steps (both are bundled in GE-Proton).

---

GE-Proton backend

Tempest can launch Vortex through GE-Proton (bundled Wine + DXVK + vkd3d-proton) using umu-launcher instead of a bare system Wine. Install umu-launcher, then:

tempest proton        # download & install the latest GE-Proton
tempest proton status # report backend readiness

If umu-run or GE-Proton is missing, Tempest prints a warning and falls back to plain Wine at launch time.

---

Commands

tempest setup              First-run: install Wine, create prefix, download client
tempest login              Authenticate with Vortex (terminal, supports 2FA)
tempest list               List all available games
tempest play <id>          Launch a game by ID
tempest update             Update Vortex.exe to latest version
tempest doctor             Diagnose issues across the full stack
tempest proton             Install/upgrade the GE-Proton backend
tempest proton status      Show GE-Proton / umu status
tempest desktop [id]       Create a "Vortex" application-menu entry (with icon)
tempest plugin             List installed plugins
tempest plugin <name>      Install a plugin (e.g. fps-unlocker)
tempest plugin uninstall <name>   Remove a plugin
tempest uninstall          Remove everything Tempest installed

After setup, clicking Play on the Vortex website triggers tempest uri-handler automatically via the registered vortex:// scheme.

---

Configuration

~/.config/tempest/config.toml is created on first run. Notable options:

[wine]
binary = "wine"

[wine.env]
# Force the discrete GPU on Optimus laptops
VK_ICD_FILENAMES = "/usr/share/vulkan/icd.d/nvidia_icd.x86_64.json"
# Show an FPS overlay
DXVK_HUD = "fps"

[launcher]
filter_wine_noise = true   # suppress Wine fixme: and libEGL noise
use_esync = true            # reduce synchronisation overhead (all kernels)
use_fsync = true            # lower overhead (Linux 5.16+ / wine-staging)
use_gamemode = false        # set true after installing gamemode
shader_cache = true         # cache DXVK / vkd3d-proton / GL shaders across launches
fsr = 0                     # 0..5 fullscreen-FSR sharpness when running under GE-Proton (0 = off)
gpu_device = "auto"         # "auto" | "nvidia" | "intel" - pick the Vulkan/GL adapter
dxvk_hud = ""               # optional DXVK overlay, e.g. "fps,memory,version" ("" = off)
wayland_mode = "auto"       # "auto" | "on" | "off" - select the wine driver for the session
keep_panel = true           # keep the desktop panel/topbar visible instead of wine's fullscreen

[proton]
enabled = true              # launch via umu-run + GE-Proton (fallback: Wine)
umu = "umu-run"             # umu-run binary or absolute path
proton_path = "GE-Proton"   # managed install, or path to a GE-Proton dir
game_id = "umu-vortex"      # GAMEID handed to umu-launcher
store = "none"              # store the umu-launcher is launched for

gpu_device = "auto" prefers the discrete NVIDIA GPU when one is present (device filtering for DXVK plus NVIDIA PRIME / GL offloading env). Set it to "nvidia" to force it, or "intel" to pin the integrated GPU.

wayland_mode has Tempest detect the current session: under Wayland it enables the wine-wayland driver (PROTON_ENABLE_WAYLAND), otherwise it stays on X11/XWayland. keep_panel = true disables Wine's fullscreen hack so the desktop environment's own panel/topbar stays visible in fullscreen games.

Shader-cache collection (shader_cache = true) persists DXVK state caches and NVIDIA/Mesa GL shader caches under ~/.cache/vortex-shaders/, which removes most of the first-launch and fullscreen shader-compilation hitches.

Create a launcher entry in your application menu (name "Vortex", with its icon):

tempest desktop 2     # optional game id; defaults to game 1

---

Diagnostics

tempest doctor

Checks Wine, Vulkan, GPU, DXVK, vkd3d-proton, GameMode, the URI handler, network connectivity, and the GE-Proton/umu backend (when enabled), with per-distro fix hints for every failure.

TEMPEST_LOG=debug tempest play 4

---

Disclaimer

Tempest is an independent, community-developed tool and is not affiliated with, endorsed by, or in any way connected to the developers or operators of Vortex or playvortex.io. All trademarks and service marks are the property of their respective owners. Use of this tool is at your own risk.

---

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT License (LICENSE-MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.