Licenses - Code stays MIT (LICENSE: 2025-2026 poli0981 (SkullMute)). The catalog data (data_game/LICENSE.md) and the documentation are CC BY 4.0 (full legal code in LICENSES/CC-BY-4.0.txt); creators' descriptions, cover images, names and trademarks are excluded. NOTICE.md: license map and non-affiliation with itch.io. Policies (English + Vietnamese mirrors, dated 2026-09-18, applying from 4.0.0) - Terms of Use now cover the website and the public data, with the content-removal / copyright process, prohibited uses (bulk scraping, /img abuse, /admin and ingest access, Suggest spam), 18+ opt-in and Vietnamese law with the consumer-rights reservation. - Privacy Policy rewritten for Cloudflare as processor: exact browser storage, cookies, Turnstile, D1 retention (Suggest notes 180 days, idempotency 7 days), rights under Law No. 91/2025/QH15 and the GDPR. - EULA covers only the desktop and Android apps (also the installer RTF). - Disclaimer, Security Policy (private reporting, scope, safe harbor) and Code of Conduct (Contributor Covenant 2.1) rewritten; PAT, GPG and Telegram-bot material removed. Docs and templates - README / CONTRIBUTING (EN + VI), webapp/README, TAURI.md, dev_env (EN + VI), THIRD_PARTY, ACKNOWLEDGEMENTS; new docs/operations.md (Cloudflare + GitHub setup, v4 release order, routine tasks). - CLAUDE.md rewritten for the v4 architecture; CHANGELOG [4.0.0]. - Issue templates: config.yml (Suggest page + private security reports), "Add games" points to /suggest, "Remove a game" gained a rights-holder section; PR templates updated; CODEOWNERS. - Dependabot npm version updates resume with the v4 merge (limit 5). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
57 KiB
Changelog
All notable changes to this project will be documented here.
[4.0.0] - Unreleased (freeitchgames.win on Cloudflare: read-only site, review queue, new pipeline)
Version 4 moves the website to https://freeitchgames.win on Cloudflare, makes it read-only for everyone (no sign-in), adds a maintainer-only admin with a review queue for new games, replaces the failing data crawls with a rotating refresh, and splits the licenses (code MIT, data and docs CC BY 4.0).
Upgrade notes
- The web app no longer signs in or edits. The GitHub-token (PAT) sign-in, in-app editing, the Add / Workflows pages and GPG commit signing are gone; on first load the app deletes the encrypted token and key it stored before. Suggest games at https://freeitchgames.win/suggest.
- Old links keep working:
…github.io/free-games-itchio-list/#/xredirects to the new site, and#/xlinks become/x. - Desktop and Android apps are read-only viewers too; they read the catalog from freeitchgames.win. Install 4.0.0 over 3.x as usual.
- New legal terms (ToS, Privacy Policy, EULA for the apps only, Disclaimer): the site asks you to accept them again once.
Website & Worker
- The site is served by a Cloudflare Worker with static assets (
webapp/wrangler.jsonc,webapp/worker/) and the catalog JSON is bundled into every build (/data/*, plus a sitemap), so each data commit republishes the site; the desktop/Android apps read the same files. Real URL paths instead of#/routes, per-page canonical URLs, and real 404s for unknown pages and missing files (a stale script after a deploy can no longer be cached as HTML). - Cover images are resized once to small WebP copies (Cloudflare Image Transformations + R2)
and served from
/img/…— about 4 KB instead of up to 3 MB per cover. Only catalog covers are served. - 18+ games are hidden by default; a visitor can show them in Settings after confirming they
are 18 or older (stored only in their browser). The removed-games page is now
/removed(/deletedredirects there). Aggregate, cookieless Cloudflare Web Analytics. - Enforced Content-Security-Policy and security headers; faster first load (~195 KB gzip, charts load only when opened); browser floor Safari/iOS 15.4.
- React Router 8, React 19.3, Vite 8 (rolldown), vitest; unused sign-in dependencies (Octokit,
OpenPGP.js) removed; Tauri drops its HTTP plugin and
Cargo.lockis committed.
Adding games: review queue
- Suggest page (
/suggest): anyone can send an itch.io link (+ optional note); protected by Cloudflare Turnstile and a rate limit. - Browser extension API (
POST /api/ingest, Cloudflare Access service token, idempotent) — the extension no longer needs a GitHub token. - RSS discovery: every 4 hours the Worker reads one itch.io "new & popular free" feed.
- Everything lands in a review queue (Cloudflare D1). The maintainer approves or rejects it in
the new admin (
/admin, Cloudflare Access), which also edits the three maintainer fields, removes games with a public reason (deleting their resized covers) and restores removed games. Approved games are committed by a GitHub App (verified commits) and scraped by the pipeline.
Licenses & legal
- Code stays MIT (
LICENSE, now "2025-2026 poli0981 (SkullMute)"); the catalog data (data_game/LICENSE.md) and the documentation are CC BY 4.0 (LICENSES/CC-BY-4.0.txt); creators' descriptions, cover images and trademarks are excluded.NOTICE.mdsums it up: not affiliated with itch.io. - Rewritten Terms of Use (with a content-removal process), Privacy Policy (Cloudflare as processor, exact browser storage, retention, rights under Vietnam's Law No. 91/2025/QH15 and the GDPR), Disclaimer, Security Policy and Code of Conduct, in English and Vietnamese. The EULA now covers only the desktop and Android apps. Contact addresses: legal@, privacy@, security@ and takedown@freeitchgames.win.
- Issue templates: "Add games" points to the Suggest page, "Remove a game" gained a
rights-holder section;
CODEOWNERSadded.
Fixed
- freeitchgames.win served the unbuilt
webapp/source tree (blank page;/package.json,/src/*publicly readable). The Vite web build now goes towebapp/dist, whichwebapp/wrangler.jsoncdeploys (workers_dev/preview_urlsoff). - All 15 Dependabot alerts / npm audit — lockfile refreshed in-range (vite 8.3.0,
react-router-dom 7.18.4, postcss 8.5.28, patched transitive deps);
npm auditreports 0. - Android release workflow moved off Node 20 actions (setup-java v6, upload-artifact v7, setup-android v4, checkout/setup-node v7), SHA-pinned, with a timeout and the tag passed via env.
.gitattributes—* text = auto/* eol = lfwere invalid (spaces around=); now* text=auto eol=lfwith binary rules, and legal/policy docs ship in source archives again.- OG image, manifest (
start_url/scope/id=/), canonical/og URLs, sitemap and robots now point at freeitchgames.win; OG title no longer overflows.
Data pipeline (rewrite)
- One rotating refresh replaces four failing crawls.
check_paid/check_alive/update_reviews/update_statuseach fetched all 2,600+ pages sequentially, overran their job timeouts and — saving only at the end — lost every run since late June (with no alert, because a timeout ends as cancelled). The newscripts/refresh.py(refresh.yml, daily) checks one seventh of the catalog with one request per game, so every game is re-checked weekly (~86% fewer requests to itch.io), and updates alive / paid / rating / status (+ backfills release date, thumbnail,updated_at) from that single page. - Safer removals: a game is removed only when the same 404/410 or paid status is seen again at
least 20 hours after it was first seen (single flaky responses no longer delete games). A
mass-change guard withholds removals — and alerts — when a run would remove or newly strike more
than max(10, 10%) of the games it checked (the signature of an itch.io markup change rather than
a real wave of paid games); withheld games stay withheld in later runs until a healthy check or
an explicit
allow_mass_removaldispatch, checkpoints of an interrupted scan never remove games, andapply_patch.pyre-checks the limits. Overlapping scans can no longer undo each other's newer checks. - Scan → patch → apply: scanners emit a URL-keyed patch;
apply_patch.pyapplies it to the latestmain, validates, andbash/commit_push.shretries on push races. Concurrent writers (extension, workflows, future admin) no longer clobber each other; checkpoints + an in-script deadline keep partial work. - Ingest (
update.yml, now runs as soon as the queue changes): canonical URLs, skips games in the deleted log (the removed-then-re-added bug), retries transient failures (3 attempts at least 6 hours apart; rate limiting never counts) instead of dropping them, stampsadded_at, and never wipes links queued meanwhile. A dispatchedurlis processed first and kept in the queue until it reaches a final outcome, and queued runs wait in FIFO order (queue: max) instead of replacing each other. force_update.ymlrunsrefresh.py --fullin rotating batches (a full re-scrape no longer times out).- Honest
FreeItchGamesBotUser-Agent, explicit 429 / Retry-After handling (capped), unbuffered logs, run summaries, Discord alerts on failure / cancel / rate limit. data_store.pykeeps games in their chunk and only writes changed bytes;index.json/count_history.jsonchange only when data does — no more no-op commits.- New
validate.py(schema, canonical URLs, duplicates, index consistency) gates every pipeline commit and runs in the new Python CI with a network-free pytest suite. Normalized one invalidsafe_virusvalue ("y"→"Yes").
Removed
lists/*.mdgenre tables,generate_md.py,generate_table.yml,deleted_games.txt,log_deleted.*— the catalog is web-only (freeitchgames.win).- Telegram bot ingest (
bot-ingest.yml,game_via_botissue template) — retired. - The web app's sign-in, editing, Add and Workflows pages, GPG signing, and the GitHub Pages
deployment (
deploy_webapp.yml,notify-deploy.yml,pages-redirect/; Pages keeps serving the redirect stub it last published). notify-ci-failure.yml(replaced by in-workflow notifications) and the old per-task bash wrappers.
CI / security
- All actions SHA-pinned at current majors;
permissions: {}by default with per-job grants; reusable workflows pinned by SHA with only the secrets they need; script-injection patterns inannounce-discussion.ymlfixed (and it now posts only forCHANGELOG.mdchanges). - Release: one
create-releasejob makes the draft that desktop (tauri-action v1,releaseId) and Android upload into; release builds use no dependency caches. Publish withgh release edit vX --draft=false. .github/dependabot.yml(npm / pip / actions / cargo), Python and web-app PR checks, and an hourly check of main's latest Cloudflare Workers Build that posts each failed build to Discord once (acheck_runrelay would miss the pipeline's own data commits).- One refresh pipeline (scan → apply) runs at a time, so overlapping refresh / force-update runs can't undo each other.
- Cancelling a refresh / force-update or a desktop release run now really stops it (
!cancelled()instead ofalways()on the push / build jobs).
Changed
- The old GitHub Pages address serves a redirect stub that forwards to freeitchgames.win
(keeping
#/routes) and deletes the old app's token and key storage on that origin. - Security headers in
webapp/public/_headers(CSP, Referrer-Policy, frame denial, Permissions-Policy, COOP) and immutable caching for hashed/assets/*. - Pipeline logs are unbuffered UTF-8.
[3.9.0] - 2026-06-15 (Android minSdk → 11 / API 30)
Changed
-
Android APK floor raised from API 24 (Android 7.0) to API 30 (Android 11).
minSdkVersioninwebapp/src-tauri/tauri.conf.jsonbundle.androidis now30. Because Android's package installer refuses any APK whoseminSdkVersionexceeds the device API level, this is the install block — the app simply can't install on Android < 11 ("app not installed / incompatible"); no runtime check by design. Rationale, stated honestly:- Not a JS-feature floor — the System WebView is independently updatable down to API 24, so SubtleCrypto / OpenPGP.js / IndexedDB / ES2020 already work on older OSes. That's not the binding constraint.
- Security + patch availability — Android 11 added scoped-storage enforcement, one-time / auto-reset permissions, and a tighter sandbox; pre-11 releases are also off Google's AOSP monthly Security Bulletins (Android 10 ended 2023-03-06, Android 11 ended 2024-02-05; only 14 / 15 / 16 remain as of mid-2026).
- Tested range — we validate only on Android 11+ (emulator 11 → latest; real phone
vivo 1907 / Android 12 — see
docs/pc_spec.md). Shipping an untested floor was the real risk. - Reach cost is small — API 30+ ≈ 86.9% of active devices (was 96.6% at API 24); only the pre-2020 long tail is dropped.
Data sources: endoflife.date/android, Android Security Bulletins, StatCounter version share (May 2026), apilevels.com (StatCounter cumulative distribution, Apr 2026).
Notes
versionCodere-derives to3009000(gotcha #18). The web and desktop builds are unaffected by the Android floor. Theabout.tsversion bump busts the IndexedDB catalog cache (harmless).
[3.8.0] - 2026-06-15 (Android APK target 📱)
Added
- Android APK build & packaging via Tauri mobile. The same React + Tauri app now ships as a
sideloadable arm64-v8a
.apk(no Play Store), built and post-signed (zipalign→apksigner) by.github/workflows/release_android.ymland attached to the same draft Release as the desktop installers (manualworkflow_dispatchuploads it as a downloadable workflow artifact instead).gen/androidstays gitignored — signing is a post-build step, not a Gradle edit. New repo secrets:ANDROID_KEYSTORE_BASE64/ANDROID_KEYSTORE_PASSWORD/ANDROID_KEY_ALIAS. Full build/signing docs inwebapp/TAURI.md. - Mobile UX — the Android hardware / gesture back button is wired to in-app router history
(
useBackButton), safe-area insets are respected, and the sidebar shows a platform-aware badge ("Mobile app" / "Desktop app"). - Added dependency:
@tauri-apps/api.
Changed
- Bundle
identifieris now alphanumeric —com.poli0981.freegamesitchio(was the hyphenatedcom.poli0981.free-games-itchio-webapp). Android rejects hyphens in the app id (android initpanics) and Tauri's validator rejects underscores, so alphanumeric is the only form valid on both. Tauri uses one identifier across all platforms, so this also changed the desktop bundle ID (a one-time OS-level reinstall). - Realigned versions —
tauri.conf.json/Cargo.toml/about.tsset to3.8.0(was a long-standing0.1.1vs3.xdrift), soversionCode/versionNameare sensible and monotonic.
Notes
- CI: the Android JDK setup must not use
cache: gradle—gen/androidis gitignored and generated mid-job, so there are no gradle files at checkout to key on (it hard-fails). rust-cache- npm cache still apply.
[3.7.1] - 2026-06-14 (Hotfix — desktop build vs invalid Tauri NSIS license key)
Fixed
- v3.7.0's desktop installers never built. The NSIS EULA was wired via
bundle.windows.nsis.license, but@tauri-apps/cli2.11.0'sNsisConfighas nolicensekey (it was added in a later release), so every platform failed config validation at theBuild Tauri appstep. Switched to the top-levelbundle.licenseFile(valid in 2.11.0) pointing at an RTF EULA (webapp/src-tauri/installer/EULA.rtf). RTF satisfies both Windows bundlers — WiX (.msi) requires RTF and NSIS (.exe) auto-detects it — so both installers show the "I Agree" page. The previous plain-textEULA.txtwould also have broken the WiX/.msibuild.
Notes
- Web feature set is identical to v3.7.0 (which deployed fine); this tag exists
to produce the desktop installers.
about.tsversion bump also busts the IndexedDB catalog cache, which is harmless. No Tauri version bump (tauri.conf.jsonstays0.1.1).
[3.7.0] - 2026-06-14 (Legal-acceptance gates + per-tab chart lazy-loading)
Added
- First-launch legal-acceptance gate — on first visit (and in every fresh
incognito session, since
localStoragestarts empty there) the app shows a full-screen, non-dismissible gate before the main UI. It links the License, EULA, Privacy Policy, Disclaimer, Terms of Use, Code of Conduct, and Security Policy (reusingLEGAL_LINKS), and requires ticking a checkbox to continue. New componentwebapp/src/components/legal-gate.tsx, built on raw Radix Dialog primitives (focus-trapped, no close-X, Esc / outside-click disabled). Acceptance persists asacceptedLegalVersionin the existingwebapp.prefslocalStorage blob — no cookie (consistent with the "no cookies" privacy stance). ALEGAL_VERSIONconstant (webapp/src/stores/prefs.ts) lets a future policy edit re-prompt every user with a one-line bump. - Windows installer EULA page — both Windows installers (the NSIS
.exeand the WiX.msi) now show an "I Agree" license step before installing, wired via the top-levelbundle.licenseFile→webapp/src-tauri/installer/EULA.rtf. RTF is used so both bundlers render it (WiX requires RTF; NSIS auto-detects it). The in-app gate above covers first-run consent on macOS / Linux, whose installers have no equivalent step.
Changed
- Charts route split into four lazy per-tab chunks
(
webapp/src/components/charts/tabs/). Each tab imports its chart components directly (thecharts/index.tsbarrel was removed so the bundler keeps each tab's components in its own chunk). Result: only the default Overview tab's components load when/chartsopens; the Reach / Quality / Discovery component code downloads on first click. Recharts itself (the ~380 KBvendor-chartschunk) still loads with Overview — unavoidable since the default tab renders charts — but it was already deferred to the lazy/chartsroute, so it never touches app startup. about.tsversion → 3.7.0 (also busts the IndexedDB catalog cache, harmless); Claude Code co-author credit updated to Opus 4.8.
Notes
- Images, routes, and OpenPGP were already lazy-loaded; this release closes the
remaining gap (charts). No Tauri version bump (
tauri.conf.jsonstays0.1.1) — the NSIS license is a bundler-config addition, not a binary change.
[3.6.1] - 2026-06-12 (Hotfix — desktop build vs broken time 0.3.48)
Fixed
- v3.6.0's desktop installers never built:
time0.3.48 (released 2026-06-12, hours before the v3.6.0 tag) fails to compile insidetauri-utilswithE0119: conflicting implementations of trait From<…>(time-rs/time#783). Since noCargo.lockis committed, CI resolved the broken release fresh.webapp/src-tauri/Cargo.tomlnow pinstime = "=0.3.47"(the version every release through v3.5.2 built with) — remove the pin once the upstream fix ships.
Notes
- Web feature set is identical to v3.6.0; this tag exists to produce the
desktop installers.
about.tsversion bump also busts the new IndexedDB catalog cache, which is harmless. - No Tauri version bump (
Cargo.toml/tauri.conf.jsonstay0.1.1) — a dependency pin to the previously-resolved version changes no binary behavior.
[3.6.0] - 2026-06-12 (i18n EN/VI + offline cache + custom error pages)
Added
- Bilingual UI (English / Tiếng Việt) — a minimal typed i18n layer
(
webapp/src/lib/i18n/) with ~340 keys covering every route, dialog, chart, and toast. The Vietnamese dictionary is a lazy-loaded chunk: it is only downloaded the first time the language is switched to VI (or on startup when VI is the persisted preference). Switcher lives in Settings → Appearance; the preference persists inwebapp.prefs. - Offline-first catalog cache — the react-query cache for the public
catalog queries (
db,deleted,count-history) now persists to IndexedDB (@tanstack/react-query-persist-client+@tanstack/query-async-storage-persister+idb-keyval). Revisits paint instantly from cache (~2 MB of JSON no longer re-downloaded cold) and revalidate in the background. Cache busts automatically on each release (buster = APP.version,maxAge7 days). PAT-gated data is never persisted. - Custom error pages — a status-aware
ErrorPage(400, 401, 403, 404, 408, 419, 429, 500, 502, 503, 504, offline, unknown) wired into every route's error branch with the real HTTP status (fetchRawnow throws a typedHttpError), plus:- a route-level ErrorBoundary that detects stale-chunk failures after a redeploy and offers a one-click reload ("New version available"),
- a hidden
/#/errors/:codepreview route, - a static
webapp/public/404.htmlserved by GitHub Pages for bad path URLs (bilingual, dark-mode aware, zero JS).
Changed
ReactQueryDevtoolsis now explicitly gated behindimport.meta.env.DEV.- Game thumbnails render through a shared
GameThumbthat falls back to the muted placeholder when a cover 404s; the Settings avatar is now lazy-loaded. idb-keyvalreturns (removed as unused in v3.5.2 — it has a real consumer now);THIRD_PARTYinabout.tslists the three new data-layer deps.
Notes
- The About page's legal/credits data intentionally stays English (controlling
language for legal interpretation); Vietnamese policy docs remain under
docs/i18n/vi/. - No Tauri / Rust binary boundary change —
Cargo.toml/tauri.conf.jsonstay at0.1.1.
[3.5.2] - 2026-05-23 (Dead-code cleanup — knip + vulture)
Added
- knip (v6) wired into the webapp as the unused-files / exports /
dependencies detector — config in
webapp/knip.json, run viacd webapp && npm run knip. - vulture configured for the Python pipeline (
[tool.vulture]inpyproject.toml) — it catches dead functions, classes, and attributes that ruff'sFrules don't. docs/THIRD_PARTY.md— a new doc attributing the dev-only tooling (knip, vulture, ruff, ESLint, TypeScript), cross-linked fromdocs/ACKNOWLEDGEMENTS.md.
Removed
- 8 unused webapp dependencies:
react-hook-form,@hookform/resolvers,zod,idb-keyval,@radix-ui/react-dropdown-menu,@radix-ui/react-tooltip,@tauri-apps/plugin-http,@tauri-apps/api. - The unwired Tauri Phase-8b scrape-preview scaffold —
webapp/src/lib/tauri-scrape.tsandgetRuntimeInfo/RuntimeInfoinruntime.ts. It was documented but never wired into any UI;webapp/TAURI.mdwas trimmed to match. - ~20 unused webapp exports / types — dead helpers (
findChunkFor,indexByUrl,rawUrl,useIndex,isIdleExpired, …), the unusedEDITABLE_FIELDS/READONLY_FIELDSconstants, and 7 unused shadcn/ui primitive exports. Exports used only inside their own module were demoted fromexportrather than deleted.
Changed
webapp/src/lib/about.tsTHIRD_PARTYarray trimmed to match the removed dependencies.
Notes
- DX / code-quality only — no runtime behaviour change.
isIdleExpiredwas already dead (nothing called it), so PAT idle auto-lock is unchanged — still not enforced. - No Tauri / Rust binary boundary change —
Cargo.tomlandtauri.conf.jsonstay at0.1.1. The Rusttauri-plugin-httpcrate is now unreferenced from the front-end — a candidate for a future Rust-side cleanup. - knip + vulture join
npm run lint,ruff check, andnpm auditas the standing pre-release QA pass.
[3.5.1] - 2026-05-20 (Lint cleanup — zero ESLint problems)
Changed
npm run lintnow runs clean — 0 errors, 0 warnings (down from 17 errors + 5 warnings, all pre-existing; v3.5.0 added none).webapp/eslint.config.js:react-refresh/only-export-componentsis turned off forsrc/components/ui/**— the vendored shadcn primitives intentionally mix component and variant/constant exports and cannot satisfy the rule without forking upstream. The rule stays on for all other app code.react-hooks/incompatible-libraryis turned off — it only flagged TanStack Table'suseReactTable, whose API is not React-Compiler-memoizable by design (not actionable).
SortableHeaderextracted into its ownwebapp/src/components/data-table/sortable-header.tsx;columns.tsxis now a pure column-definition module.
Fixed
react-hooks/exhaustive-depsinroutes/games.tsxanddata-table/faceted-filter.tsx: values built with?? []created a fresh array every render, defeating theuseMemos that depended on them.datais now wrapped inuseMemo; the faceted-filterselectedmemo was restructured to depend on a stable value.
Notes
- DX / code-quality only — no runtime behaviour change. No Tauri / Rust binary change (
Cargo.toml/tauri.conf.jsonstay0.1.1); noTHIRD_PARTYchange.
[3.5.0] - 2026-05-20 (Charts expansion + game-count history + pipeline cleanup)
Added
- Six new charts on
/charts.- Game count over time — a
LineChartof the catalog size by day, backed by a newdata_game/count_history.json(date-keyed{date, total}series).scripts/data_store.py_append_count_history()upserts today's total on every catalog write (last-write-wins per UTC day).scripts/backfill_count_history.pyis a one-time dev tool that reconstructs the series from git history (data_game/index.json, plus the pre-refactorscripts/game_info.json). The webapp loads it vialoadCountHistory/useCountHistory. - Genre treemap — a Recharts
Treemapwith a custom cell renderer that hides labels on rectangles too small to fit them, so it stays legible on mobile. - KPI summary cards — total games / online / NSFW / deleted / average rating, above the Overview grid.
- Deletions over time (bar, by month), Deletion reasons (pie: became-paid vs page-removed), and Most rated games (top 10 by
rating_count).
- Game count over time — a
- Scroll-to-top button — a floating bottom-right button that appears after scrolling the main pane. New
webapp/src/components/scroll-to-top.tsx. - Python linting —
ruffconfig in a new rootpyproject.toml; runruff check scripts/.
Changed
charts.tsxsplit into a module. The monolith is now awebapp/src/components/charts/folder — one file per chart, a sharedchart-card.tsx(ChartCard+PALETTE), and anindex.tsbarrel. 16 charts across the 4 tabs.scripts/json_io.py— new shared module.load_json/save_json(previously copy-pasted into bothcheck_alive.pyandcheck_paid.py) live here now, alongsidededup_deleted.- README + README.vi badges bumped to
3.5.0.
Fixed
- The deleted-games log can no longer accumulate duplicate URLs.
check_alive.pyandcheck_paid.pyappended toscripts/deleted_games.jsonwith no guard — a game removed, re-added by the scraper, then removed again would be logged twice. The newdedup_deleted()(keyed by URL, keeping the earliestdeleted_at) runs on every write and insidelog_deleted.py. Two genuinely different games that share a title but have different urls are kept separate.
Notes
- No Tauri / Rust binary boundary change —
Cargo.tomlandtauri.conf.jsonstay at0.1.1, noTHIRD_PARTYentries change (Recharts already shipped;Treemap/LineChartneed no new dependency). data_game/count_history.jsonis auto-committed by the scrape workflows — the bash wrappers alreadygit add data_game/wholesale, so no workflow changes were needed.- The dead-code sweep found the project already tidy (TS strict mode + ESLint catch unused webapp code).
webapp/src/lib/tauri-scrape.tstauriScrapePreviewwas reviewed and intentionally kept as a Phase-8b stub.
[3.4.1] - 2026-05-17 (Hotfix: DataTable column alignment + Discussion-announce auto-discovery)
Fixed
- DataTable columns misaligned at desktop widths. Header used native table-layout (
<table className="w-full">+<th style={{width}}>) while body rows used flex layout (position: absolute+flex w-full, cells withflex: 0 0 Npx/1 1 0). Native table-layout stretched the 8 size-less columns to fill the container based on content, but the absolutely-positioned body<tr>never participated in table layout — so its flex children stayed at their fixed flex-basis. Result: at the Tauri default 1280×800 window (and any viewport wider than the natural sum of header content widths) header columns drifted off the cells below them.webapp/src/components/data-table/data-table.tsxnow renders the header<tr>withflex w-fulland each<th>withflex h-10 items-center+ the sameflex: 0 0 Npx/1 1 0style block as the body<td>— header and body now compute width identically. HelperpriorityHeaderClass(which emittedtable-cellvariants) is gone; the existingpriorityClass(flexvariants) now drives both. No change to column definitions incolumns.tsx. announce-discussion.ymlwas a silent no-op since v3.2.0. Both jobs (announce-release,announce-docs) gated on three repo variables (DISCUSSION_REPO_ID,DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID,DISCUSSION_GENERAL_CATEGORY_ID) that had never been configured — the validation step printed::warning::… Skipping.andexit 0, so every release silently failed to post to Discussions without surfacing a failed run. Replaced the two validation steps with aDiscover Discussion IDsstep that queriesgh api graphqlforrepository.idand looks up the category by slug (announcements/general). Zero config now — works on any repo with Discussions enabled. Fails loudly with a clear::error::message if Discussions isn't enabled or the expected category is missing. Dropped the dependency onvars.DISCUSSION_*and removed everyif: steps.validate.outputs.ids_ok == 'true'gate.
Changed
- README + README.vi badges bumped to
3.4.1.
Notes
- This is a webapp + CI hotfix. No Python pipeline changes, no Tauri / Rust binary boundary change —
Cargo.tomlandtauri.conf.jsonstay at0.1.1, no THIRD_PARTY entries change. - The leftover
DISCUSSION_REPO_ID/DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID/DISCUSSION_GENERAL_CATEGORY_IDrepo variables (if you set them earlier) are now unused and can be removed from Settings → Variables.
[3.4.0] - 2026-05-16 (Periodic refresh workflows + UTF-8 round-trip fix)
Added
- Update reviews — bi-weekly workflow. New
scripts/update_reviews.py, wrapperbash/update_reviews.sh, and.github/workflows/update_reviews.ymlre-scrape every existing game's itch.io page on the 1st and 15th of each month (05:00 UTC) and write freshrating+rating_count. Network errors / 404 keep the old values. Touches only those two fields — everything else (annotations, metadata) is left alone. - Update status — monthly workflow. New
scripts/update_status.py,bash/update_status.sh, and.github/workflows/update_status.ymlrefresh thestatusfield on the 1st of each month (06:00 UTC). Same skip-on-error semantics. - Force update — manual emergency button. New
scripts/force_update.py,bash/force_update.sh, and.github/workflows/force_update.ymlaccept an optionalurlinput. Empty input re-scrapes every game; a single URL targets just that one.workflow_dispatchonly — no schedule. Every run preserves the three user-editable annotations (safe_virus,notes,nsfw) per the read/write field convention in CLAUDE.md. Doubles as the canonical repair tool for mojibake left by older webapp commits — re-scrape pulls clean UTF-8 from itch.io. generate_table.ymlchained on the three new workflows solists/*.mdstay in sync after any data mutation.
Fixed
- UTF-8 mojibake on webapp commits.
webapp/src/lib/github/contents.tsreadFileWithShaandwebapp/src/lib/github/git-data.tsbulkDeleteGameswere decoding GitHub's base64 content withatobalone, producing a Latin-1 binary string. Multi-byte UTF-8 sequences (e.g. Vietnameseã=0xC3 0xA3) became two Latin-1 code points (ã); the next write re-encoded them as UTF-8 bytes, double-corrupting on every edit. Confirmed live damage indata_game/game_info_002.json(BotÃÂão Esquerdowas originallyBotão Esquerdo). Extracted a shared helperwebapp/src/lib/github/encoding.ts(base64ToUtf8/utf8ToBase64) that usesTextDecoder('utf-8')/TextEncoderand routes both call sites through it. Write path was already correct.
Notes
- Repair existing mojibake: after this release deploys, run
Force updateonce viaworkflow_dispatchwith no input. It re-scrapes every game (~15–25 min) and writes back clean UTF-8 while preserving manual annotations.generate_table.ymlwill then auto-regenerate the markdown lists. - Browser cache: anyone editing via the webapp should hard-refresh once after the new build lands so they're not using the pre-fix bundle (which would continue to mangle non-Latin chars on the next edit).
- README + README.vi badges bumped to
3.4.0. No Tauri / Rust binary change —Cargo.tomlandtauri.conf.jsonstay at0.1.1.
[3.3.0] - 2026-05-16 (Mobile polish + Settings + in-browser GPG commit signing)
Added
- In-browser GPG commit signing. Every write the webapp makes (single-file edits, bulk edit/delete, queueing URLs) can now be GPG-signed client-side. New
webapp/src/lib/gpg/module:canonicalize.tsbuilds the exact byte string Git would hash,sign.tslazy-importsopenpgpand exposesloadPrivateKey/signCommit/verifyDetached,storage.tswraps localStorage helpers. Verified byte-for-byte againstgit cat-file commit <sha>so the signed canonical exactly matches what GitHub will recompute (no trailing-newline drift). Private keys are decrypted once at import and re-encrypted with the webapp passphrase (AES-GCM, same scheme as the PAT) —openpgpis loaded only when the Commit Signing card is opened or a commit is being signed (vendor-openpgpchunk, ~129 KB gz, lazy). - Settings → Commit signing card. New
webapp/src/components/settings/gpg-card.tsx— three states (not configured / locked / unlocked) with Import (paste armored or upload.asc), Unlock, Test sign (round-trip verify), Copy public key, Lock, Remove. Shows the imported key's UIDs as badges and flags a clear mismatch warning if the configured commit-author email isn't in the key's UID list (the most common cause of GitHub's "Someone may be trying to trick you" warning). After import, primary UID email auto-populates Commit author so commits Verify on the first try. - Settings Phase A — Appearance / Session / Commit author / Notifications cards.
webapp/src/routes/settings.tsxgained four new cards backed by extended preferences inwebapp/src/stores/prefs.ts: theme picker (Light / Dark / System), layout density (Normal / Compact), sidebar collapse mirror, idle-timeout slider (5 / 15 / 30 / 60 / 120 min — replaces the hard-coded 30-min constant inauth.ts), commit-author name/email override, toast enable + duration. Density applies viahtml[data-density='compact']rules inindex.css; toasts are gated through a newAppToasterwrapper that reads prefs. - Mobile card view for the games table. New
webapp/src/lib/use-is-mobile.ts(matchMedia('(max-width: 767px)')) andwebapp/src/components/data-table/mobile-card-list.tsx. Below themdbreakpoint,DataTablerenders a stacked card list (thumbnail + name + dev + genre/status/NSFW/safe badges, tap-to-detail, selection checkbox) instead of the 9-column virtualized table that overflowed at 430 px. Pagination is shared between both views. - Workflows route mobile fallback.
workflows.tsxnow dual-renders the action picker — a<Select>dropdown belowmd, the existingTabsListatmdand above. Fixes the overflow from fivewhitespace-nowraptriggers in aninline-flexTabsList at 430 px viewport.
Changed
- All write paths route through the Git Data API.
webapp/src/lib/github/contents.tsputFile(PUT /repos/.../contents/{path}) is gone — that endpoint authors commits as the PAT and never accepts asignaturefield. Replaced withcommitSingleFilewhich delegates toatomicCommitso single-file edits (game annotations,temp_link.jsonqueue) get the same signer plumbing as bulk operations.atomicCommitgained an optionalsignerparameter (defaulting togetSignerIfEnabled()) that, when present, builds the canonical commit object, signs detached binary-mode via openpgp, and passesauthor/committer/signaturetogit.createCommit. Commit author identity falls back through prefs override → imported key's primary UID email → GitHub user. - About page lists
OpenPGP.js6.3 under Data dependencies; thewebapp/vite.config.tsmanualChunksrule emits a dedicatedvendor-openpgpchunk so the cost is only paid when a user opens the signing card. - README + README.vi badges bumped to
3.3.0.
Fixed
- Workflows
/workflowstabs no longer overflow on mobile. Pre-fix: fivewhitespace-nowraptriggers in aninline-flexTabsList blew past a 430 px viewport. - DataTable no longer overflows on mobile. Pre-fix: nine fixed-width columns minus three responsive-hidden ones still exceeded 430 px.
[3.2.1] - 2026-05-11 (Hotfix: single-instance enforcement on desktop)
Fixed
- Desktop app spawned a new process on every launch. Each double-click of the installed app added another
free-games-itchio-webapp.exe(Windows) / equivalent on macOS+Linux to the task list instead of focusing the existing window. Addedtauri-plugin-single-instancev2 inwebapp/src-tauri/src/lib.rs— second launch now unminimizes + focuses the running window and exits its own process before creating a duplicate. Plugin registered first in the builder chain per Tauri 2 docs so duplicate processes die before initializing HTTP/opener plugins. Gated by#[cfg(desktop)]+ matchingcfg(not(android, ios))inCargo.toml. Desktop binary boundary change → bumpedCargo.tomlandtauri.conf.jsonfrom0.1.0to0.1.1(first time these have moved since v3.0.0).
Changed
- README + README.vi badges bumped to
3.2.1. - About page lists
tauri-plugin-single-instancev2 under Desktop dependencies.
[3.2.0] - 2026-05-10 (CI cleanup + mobile + SEO + Telegram bot path + auto-discussion)
Added
- Mobile drawer navigation. New
webapp/src/components/ui/sheet.tsx(shadcn pattern over the existing@radix-ui/react-dialog) and aMobileTopBarinwebapp/src/components/sidebar.tsx. Belowmd, the sidebar collapses behind a hamburger; above, the desktop sidebar behaves as before. Touch targets in the nav now meet the 44pt iOS HIG minimum on small screens. - DataTable column priorities. Each column declares
meta.priority: 1 | 2 | 3incolumns.tsx.data-table.tsxhides priority 2 belowmdand priority 3 belowlg, so the table is usable on a phone without horizontal scrolling through every column. - PWA manifest + icons.
webapp/public/manifest.webmanifest,icon-192.png,icon-512.png— Add to Home Screen on iOS without a service worker. Generator script:webapp/scripts/gen_assets.py. - SEO infrastructure.
webapp/index.htmlnow ships description, theme-color (per scheme), Open Graph (title/description/image/url/type/locale), Twitter card (summary_large_image),canonical,apple-touch-icon,manifest, andpreconnecttoimg.itch.zone+raw.githubusercontent.com.robots.txtandsitemap.xmladded underwebapp/public/. - OG image.
webapp/public/og.png(1200×630) +og.webpgenerated bygen_assets.py. Brand-coloured (#863bffpurple, cyan accent) with project name, tagline, and URL. - Per-route titles. New
useDocumentTitlehook (noreact-helmet-asyncdependency). Each route now sets a contextual title (Charts — Itch.io Free Games Database, etc.); game-detail uses the game name. - Hash-anchor scroll.
App.tsxnow wires aScrollToHashlistener so links like/about#supportscroll to the matching element under HashRouter. - About page Telegram entries. New
messagingsocial group with Telegram (DM) and Telegram bot (game submission) plus a privacy reminder to never paste a numeric ID into public channels. About also surfaces all five FUNDING.yml destinations (GitHub Sponsors, Patreon, Ko-fi, Buy Me a Coffee, PayPal) with a footnote on PayPal explaining the legal-name receipt. - Sidebar Support link. Persistent heart-icon link from the sidebar (collapsed and expanded) to
/about#support. - Telegram bot contribution flow.
CONTRIBUTING.md §1bdescribes the bot path (DM owner → numeric ID added to local whitelist → bot dispatchesbot-ingest.yml). Cross-linked from README.md, README.vi.md, and the new issue templategame_via_bot.yml. Vietnamese mirror indocs/i18n/vi/CONTRIBUTING.md. - Privacy + ToS clauses for the bot path.
docs/ToS.md §14anddocs/PrivacyPolicy.md §15(plus VI mirrors) document Telegram-ID handling: opt-in, operator-side whitelist only, never committed to this repo, removable on DM. docs/pc_spec.md+docs/dev_env.md(EN + VI). Maintainer hardware spec, mobile test devices (iPhone 14 Pro / 13 Pro Max, iOS 26.x on Chrome + Brave), and dev-env toolchain (Python 3.12, Node ≥ 22, Rust stable, JetBrains 2026.x). Cross-linked from README and CONTRIBUTING.- Auto-create GitHub Discussion workflow.
announce-discussion.yml— onrelease: publishedposts to the Announcements category; on push todocs/**/CHANGELOG.md/README*.mdposts to General, gated by[skip-discuss]in the head-commit message and a quiet skip onbot-ingest:commits. Usesgh api graphqldirectly (no third-party action). Setup: configure repo variablesDISCUSSION_REPO_ID,DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID,DISCUSSION_GENERAL_CATEGORY_ID(run the GraphQL pre-flight query in the workflow header to fetch them).
Changed
- CI notify wrappers.
notify-ci-failure.yml,notify-deploy.yml, andnotify-release-pipeline.ymlreplaceworkflows: ["*"]with explicit allowlists. Every workflow run no longer fans out to all three wrappers; the Actions tab is much quieter and the per-event reusable filtering is what it always should have been. bot-ingest.ymlcleanup. Removed a dead final step that referenced a non-existent${{ secrets.BOT_TOKEN }}and aresult.txtfile. The Pythonsuccess/failureTelegram callback steps above already handle both outcomes.- Image hints. Game thumbnails in
columns.tsxand the hero ingame-detail.tsxnow declarewidth/height(CLS),decoding="async", andfetchPriority(high for hero, low for table rows). itch.io thumbnails remain external — full WebP recompression is intentionally deferred (would require an image proxy). - About support card mirrors
.github/FUNDING.ymlexactly: 5 entries (GitHub Sponsors, Patreon, Ko-fi, BMC, PayPal). - README + README.vi badges bumped to
3.2.0.
Fixed
- Bot ingest workflow had a broken final telegram callback step (wrong secret name + missing input file). Removed; the working callback steps above are unaffected.
Setup notes for maintainers (one-time, post-merge)
To enable the auto-discussion workflow, run once:
gh api graphql -f query='query{repository(owner:"poli0981",name:"free-games-itchio-list"){
id
discussionCategories(first:20){nodes{id slug name}}
}}'
Then in repo Settings → Secrets and variables → Actions → Variables, add:
DISCUSSION_REPO_ID— therepository.idfrom the response.DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID— theidof the Announcements category.DISCUSSION_GENERAL_CATEGORY_ID— theidof the General category.
Without these set, the workflow runs but no-ops with a warning (safe default).
[3.1.4] - 2026-05-05 (Legal docs rewrite + Vietnamese i18n + Legal Card + UI polish)
Added
- Vietnamese translations under
docs/i18n/vi/— full translations of the four legal docs (DISCLAIMER, EULA, ToS, PrivacyPolicy) plus CONTRIBUTING, CODE_OF_CONDUCT, and SECURITY. Each file notes that the English version is the controlling text for legal interpretation. README.vi.mdat repo root — Vietnamese mirror of the main README, with a language badge and a link back to the English version.- About page → "Legal & policies" Card — single place to access all policy files (Disclaimer, EULA, ToS, Privacy, Code of Conduct, Security, License, Changelog) plus a pointer to the Vietnamese translations.
webapp/src/lib/about.ts:LegalLinkinterface +LEGAL_LINKSarray +LEGAL_VI_INDEX_URL. Same structured pattern asTHIRD_PARTYandSOCIAL_LINKS.
Changed
docs/DISCLAIMER.md,docs/EULA.md,docs/ToS.md,docs/PrivacyPolicy.md: rewritten to be tighter and more enforceable while keeping the project's voice. Each doc now has a TL;DR, numbered sections, definitions, severability, governing law (Socialist Republic of Vietnam), explicit "not legal advice" notice, and a removal-request path. Privacy Policy adds a per-storage table for what the webapp persists locally and a step-by-step PAT lifecycle.README.mdversion badge → 3.1.4 plus a Vietnamese language badge and a short pointer toREADME.vi.mdanddocs/i18n/vi/.
Optional UI
- Tauri desktop: maximize button is now disabled (
maximizable: falseinwebapp/src-tauri/tauri.conf.json). Window is still resizable; only the full-window-maximize action is locked. - DataTable: scrollbar hidden via a new
.scrollbar-hideTailwind utility added towebapp/src/index.css. Scrolling still works; the chrome is gone.
[3.1.3] - 2026-05-05 (Credit Claude Code as AI co-author)
Added
- About page: new "AI co-authors" Card listing both Grok (xAI) and Claude Code (Anthropic — Claude Opus 4.7, 1M context) with their roles in the repo's history. Each entry is linked + tagged with vendor and model.
webapp/src/lib/about.ts: newAiToolinterface +AI_TOOLSarray so the AI credit data is structured the same way asTHIRD_PARTYandSOCIAL_LINKS.
Changed
docs/ACKNOWLEDGEMENTS.md,docs/My_Stuff.md,CONTRIBUTING.md: surface Claude Code alongside Grok wherever the existing AI credit lived. Grok references stay — both buddies share the workload now (Grok carried the Python pipeline + v2.0.0 rewrite; Claude Code drove v3.0.0 webapp/Tauri and v3.1.2).My_Stuff.md"The Real MVP" is now plural.DEV.blurbon the About page reflects the two-buddy reality.
[3.1.2] - 2026-05-05 (Offline link fix + About expansion + docs sweep)
Fixed
- Tauri desktop: external links (itch.io, GitHub, third-party home pages) now
open in the user's default browser instead of doing nothing. Added
tauri-plugin-opener(Rust + JS) and a scopedopener:allow-open-urlcapability locked tohttps://*(nofile:///javascript:schemes).
Added
- About page: three new sections — Developer card, "Found a bug?" CTA that opens the bug-report issue template, and "Find me elsewhere" with X, YouTube, two Discord servers (Repo discussion / Game chat), Patreon, Ko-fi, Steam, Bluesky, and Mastodon.
<ExtLink>(webapp/src/components/ext-link.tsx) — runtime-aware external-link wrapper used app-wide so the offline link bug can't recur. On web it renders a plain<a target="_blank">; on Tauri it routes throughtauri-plugin-opener. All existing external<a>tags in About, the sidebar footer, and Game Detail now use it.
Changed
webapp/README.md: rewritten from Vite boilerplate to actual webapp docs (routes, dev/build commands, code-split layout, deploy, Tauri reference).CONTRIBUTING.md,docs/ACKNOWLEDGEMENTS.md,docs/My_Stuff.md,README.md: refreshed contact / social handles. The "if I ever make a Discord" line is finally obsolete — both servers exist.
[3.0.0] - 2026-05-04 (Webapp + Desktop 🖥️📊)
A React + TypeScript SPA on top of the same JSON catalog, plus a Tauri 2 desktop wrapper. The Python pipeline from 2.0.0 is untouched and still drives the daily data updates.
Added (Webapp)
webapp/— Vite + React 19 + TypeScript 6 + Tailwind v3 + shadcn/ui (Radix primitives). Code-split, ~163 KB gzip initial load. Reads fromraw.githubusercontent.com(public, no auth); writes use a fine-grained GitHub PAT held only in memory after passphrase unlock.- 8 routes: Dashboard (KPIs), Games (virtualized DataTable + faceted filters), Game Detail
(23-field read view + edit form for
safe_virus/notes/nsfw), Add (single URL + bulk), Charts (9 Recharts visualizations in 4 tabs), Workflows (run history + Dispatch), Deleted (tombstone log), Settings (PAT + theme), About (license attribution). - PAT encryption — AES-GCM 256-bit, PBKDF2-SHA256 (100k iterations) with per-token salt. Encrypted blob in localStorage; decrypted token in memory only.
- Atomic bulk operations — Bulk edit / delete via GitHub Git Data API (single commit for N files), 20-entry undo stack with one-click revert.
- Workflow dispatch from UI — Add a single URL or queue a bulk batch directly to
update.ymlviaworkflow_dispatch. Polls run status every 5 s and refreshes the table on completion. - Sync button + manual refresh — invalidate all data queries on demand; spinner reflects in-flight state.
- Collapsible sidebar with rail mode (240 px ↔ 56 px).
- Dark / Light / System theme with
prefers-color-schemelistener. - About page — third-party license attribution by category, app version + build date.
Added (Desktop wrapper)
webapp/src-tauri/— Tauri 2 scaffold (Rust + WebView). Same React build, ~10 MB installer.tauri-plugin-httpscoped to*.itch.io,img.itch.zone,api.github.com,raw.githubusercontent.com. Lets the desktop bypass CORS for direct itch.io previews.webapp/TAURI.md— local prerequisites (rustup + platform deps), dev/build commands, roadmap to a full Rust scrape (Phase 8b).
Added (CI)
.github/workflows/deploy_webapp.yml— buildwebapp/and publishdocs/app/to GitHub Pages on push tomainthat toucheswebapp/. One-time setup: repo Settings → Pages → Source = "GitHub Actions"..github/workflows/release_desktop.yml— multi-platform Tauri build viatauri-apps/tauri-actionon tagv*. Uploads.msi/.dmg/.AppImageto a draft GitHub Release.
Changed (Python pipeline)
scripts/update_info.pynow reads an optionalINPUT_URLenv var (forwarded byupdate.ymlfromworkflow_dispatch.inputs.url) and appends it to the queue. Backwards compatible: the daily cron still processestemp_link.jsonexactly as before..github/workflows/update.ymlgainsworkflow_dispatch.inputs.urlso the webapp can trigger a single-URL scrape.
[2.0.0] - 2026-03-26 (Major Rewrite 🔧⭐)
Rewritten
scraper.py— new shared module extracted fromupdate_info.py. All scraping logic, session management, rate-limiting, and parsing utilities live here. Used by every script that touches itch.io.update_info.py— fully rewritten. Usesscraper.pymodule,requests.Sessionwith automatic retry (backoff on 429/5xx), and random delays between requests.generate_md.py— fully rewritten with pipe-character escaping and all new data fields.
Added
- Free game detection —
update_info.pynow checks if a game is free before scraping. Paid games are skipped automatically. Detection logic parsesdiv.buy_rowfor price tags and button text. check_paid.py— new script. Re-checks every game in the list to see if it became paid. Paid games are removed and logged todeleted_games.jsonwith reason and timestamp.check_alive.py— new script. Verifies that all game URLs still exist. Pages returning 404 or 410 are removed and logged. Transient errors (403, 5xx, timeouts) are kept.log_deleted.py— new script. Convertsdeleted_games.json→deleted_games.txt(human-readable log sorted by date).deleted_games.json— structured log of all removed games with URL, name, reason, and deletion timestamp.- New data fields scraped from itch.io info table:
status,platforms,publisher,release_date,made_with,rating,rating_count,average_session,languages,inputs. All fields default toN/Awhen not found. - Author/Authors handling — scraper now checks both
AuthorandAuthorskeys (itch.io uses either depending on the page). - Release date parsing — extracted from
<abbr title="...">for full datetime instead of abbreviated text. - NSFW detection expanded — now also checks game description text and adds
sexualkeyword.
Added (GitHub Actions)
check_paid.yml— runs every 2 days at 04:00 UTC. Removes games that became paid.check_alive.yml— runs every 2 days at 07:00 UTC (staggered 3h after check_paid). Removes dead links.log_deleted.yml— runs after check_paid or check_alive completes. Exports deletion log.generate_table.yml— now triggers after update, check_paid, and check_alive workflows (not just update).update_csv.yml— now triggers after table generation (chained workflow).
Improved
- Rate limiting — random delays (2.5–5s between requests, 15–30s batch pause every 20 requests) to avoid itch.io IP bans. Lighter delays (1–2.5s) for HEAD/status checks.
- Retry logic —
requests.SessionwithHTTPAdapter+Retry(3 attempts, exponential backoff 2→4→8s) on 429/500/502/503/504. - Network error safety — games are never deleted on transient network failures. Only confirmed 404/410 or confirmed paid status triggers removal.
- Markdown table integrity — pipe characters (
|) in game data are escaped to prevent table breakage. - All fields use
N/Aconsistently — replaced mixed"","Unknown","No description"with uniformN/Afallback.
Changed
- Markdown table columns expanded: added Genre, Tags, Status, Platforms, Publisher, Release Date, Made With, Rating, Session, Languages, Inputs.
- README rewritten with updated architecture diagram, project structure, field documentation.
- Workflow action versions updated to
actions/checkout@v6andactions/setup-python@v6with Python 3.14.
[1.0.5] - 2026-01-12 (Hotfix 🔧)
Fixed
- UTF-8 decode issue when running
scripts/update_info.py. See #16.
[1.0.4] - 2026-01-11 (Added Games + New Features ⭐)
Added Games
Added 33 games. See #22 and #23.
New Features
- Delete game with correct link in
delete_game.py. See #20. - Export JSON →
.csv/.xlsxinexport_csv.py. See #21. - Check duplicate data in JSON file in
check_duplicate.py. See #19.
[1.0.3] - Date unknown (Improvements ⚙️)
Improved
- Optimized workflow scheduling.
[1.0.2] - Date unknown (Hotfix 🔧)
Fixed
temp_link.jsonnot resetting to[]after GitHub Actions run.
[1.0.1] - 2025-12-31 (Hotfix 🔧)
Fixed
- Rewrote and added 2 issue templates.
- Updated CONTRIBUTING.
[1.0.0] - 2025-12-28 (Initial Release 🚀)
Added
- Full curated list of free itch.io games with auto-daily updates via GitHub Actions.
- Scraping script (
update_info.py): add links → scrape title, dev, genre, description, NSFW flag, thumbnail. - MD table generator (
generate_md.py): split by genre, 300 max per file, in/lists/. - Columns: No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW.
temp_link.jsonfor easy manual adds (Actions process daily).- Full docs: DISCLAIMER, PRIVACY, TERMS, EULA, SECURITY, CODE_OF_CONDUCT, CONTRIBUTING, ACKNOWLEDGEMENTS.
- Issue and PR templates for bugs, features, and game submissions.
- Badges, TOC, and example table in README.
Fixed
- Multiple scrape bugs (itch.io HTML structure changes).
- Description length overflow → truncated to first sentence + "(see more on itch.io)".
- Table numbering resets per file, primary genre used for grouping.