poli0981andClaude Opus 5 99df399b19 ci(web): knip exits 1 on an unlisted binary, not on the export backlog
The Web CI "Unused code report" step failed on the merge. The export and type
backlog was not the cause - knip.json already marks both "warn" - it was this:

    Unlisted binaries (1)
    python  package.json

knip reads package.json's scripts and treats a binary it cannot resolve to a
package as an ERROR, which exits 1 regardless of the warn-level rules. The
`fonts` script (`python scripts/gen-fontface.py`) arrived with the SvelteKit
rewrite, so the failure arrived with it too.

python is a system tool here, not a dependency, so it is declared as ignored
rather than installed.

How this reached main: I had been running `npm run knip | grep ...` locally,
which reports the pipeline's exit status and not knip's, so a red run looked
green every time. Checked with `npm run knip > file; echo $?` now, and that is
what the verification should have been all along.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 15:09:07 +07:00
2026-09-12 02:47:40 +00:00
2026-09-11 08:15:34 +00:00
2025-12-19 18:30:23 +07:00

Games Count Last Updated Top Online Version Web App Desktop Android Health Check Visitors Sponsor

A curated list of free-to-play games on Steam — now ~3,400 of them — no quality guarantees, no endorsements, just pure listings by a broke, unemployed Vietnamese dev with too much free time and a Steam library full of sale games (80% under $10).

v3.0.0 is the version that grew limbs. It is no longer a list. It is also:

  • a React web app at https://free-steam-games.win/ with a virtualised 3.4k-row table, 12 charts, fuzzy search, faceted filters, CSV/JSON export, validation badges, command palette, PWA / offline cache, en/vi i18n, and per-game permalinks. It is read-only: sign-in and in-browser editing were removed in September 2026;
  • a desktop app (Tauri 2, fixed-size 1400 × 900 window — see Releases for Win/Mac/Linux installers);
  • the same Python pipeline that has run daily under GitHub Actions since v1.

Powered ~70 % by AI (Grok for v1, Claude for v2 + the entire web/desktop layer) — code is reviewed and tested, but mistakes happen. See the Disclaimer for the specific accuracy caveats (genre best-effort, English-only assumptions, test-data leakage, unsigned-commit dev artefacts).

Wallet safe (for now). Play at your own risk.

Surface URL
🌐 Web app https://free-steam-games.win/
🖥️ Desktop releases GitHub Releases (Win .msi, Mac .dmg, Linux .AppImage)
📱 Android APK GitHub Releases (sideload .apk, Android 11+ — see docs/android-support.md)
🏆 Top online (md) games/top-online.md
🎯 Top offline (md) games/top-offline.md
📦 Raw data data/data_001.jsonl … data_005.jsonl (5 sharded JSONL files)
🛠️ About https://free-steam-games.win/#/about (in-app)
👤 Authors AUTHORS.md — maintainer + contact channels + AI-assistant disclosure

What's new in v3.0.0

Web app at free-steam-games.win/

A React/Vite SPA hosted on GitHub Pages, fetching data live from raw.githubusercontent.com. Features:

  • Browse — virtualised 3.4k-row table (TanStack Virtual), faceted filters (genre, type, platform, status), Fuse.js fuzzy search, sortable columns including correctly-parsed release-date sorting, 50/100/200/500/all pagination, hidden scrollbar.
  • Charts — 12 charts via Apache ECharts: KPI overview, top-online bar, genre treemap, platform donut, language heatmap, tag word cloud, anti-cheat stacked, release-year histogram, catalog-growth cumulative line, review histogram, online player tiers pie, DRM/DLC bars.
  • Edit / add / delete (owner-only) — single edit drawer with form / JSON-editor toggle, bulk edit + delete in one signed commit, Steam-link queue (single + JSON bulk) into scripts/temp_info.jsonl, diff viewer, conflict-retry, optimistic local cache update so edits show up instantly without waiting for the Fastly CDN.
  • GPG signing — paste your OpenPGP private key, unlock per-session, every edit commit gets a detached binary signature → GitHub verifies them as ✓. Multi-UID picker, idle auto-lock 5/15/30/60 min.
  • PWA — installable, offline browse via a Workbox NetworkFirst service worker.
  • i18n vi / en — Vietnamese + English UI, auto-detected from navigator.language, switchable in Settings.
  • Per-game permalinks /games/:appid — share-friendly deep links into the detail drawer.
  • Activity feed — recent commits with verified badges, filter Me / Bots / All.
  • Health page — validation badges + workflow_dispatch buttons for the six maintenance pipelines.
  • ⌘K command palette — pages / charts / GPG lock-unlock / fuzzy game search.
  • Owner-gate — non-owner visitors see read-only browse + charts, no edit affordances.

