Skip to content

LINUX.md

Latest commit

 

History

History
64 lines (49 loc) · 2.77 KB

LINUX.md

File metadata and controls

64 lines (49 loc) · 2.77 KB

Running on Linux (ARC Raiders via Proton)

ARCTracker Sync was written Windows-only; this is a native Linux port of the platform layer (packet capture, process inspection, launcher control, token storage). The TLS-decryption core (vendor/pcapsql-core) is unchanged.

Build & run

./scripts/run-linux.sh

That builds target/release/arctracker-sync, grants it CAP_NET_RAW with a one-time sudo setcap cap_net_raw+ep, and launches the GUI unprivileged. You can also run it as root instead of using setcap.

How sync works here

  1. The app owns a TLS keylog file (SSLKEYLOGFILE) under its data dir.
  2. When you launch the game through the app (Steam button), it starts steam with SSLKEYLOGFILE in the environment. Steam passes that env to the Proton game, whose HTTPS stack writes session keys to the file.
  3. The app captures port-443 traffic on your interface with an AF_PACKET socket, decrypts the game↔Embark gateway TLS using those keys, extracts your sync key, and posts it to ARCTracker.

Important: the game only inherits SSLKEYLOGFILE if Steam is (re)started by the app after the env is set. If Steam was already running, use the app's prepare/restart so it relaunches Steam with the keylog env. If you launch the game manually, set SSLKEYLOGFILE yourself as a Steam launch option, e.g.:

SSLKEYLOGFILE=$HOME/.local/share/Sync/sync-key.log %command%

Verifying capture works

cargo build --release --example capture_smoke
sudo ./target/release/examples/capture_smoke        # or after setcap, no sudo

It lists interfaces, opens the first one, and reports captured frames and TCP/443 segments over 5 seconds. Non-zero TCP/443 while browsing = capture works.

What was ported

File Linux implementation
rawsock.rs AF_PACKET/SOCK_RAW capture, full Ethernet frames (DLT_EN10MB), poll-based non-busy read
elevation.rs is_elevated = root or a probe AF_PACKET open (CAP_NET_RAW); relaunch_elevated via pkexec
process_env.rs process discovery + env via /proc/<pid>/{comm,exe,stat,environ}
launch.rs steam on PATH (or Flatpak), steam -shutdown, SIGKILL force-close
config.rs Steam path from ~/.steam/steam, ~/.local/share/Steam, Flatpak
credential_store.rs session token in a 0600 file in the data dir

Caveats / unverified

  • Whether ARC Raiders under Proton honors SSLKEYLOGFILE for the connection ARCTracker reads has not been verified end-to-end on this machine — it's the same assumption the Windows build relies on. If keys aren't written, no decryption is possible regardless of capture.
  • Epic Games Launcher is not supported on Linux; use Steam.
  • The tray icon and single-instance lock are no-ops on Linux (GUI still runs).