Protonux

Proton + Linux · a silly combo that just works

A polished Go TUI that scans your Steam library and shows Linux readiness at a glance — ProtonDB tiers, anti-cheat status, playtime, and links. Same data sources power users already trust.

Not affiliated with Valve, Steam, ProtonDB, or Are We Anti-Cheat Yet.
Community tool that talks to public APIs.

---

What it does

Library	Loads your owned games via the official Steam Web API (GetOwnedGames)
ProtonDB	Live tiers — Native · Platinum · Gold · Silver · Bronze · Borked
Anti-cheat	Are We Anti-Cheat Yet status for multiplayer titles
FAQ panel	Built-in legend so every pill actually means something

Two-column layout: scrollable library on the left, compatibility + FAQ on the right.

---

Screenshots

 

_{Main menu · Steam ID + API key   |   Library · games with Proton + AC pills}

 

_{Compatibility · selected game detail   |   FAQ · what Gold / Supported / Denied mean}

---

Features

• Full-screen TUI — Catppuccin-ish gray canvas, rounded panels, accent chips
• Color pills — Proton tiers + anti-cheat status at a glance
• Live ProtonDB scan — rate-limited (4 concurrent), progress in the footer
• Filter — / to search your library by name or AppID
• Safe HTTP — timeouts, size caps, custom User-Agent
• Local config — API key saved under your user config dir (not committed)

---

Platform support

OS	amd64	arm64
Windows	✅	✅
Linux	✅	✅

Pure Go + Charm (bubbletea / lipgloss). CGO_ENABLED=0 — static-friendly binaries, no GTK/Qt.

macOS is not packaged in releases yet; go build still works if you want it.

---

Quick start

Download a release

Grab the latest build for your OS from
Releases.

# Linux example
tar -xzf protonux-v1.0.0-linux-amd64.tar.gz
./protonux-v1.0.0-linux-amd64

# Windows example
Expand-Archive protonux-v1.0.0-windows-amd64.zip
.\protonux-v1.0.0-windows-amd64.exe

From source (Go 1.23+)

git clone https://github.com/Foxemsx/protonux
cd protonux
go run .
# or
go build -o protonux .

---

Setup (Steam Web API key)

Valve blocks unauthenticated library scraping. Protonux uses the same official API SteamDB’s calculator relies on.

1. Open steamcommunity.com/dev/apikey
2. Domain can be localhost
3. Paste the key into Protonux (Tab to switch fields) — it is stored locally

Optional env override:

$env:STEAM_API_KEY = "your_key"

export STEAM_API_KEY=your_key

Game details should be Public if you look up someone else’s profile.

---

Controls

Key	Action
Tab	Switch input fields / panels
Enter	Scan library
/	Filter games
↑ ↓	Move selection
R	Reload
Esc	Back
Q / Ctrl+C	Quit

---

FAQ (in-app)

Pill	Meaning
Native	Native Linux build
Platinum	Perfect on Proton, no tweaks
Gold	Works after minor tweaks
Silver	Playable, some issues
Bronze	Runs, not great
Borked	Won't run / unusable
Supported	Anti-cheat allows Linux
Running	Works unofficially
Planned	Support promised
Broken	AC blocks or broken
Denied	Devs said no
—	Not listed (often no kernel AC)

---

Build releases locally

make release VERSION=v1.0.0
# → dist/protonux-v1.0.0-{windows,linux}-{amd64,arm64}.{zip,tar.gz}
# → dist/SHA256SUMS

Pushing a tag v* runs GitHub Actions and publishes a GitHub Release automatically.

git tag -a v1.0.0 -m "Release v1.0.0"
git push origin v1.0.0

---

Assets for maintainers

Drop media into assets/ (see assets/README.md for shot list):

File	Content
showcase.gif	Full flow demo (menu → scan → browse)
mainmenu.png	Startup screen with logo + form
library.png	Library list with pills
compat.png	Compatibility detail for one game
faq.png	FAQ half-panel visible

---

Data sources

• Steam Web API — GetOwnedGames, vanity resolve
• ProtonDB — report summaries
• Are We Anti-Cheat Yet — games.json

---

License

MIT — free to use, modify, and redistribute with the license notice.