01
Parse
Raw log text is tokenised. Proton version, Steam AppID, game name, DXVK / Mesa build strings, and error messages are extracted into structured evidence.
Linux Gaming Troubleshooter
Deterministic log analysis for Linux gaming.
Upload a Steam, Proton, Wine, DXVK, VKD3D, or Vulkan log. ProtonFix runs 71 pattern fingerprints first. GPT-4.1-mini is only called when no fingerprint matches — not by default.
Pipeline
01
Raw log text is tokenised. Proton version, Steam AppID, game name, DXVK / Mesa build strings, and error messages are extracted into structured evidence.
02
71 pattern definitions are evaluated against the extracted evidence. Each match is scored by severity, category priority, and co-occurrence weights.
03
ROOT_CAUSE_GRAPH links fingerprints to their upstream causes. Downstream symptoms are pruned. The highest-ranked root node becomes the primary finding.
04
When no fingerprint matches, GPT-4.1-mini is called with the structured parse context. Most logs never reach this step.
Steps 01–03 are fully deterministic — no network calls, no model inference. Step 04 is gated behind a check: if the fingerprint engine returns any result, the AI call is skipped entirely.
Coverage
ProtonFix parses and cross-references log output from these runtimes, compatibility layers, and GPU stacks.
Example
A representative output from the deterministic engine. This result required zero AI calls — the root cause was matched directly from the log.
File: steam_proton_620.log
Game: Portal 2
Proton: 8.0-5
Confidence: 91%
Severity:🔴 HIGH
Summary
Vulkan initialisation failed immediately after launch. DXVK could not create a Vulkan device, causing the renderer to crash. Root cause matched from the ICD error string — no AI fallback used.
Primary Cause
VULKAN_DRIVER_MISSING
🔴 HIGHNo Vulkan ICD loader was found at runtime. DXVK and VKD3D both require a working Vulkan driver to initialise. This failure blocks all DirectX translation layers.
Known fixes
sudo apt install mesa-vulkan-drivers vulkaninfo Restart Steam after driver installation
Privacy
Log submission is anonymous. PII is detected and removed automatically before anything is stored.
Log submission is anonymous. No sign-up, no session cookies, no tracking pixels.
Submission IP is converted to a 16-character SHA-256 truncation before being written to disk. The plain-text IP is never persisted.
17 redaction categories run before every save: Linux and Windows home paths, Steam IDs, usernames, UUIDs, MAC addresses, hostnames, and email addresses.
Submissions are stored in SQLite on the host running ProtonFix. Nothing is forwarded to third parties except the optional OpenAI fallback call.
Open Source
The fingerprint database, causal dependency graph, and confidence scoring engine are plain Python dicts — no black boxes, no vendor lock-in.
License
MIT
Use it, fork it, embed it. The entire diagnosis engine is auditable source — no compiled weights, no opaque models.
GitHub
View source →
Browse the fingerprint database, open an issue, or submit a pull request to add new patterns for games you've diagnosed.
Discord
Join the server →
Discuss Linux gaming failures, request new fingerprint patterns, and share diagnosis results with the community.