Site is rebuilt and re-deployed automatically on every commit to data/** or web/**. See web/README.md for stack details and the per-phase changelog.

Desktop app (Tauri 2)

A native shell around the same web app, distributed via GitHub Releases:

  • Windows .msi, macOS .dmg (universal Apple Silicon + Intel), Linux .AppImage and .deb.
  • Fixed 1400 × 900 window, no maximise, no resize — keeps the layout consistent.
  • Dark theme, stays in standalone mode.
  • Same data path as the web app (reads raw.githubusercontent.com live), same offline cache.

Built by .github/workflows/release-desktop.yml (matrix Win/Mac/Linux via tauri-apps/tauri-action), triggered by pushing a desktop-v* tag or a manual workflow run. Each release auto-attaches its installers as draft assets.

# from web/, locally:
npm run tauri:dev      # dev build with hot reload
npm run tauri:build    # release binary into web/src-tauri/target/release/bundle
v2.x foundations still here

The Python pipeline that powered v2 is untouched and runs daily as before:

  • Schema v2.2 (23 + manual fields per record), CC BY 4.0 (see LICENSE-DATA), sharded data in data/data_*.jsonl (cap 800 records/shard, current total 3,424) plus a data/index.json manifest.
  • Extension-compatible: the Chrome extension pushes pre-fetched rich data straight into scripts/temp_info.jsonl; the ingest workflow merges and dedupes.
  • HTML scraper for accurate language tables, DLC pricing, and user tags — single GET per game.
  • Health-checked: dead-link sweep every 5 days, full purge every Monday.
  • Reviews-only refresh every 2 days; full refresh daily.
Architecture
.
├── data/                       # Sharded data (the source of truth)
│   ├── data_001.jsonl          # ≤ 800 records
│   ├── data_002.jsonl … 005    # the rest
│   └── index.json              # last_updated, totals, shard manifest
│
├── games/                      # The two generated leaderboards
│   ├── top-online.md           # live leaderboard
│   └── top-offline.md          # most-played offline-capable
│
├── scripts/                    # Python data pipeline
│   ├── core/
│   │   ├── constants.py        # rate limits, anti-cheat patterns, schema
│   │   ├── steam_client.py     # rate-limited HTTP client
│   │   ├── data_store.py       # JSONL I/O, dedup, schema merge
│   │   ├── fetcher.py          # batch processor
│   │   ├── scraper.py          # HTML page parser
│   │   └── health_checker.py   # status detection
│   ├── ingest_new.py / update_data.py / discover_new.py / …
│   └── temp_info.jsonl         # ingest queue
│
├── web/                        # React/Vite/Tauri front-end
│   ├── src/                    # React app: pages, components, charts, i18n
│   ├── src-tauri/              # Tauri 2 desktop wrapper (Rust)
│   ├── public/                 # PWA icons + manifest
│   └── dist/                   # build artefacts (PWA + desktop)
│
├── docs/                       # Legal + acknowledgements + contact
├── .github/workflows/          # 23 workflows: data pipeline + CI + desktop/Android release
├── LICENSE                     # MIT — code
└── LICENSE-DATA                # CC BY 4.0 — dataset
Architecture
scripts/
├── core/
│   ├── constants.py        # Config, rate limits, anti-cheat patterns
│   ├── steam_client.py     # HTTP client, backoff, retry, session pooling
│   ├── data_store.py       # JSONL I/O, validation, dedup, schema merge
│   ├── fetcher.py          # Batch processor, apply_details/reviews/players/scraped
│   ├── scraper.py          # Store page HTML parser (languages, DLC, tags)
│   └── health_checker.py   # Game status detection with cached API data
├── ingest_new.py           # Add new games (health check + extension merge)
├── update_data.py          # Daily full refresh
├── update_reviews.py       # Reviews-only (every 2 days)
├── check_dead_links.py     # HEAD-request 404/410 scanner
├── purge_unhealthy.py      # Remove delisted/not-free/invalid
├── top_online.py           # Live leaderboard with trends
├── refetch_all.py          # Force re-fetch ALL (manual only)
└── delete_game.py          # Interactive delete

Automated workflows

Workflow Trigger What it does
Auto Update JSON Daily 00:00 UTC Full data refresh (API + HTML scrape)
Generate Tables After JSON update Regenerate all markdown tables
Top Online Sun/Wed/Fri 03:00 UTC Live player leaderboard
Update Reviews Every 2 days 06:00 UTC Reviews-only refresh
Check Dead Links Every 5 days 04:00 UTC HEAD-request 404/410 scanner
Purge Unhealthy Weekly Mon 05:00 UTC Full health scan + removal
Ingest New On scripts/temp_info.jsonl push Add new games (web app + extension queue here)
Force Re-fetch Manual only Re-fetch ALL games
Mark Dead Games Mon + Thu 04:30 UTC Online + >1y + 0 players ≥14d → is_dead=true + 💀 note
Deploy Web On web/** or data/** change Build + deploy SPA to GitHub Pages
Release Desktop On desktop-v* tag Matrix-build Tauri installers (Win/Mac/Linux) → Releases
Top Offline 1st + 15th of month 05:00 UTC Bi-weekly leaderboard for single-player F2P concurrents
Announce Discussion On release published Auto-create a GitHub Discussion in Announcements per release

Contribute

The browser extension. The companion Chrome extension detects free-to-play games on Steam store pages and pushes pre-fetched metadata straight to scripts/temp_info.jsonl; Ingest New Game Links merges and dedupes on push. This is the only submission route.

Most new games arrive on their own: Discover New Games sweeps the Steam store daily into a review queue, and the maintainer approves them at /admin. Discovery only proposes — publication is always a human decision.

Issues are for reports, not submissions: Bug report, Feature request, Delete game and Feedback. All reviewed by hand.

The manual way. Fork, append to scripts/temp_info.jsonl, and push:

{"link": "730", "type_game": "online", "safe": "y", "notes": "CS2 babyyy"}
{"link": "https://store.steampowered.com/app/570/", "genre": "MOBA"}

Accepts a full URL, short URL, or bare appid. Optional manual fields: type_game, genre, anti_cheat, anti_cheat_note, is_kernel_ac, safe, notes. The ingest pipeline preserves these on top of whatever it fetches from Steam.

See CONTRIBUTING.md for the full flow.

Why this exists

Unemployed, introvert max level, dropped out uni year 3, mooching off family. Needed a clean F2P list without digging Steam every time "hôm nay chơi free cái gì đây". So this repo was born — hobby project of a "barely competent" dev pumped by AI.

  • v1 was spaghetti.
  • v2.0 was organised spaghetti.
  • v2.1 was spaghetti with proper seasoning. It got a scraper.
  • v3.0 is spaghetti with a website on top, a desktop app, and bilingual menus. Still spaghetti underneath. Still a hobby.

Warning

Disclaimer. Quality / fun / safety: who knows. The maintainer only vouches for games personally played (safe column: y = yes, ? = dunno, n = nope). Problems with a game are between you, Valve, and the developer of that game — not the maintainer. See docs/DISCLAIMER.md for the specific accuracy caveats.

Docs

  • AUTHORS — maintainer + canonical handle map + AI-assistant disclosure.
  • CHANGELOG — what changed in each version.
  • CONTRIBUTING — issue templates, the browser extension, manual fork.
  • PC spec (VI) — maintainer's dev hardware + test devices.
  • Dev environment (VI) — IDE, toolchains (Python 3.12 / Node 24 / Rust stable / Tauri 2), workflow.
  • Tauri build — desktop build prerequisites + signing + auto-update.
  • DISCLAIMER — accuracy caveats, no-warranty, the broke-maintainer note.
  • Terms of Use — usage agreement, contributions, governing law.
  • EULA — plain-language commentary on both licences.
  • Privacy Policy — no accounts, no analytics, no tracking; what Cloudflare logs as the host, and the one page that still talks to GitHub.
  • Deployment — how a push becomes a deploy, and how to verify or roll one back.
  • Admin setup — Cloudflare Access and the GitHub App behind /admin.
  • Acknowledgements — credits, AI assistants, third-party libraries.
  • Third-party dev tooling — dead-code / lint / audit tools + the pre-publish check suite.
  • Contact — where to find the maintainer.
  • CODE OF CONDUCT — be chill.
  • SECURITY — vulnerability reporting.
  • web/README.md — stack details, per-phase changelog, build instructions.

Code is MIT; the dataset is CC BY 4.0 with carve-outs for fields the project does not own (description, header_image). Keep the right licence with you if you fork. Star if you find a hidden gem ✨

Last auto-update: daily via GitHub Actions. Manual runs from the Actions tab or the web app's Health page.

S
Description
No description provided
Readme MIT
147 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 51%
Python 23.1%
Svelte 23%
CSS 1%
JavaScript 0.7%
Other 1.2%