Run Traktor Pro 4 on Proton
Find a file
Beck 979e002513 launch-traktor.sh: self-heal orphaned umu/proton chains
When TP4 exits but its umu-run/pressure-vessel/steam.exe chain fails to
reap, the next launch stalls on the prefix lock and — if two launches
pile up — spawns racing TP4 instances that crash each other (reproduced
live: session closed at 16:13, chain orphaned, two relaunch attempts at
17:57/18:00 stalled, then raced on cleanup and both died).

Guard: if no Traktor window is live, sweep stray umu-run/proton/
wine-side steam.exe/TP4/xalia/NTKDaemon processes ([-]-escaped patterns
so they can't self-match), then clear pfx.lock. Live sessions are left
untouched (verified: skipped with TP4 running).
2026-11-08 18:08:15 +00:00
bin launch-traktor.sh: self-heal orphaned umu/proton chains 2026-11-08 18:08:15 +00:00
desktop Traktor Pro 4 + Beatport LINK on Linux: full setup 2026-11-08 16:21:01 +00:00
docs Script the Native Access 2 install (fresh-install path) 2026-11-08 16:40:47 +00:00
icons Traktor Pro 4 + Beatport LINK on Linux: full setup 2026-11-08 16:21:01 +00:00
.gitignore Traktor Pro 4 + Beatport LINK on Linux: full setup 2026-11-08 16:21:01 +00:00
bootstrap.sh Traktor Pro 4 + Beatport LINK on Linux: full setup 2026-11-08 16:21:01 +00:00
migrate.sh Traktor Pro 4 + Beatport LINK on Linux: full setup 2026-11-08 16:21:01 +00:00
README.md Script the Native Access 2 install (fresh-install path) 2026-11-08 16:40:47 +00:00

Traktor Pro 4 on Linux (Bazzite/Fedora)

Native Instruments Traktor Pro 4 + Beatport LINK streaming, running via Valve Proton. This repo automates everything a fresh machine needs.

TL;DR — new machine

# 1. prerequisites: Steam with "Proton 10" installed, umu-launcher, docker
# 2. copy the working prefixes from your desktop
./migrate.sh desktop-hostname

# 3. wire everything up (scripts, .desktop entries, ffmpeg closure)
./bootstrap.sh

# 4. launch "Traktor Pro 4" from your app launcher; Beatport session
#    restores automatically (tokens persist in the prefix)

What's in here

Path Purpose
bootstrap.sh idempotent installer: launchers, desktop entries, xdg handler, ffmpeg closure, registry purge
migrate.sh rsync the working prefixes from another machine (recommended path)
bin/install-native-access.sh fresh NA2 install: bottle, manual 7z payload extraction, Tahoma, UAC/UISettings surgery, daemon autostart
bin/patch-na2-embedded-login.sh NA2 asar + Electron-fuses patch so login uses the embedded window
bin/move-prefix-to-proton.sh bottle → ~/TraktorCompat Proton prefix wiring
bin/launch-traktor.sh TP4 via Proton 10 + umu-run, PROTON_NO_NTSYNC=1
bin/traktor-protocol-handler.sh traktor:// OAuth deep-link → running instance
bin/launch-native-access.sh NA2 in its Bottles bottle (only needed for installs/updates)
bin/fetch-ffmpeg-closure.sh fetches ffmpeg 4.4 closure Proton's gst AAC decoder needs
docs/ARCHITECTURE.md the full war story: every bug + fix
docs/fresh-install.md replay from scratch (no migration)

Pushing to Codeberg

git remote add origin git@codeberg.org:<you>/traktor-linux.git
git push -u origin main

The three magic fixes (if you read nothing else)

  1. PROTON_NO_NTSYNC=1 — wine's ntsync driver deadlocks Traktor's Qt single-instance IPC. Without this, login deep-links and opening tracks from a second instance hang forever.
  2. Proton 10.0, not 11.x — Proton 11/Experimental require the steamrt4 container, which ships no ffmpeg, so the bundled libgstlibav.so (the gstreamer AAC decoder) can never load → "File cannot be played" on every MP4/AAC. Proton 10 pairs with the sniper runtime; fetch-ffmpeg-closure.sh supplies the matching ffmpeg 4.4 sonames Valve forgot to bundle.
  3. Purge ~/TraktorCompat/gstreamer-1.0/registry.x86_64.bin after any ffmpeg-closure change — gstreamer caches "plugin failed to load" and will happily serve a decoder-less registry forever.