docs: split the licence, correct the legal docs, add deployment and admin guides
The docs had drifted badly from the code. This makes them true. LICENCE SPLIT. Code stays MIT; the dataset moves to CC BY 4.0 in a new LICENSE-DATA, which is explicit about what the project cannot license: the `description` field is the publisher's own store blurb stored verbatim (median 213 characters), `header_image` is a URL to publisher artwork, and game names are trademarks used nominatively. Blanket-MIT over that material was a claim the project was never entitled to make. Facts — player counts, review percentages, platform support — are noted as unownable; the CC BY grant covers the compilation and the project's own derived fields. PRIVACY POLICY, rewritten rather than patched. The previous one said "no backend, no server-side log, no cookies, no server other than GitHub's CDN". Every clause of that is now false: the site runs on a Cloudflare Worker that processes IP and User-Agent and keeps operational logs. It also documents the one honest exception — the Activity page still calls api.github.com and loads GitHub avatars from the browser, so GitHub sees a visitor's IP there while no other page does — and lists every localStorage, IndexedDB and Cache Storage key with why it exists. SECURITY.md, rewritten. The old one claimed "no executable code, no dependencies, no backend, no user data" and said there was no contact address, while four other files publish one. It also told people to report vulnerabilities in public issues. There is now a real scope (the Worker, the proxies, D1, Actions secrets, the Tauri signing key), a private channel via GitHub's vulnerability reporting, and specific things worth probing. EULA corrected on two counts: it asserted a single MIT licence over everything, and claimed there is "no installable software" despite the signed desktop and Android builds. ToS and DISCLAIMER updated for the licence split, the new domain, and the removal of in-browser editing and GPG signing — the disclaimer described a signing flow that no longer exists. README contradictions fixed: 1.2k games -> 3,424 across 5 shards not 2, 11 workflows -> 24, two scripts listed that were never in the tree, a TanStack Table dependency the project does not use, and nine links to the old Pages URL. New: docs/DEPLOYMENT.md (how a push becomes a deploy, the two wrangler.jsonc fields that silently break it, and the stale-service-worker trap when verifying) and docs/ADMIN.md (Cloudflare Access plus the GitHub App, with the exact permission set — Contents write and Metadata only, and why Actions and Workflows are deliberately withheld). Two live fixes came out of writing this. GitHub Pages was serving a blank page: it had the new index.html, which references assets at `/`, while Pages serves under /free-steam-games-list/, so every asset 404'd — and deploy-pages.yml kept redeploying it. That workflow now publishes a redirect that preserves the #/ fragment, since Pages cannot issue a 301. And CI pinned Python at 3.11, 3.12 and 3.14 across different workflows while the docs claimed 3.12 was pinned; all fourteen references are now 3.12, which makes the claim true. TERMS_VERSION 1 -> 2, so everyone re-consents. A privacy policy that now discloses edge logging where it previously promised none is not a change to apply silently. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
29 files changed
+683
-184
No files matched your search
@@ -0,0 +1,39 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>Moved — Steam F2P Tracker</title>
|
||||
<link rel="canonical" href="https://free-steam-games.win/">
|
||||
<meta name="robots" content="noindex, follow">
|
||||
<style>
|
||||
body{margin:0;min-height:100vh;display:grid;place-items:center;background:#0b0e14;color:#e8eef7;
|
||||
font-family:Inter,system-ui,sans-serif;text-align:center;padding:24px}
|
||||
.card{max-width:460px}
|
||||
h1{font-size:20px;margin:.5em 0}
|
||||
p{font-size:14px;color:#98a4b8;line-height:1.6}
|
||||
a.btn{display:inline-block;margin-top:18px;padding:9px 22px;border-radius:10px;
|
||||
background:#22a3f1;color:#06121e;text-decoration:none;font-size:14px;font-weight:600}
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="card">
|
||||
<h1>This site has moved</h1>
|
||||
<p>Steam F2P Tracker now lives at <strong>free-steam-games.win</strong>.</p>
|
||||
<p id="fallback">Redirecting…</p>
|
||||
<a class="btn" href="https://free-steam-games.win/">Go to the new site</a>
|
||||
</div>
|
||||
<script>
|
||||
// GitHub Pages cannot issue a 301, so carry the deep link across in JS.
|
||||
// A meta-refresh would drop the #/... fragment, which is exactly the part
|
||||
// worth preserving: every old link into this app was a hash route.
|
||||
(function () {
|
||||
var hash = location.hash || "";
|
||||
var path = hash.replace(/^#\/?/, "");
|
||||
var target = "https://free-steam-games.win/" + (path ? "#/" + path : "");
|
||||
try { location.replace(target); }
|
||||
catch (e) { document.getElementById("fallback").textContent = "Open the link below."; }
|
||||
})();
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -75,7 +75,7 @@ jobs:
|
||||
if: matrix.language == 'python'
|
||||
uses: actions/setup-python@v6
|
||||
with:
|
||||
python-version: '3.14'
|
||||
python-version: '3.12'
|
||||
|
||||
- name: Initialize CodeQL
|
||||
uses: github/codeql-action/init@v4
|
||||
|
||||
@@ -1,11 +1,23 @@
|
||||
name: Deploy Web (GitHub Pages)
|
||||
|
||||
# This no longer deploys the app. The site moved to Cloudflare at
|
||||
# free-steam-games.win, and the app is built with base "/", so serving it from
|
||||
# the /free-steam-games-list/ Pages subpath produces a blank page — every asset
|
||||
# 404s. Rather than leave that live, Pages now serves a redirect.
|
||||
#
|
||||
# GitHub Pages cannot return a 301, so the redirect is client-side and
|
||||
# deliberately carries the #/... fragment across; old links into the app were
|
||||
# all hash routes.
|
||||
#
|
||||
# Once inbound traffic has drained, delete this workflow, delete
|
||||
# notify-deploy.yml (it listens for this workflow by name), and set
|
||||
# Settings -> Pages -> Source to None.
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
paths:
|
||||
- 'web/**'
|
||||
- 'data/**'
|
||||
- '.github/pages-tombstone/**'
|
||||
- '.github/workflows/deploy-pages.yml'
|
||||
workflow_dispatch:
|
||||
|
||||
@@ -19,40 +31,18 @@ concurrency:
|
||||
cancel-in-progress: false
|
||||
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
defaults:
|
||||
run:
|
||||
working-directory: web
|
||||
steps:
|
||||
- uses: actions/checkout@v5
|
||||
|
||||
- uses: actions/setup-node@v5
|
||||
with:
|
||||
node-version: '24'
|
||||
cache: 'npm'
|
||||
cache-dependency-path: web/package-lock.json
|
||||
|
||||
- name: Install
|
||||
run: npm ci || npm install
|
||||
|
||||
- name: Type check
|
||||
run: npm run typecheck
|
||||
|
||||
- name: Build
|
||||
run: npm run build
|
||||
|
||||
- name: Upload Pages artifact
|
||||
uses: actions/upload-pages-artifact@v4
|
||||
with:
|
||||
path: web/dist
|
||||
|
||||
deploy:
|
||||
needs: build
|
||||
runs-on: ubuntu-latest
|
||||
environment:
|
||||
name: github-pages
|
||||
url: ${{ steps.deployment.outputs.page_url }}
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Upload redirect page
|
||||
uses: actions/upload-pages-artifact@v4
|
||||
with:
|
||||
path: .github/pages-tombstone
|
||||
|
||||
- id: deployment
|
||||
uses: actions/deploy-pages@v5
|
||||
@@ -17,7 +17,7 @@ jobs :
|
||||
uses : actions/checkout@v6
|
||||
-
|
||||
uses : actions/setup-python@v6
|
||||
with : { python-version : '3.14' }
|
||||
with : { python-version : '3.12' }
|
||||
-
|
||||
run : chmod +x ./bash/ingest.sh && ./bash/ingest.sh
|
||||
env : { STEAM_API_KEY : '${{ secrets.STEAM_API_KEY }}' }
|
||||
@@ -31,7 +31,7 @@ jobs:
|
||||
|
||||
- uses: actions/setup-python@v5
|
||||
with:
|
||||
python-version: '3.11'
|
||||
python-version: '3.12'
|
||||
cache: 'pip'
|
||||
cache-dependency-path: requirements.txt
|
||||
|
||||
|
||||
@@ -14,7 +14,7 @@ jobs :
|
||||
uses : actions/checkout@v6
|
||||
-
|
||||
uses : actions/setup-python@v6
|
||||
with : { python-version : '3.14' }
|
||||
with : { python-version : '3.12' }
|
||||
-
|
||||
run : chmod +x ./bash/purge.sh && ./bash/purge.sh
|
||||
env : { STEAM_API_KEY : '${{ secrets.STEAM_API_KEY }}' }
|
||||
@@ -33,7 +33,7 @@ jobs :
|
||||
name : Setup Python
|
||||
uses : actions/setup-python@v6
|
||||
with :
|
||||
python-version : '3.14'
|
||||
python-version : '3.12'
|
||||
|
||||
-
|
||||
name : Force re-fetch all games
|
||||
|
||||
@@ -13,5 +13,5 @@ jobs:
|
||||
steps:
|
||||
- uses: actions/checkout@v6
|
||||
- uses: actions/setup-python@v6
|
||||
with: {python-version: '3.14'}
|
||||
with: {python-version: '3.12'}
|
||||
- run: chmod +x ./bash/daily.sh && ./bash/daily.sh
|
||||
@@ -12,6 +12,6 @@ jobs:
|
||||
steps:
|
||||
- uses: actions/checkout@v6
|
||||
- uses: actions/setup-python@v6
|
||||
with: {python-version: '3.14'}
|
||||
with: {python-version: '3.12'}
|
||||
- run: chmod +x ./bash/json.sh && ./bash/json.sh
|
||||
env: {STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'}
|
||||
@@ -14,6 +14,6 @@ jobs :
|
||||
uses : actions/checkout@v6
|
||||
-
|
||||
uses : actions/setup-python@v6
|
||||
with : { python-version : '3.14' }
|
||||
with : { python-version : '3.12' }
|
||||
-
|
||||
run : chmod +x ./bash/reviews.sh && ./bash/reviews.sh
|
||||
@@ -117,6 +117,13 @@ pnpm-debug.log*
|
||||
coverage/
|
||||
.nyc_output/
|
||||
|
||||
# F2P Tracker desktop app (Electron + Vite)
|
||||
app/dist/
|
||||
app/dist-electron/
|
||||
app/release/
|
||||
app/.vite/
|
||||
app/*.tsbuildinfo
|
||||
|
||||
# ========================
|
||||
# 6. MOBILE CROSS-PLATFORM
|
||||
# ========================
|
||||
|
||||
+6
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"account": {
|
||||
"id": "3e0dd49b61256c8ff9d0a47c671947a5",
|
||||
"name": "K30021424@gmail.com's Account"
|
||||
}
|
||||
}
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
# Authors
|
||||
|
||||
This file lives at the repo root so the author can be found without digging into the docs. The canonical handle map is also in [`username.txt`](username.txt) (machine-readable) and rendered in the web app's [About page](https://poli0981.github.io/free-steam-games-list/#/about).
|
||||
This file lives at the repo root so the author can be found without digging into the docs. The canonical handle map is also in [`username.txt`](username.txt) (machine-readable) and rendered in the web app's [About page](https://free-steam-games.win/#/about).
|
||||
|
||||
## Maintainer
|
||||
|
||||
|
||||
+2
-2
@@ -6,7 +6,7 @@ Want to help? Awesome — no strict rules, life's hard enough. Pick whichever pa
|
||||
|
||||
## Maintainer contact
|
||||
|
||||
The canonical handle list is in [`AUTHORS.md`](AUTHORS.md) at the repo root (mirror of [`username.txt`](username.txt) for human reading). Web-app version: <https://poli0981.github.io/free-steam-games-list/#/about>.
|
||||
The canonical handle list is in [`AUTHORS.md`](AUTHORS.md) at the repo root (mirror of [`username.txt`](username.txt) for human reading). Web-app version: <https://free-steam-games.win/#/about>.
|
||||
|
||||
> [!WARNING]
|
||||
> **Privacy first.** When sending your Telegram `user_id` (needed for the bot whitelist below), **DM the maintainer privately**. Do **not** post it in:
|
||||
@@ -38,7 +38,7 @@ Fill the form (checkboxes, dropdowns, short descriptions). The `Ingest from Issu
|
||||
|
||||
If you have repo write access:
|
||||
|
||||
1. Open <https://poli0981.github.io/free-steam-games-list/>.
|
||||
1. Open <https://free-steam-games.win/>.
|
||||
2. Settings → paste a Classic GitHub PAT (scopes: `repo` + `workflow`).
|
||||
3. Optionally unlock a GPG private key in Settings to sign commits → **Verified ✓** badges.
|
||||
4. Add via the `Add` page (single + JSON bulk) or edit/delete via the table drawers.
|
||||
|
||||
@@ -0,0 +1,72 @@
|
||||
# Data licence
|
||||
|
||||
This file covers the **dataset**: `data/**` and the generated tables in
|
||||
`games/**`.
|
||||
|
||||
Source code, configuration, scripts and documentation are covered separately by
|
||||
the MIT licence in [LICENSE](./LICENSE). The split exists because code and data
|
||||
are different kinds of work with different constraints — MIT is a software
|
||||
licence and says nothing useful about a compilation of facts.
|
||||
|
||||
---
|
||||
|
||||
## The licence
|
||||
|
||||
The dataset is licensed under
|
||||
**[Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/)**.
|
||||
|
||||
You may share and adapt it, including commercially, provided you give
|
||||
appropriate credit, link to the licence, and say whether you made changes.
|
||||
|
||||
Suggested attribution:
|
||||
|
||||
> Data from *Steam F2P Tracker* (github.com/poli0981/free-steam-games-list),
|
||||
> CC BY 4.0.
|
||||
|
||||
## What this licence does and does not cover
|
||||
|
||||
This is the important part, and it is easy to get wrong.
|
||||
|
||||
**What the project can license.** The selection, curation and arrangement of
|
||||
the catalogue, and the fields produced by this project's own work — the
|
||||
`genre` bucketing, `type_game`, `safe`, `anti_cheat` and `is_kernel_ac`
|
||||
judgements, `notes`, and the derived tables in `games/**`. That editorial
|
||||
effort is the project's contribution and is what CC BY 4.0 is being applied to.
|
||||
|
||||
**What the project does NOT own, and therefore cannot license:**
|
||||
|
||||
- **`description`** — the short blurb each publisher writes for its own Steam
|
||||
store page, stored verbatim. These are typically ~200 characters (median 213,
|
||||
longest 340 in the current dataset). They are reproduced here as short
|
||||
identifying quotations so a row is recognisable; copyright remains with the
|
||||
publisher. They are **excluded** from the CC BY grant.
|
||||
- **`header_image`** — a URL pointing at publisher artwork hosted on Valve's
|
||||
CDN. The dataset contains the address, never the image. The artwork itself is
|
||||
the publisher's.
|
||||
- **Game names, and Steam's own tag vocabulary** — names are trademarks of
|
||||
their respective owners and appear here nominatively, to identify the game.
|
||||
- **Anything reachable through `link`** — that is Valve's page, not ours.
|
||||
|
||||
**Facts are not owned by anyone.** Player counts, review percentages, release
|
||||
dates, platform and language support are facts. The CC BY grant applies to this
|
||||
project's compilation of them, not to the underlying facts, which nobody can
|
||||
license to you.
|
||||
|
||||
**EU database rights.** Where a *sui generis* database right subsists in this
|
||||
compilation, it is licensed on the same CC BY 4.0 terms.
|
||||
|
||||
## If you republish this data
|
||||
|
||||
Attribute the project, keep the caveats in
|
||||
[docs/DISCLAIMER.md](./docs/DISCLAIMER.md) visible to your users, and do not
|
||||
present the derived fields as authoritative — `genre`, `safe` and the
|
||||
anti-cheat flags are one person's best effort, not an audit. Re-deriving
|
||||
`description` from Steam yourself is safer than inheriting it from here.
|
||||
|
||||
## Not legal advice
|
||||
|
||||
This file was written by the maintainer, who is not a lawyer. It reflects a
|
||||
good-faith engineering judgement about what can honestly be licensed, made so
|
||||
that anyone reusing the data knows exactly where the boundaries are rather than
|
||||
finding a blanket MIT notice over material the project never owned. If you need
|
||||
certainty for a commercial use, get your own advice.
|
||||
@@ -1,19 +1,19 @@
|
||||
[](games/all-games_part1.md)
|
||||
[](games/all-games_part1.md)
|
||||
[](.github/workflows)
|
||||
[](games/top-online.md)
|
||||
[](https://github.com/poli0981/free-steam-games-list)
|
||||
[](https://poli0981.github.io/free-steam-games-list/)
|
||||
[](https://free-steam-games.win/)
|
||||
[](https://github.com/poli0981/free-steam-games-list/releases)
|
||||
[](https://github.com/poli0981/free-steam-games-list/releases)
|
||||
[](.github/workflows/purge-unhealthy.yml)
|
||||

|
||||
[](.github/FUNDING.yml)
|
||||
|
||||
A **curated list** of free-to-play games on Steam — now ~1,200 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).
|
||||
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://poli0981.github.io/free-steam-games-list/> with a virtualised 1.2k-row table, 12 charts, fuzzy search, faceted filters, owner-gated bulk edit/delete with **GPG-signed commits**, queue-based add (single + JSON bulk), CSV/JSON export, validation badges, command palette, PWA / offline cache, **vi/en i18n**, and per-game permalinks;
|
||||
- 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.
|
||||
|
||||
@@ -25,27 +25,27 @@ A **curated list** of free-to-play games on Steam — now ~1,200 of them — no
|
||||
|
||||
| Surface | URL |
|
||||
| -------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
||||
| 🌐 Web app | <https://poli0981.github.io/free-steam-games-list/> |
|
||||
| 🌐 Web app | <https://free-steam-games.win/> |
|
||||
| 🖥️ Desktop releases | [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases) (Win `.msi`, Mac `.dmg`, Linux `.AppImage`) |
|
||||
| 📱 Android APK | [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases) (sideload `.apk`, **Android 11+** — see [`docs/android-support.md`](docs/android-support.md)) |
|
||||
| 📋 All games (md) | [games/all-games_part1.md](games/all-games_part1.md) (sorted by reviews) |
|
||||
| 🏆 Top online (md) | [games/top-online.md](games/top-online.md) |
|
||||
| 🎯 Top offline (md) | [games/top-offline.md](games/top-offline.md) |
|
||||
| 🏷️ By genre | [games/](games/) — separate file per genre |
|
||||
| 📦 Raw data | [data/data_001.jsonl](data/data_001.jsonl) + [data/data_002.jsonl](data/data_002.jsonl) (sharded JSONL) |
|
||||
| 📦 Raw data | [data/data_001.jsonl](data/data_001.jsonl) … `data_005.jsonl` (5 sharded JSONL files) |
|
||||
| 📖 Index | [games/README.md](games/README.md) |
|
||||
| 🛠️ About | <https://poli0981.github.io/free-steam-games-list/#/about> (in-app) |
|
||||
| 🛠️ About | <https://free-steam-games.win/#/about> (in-app) |
|
||||
| 👤 Authors | [`AUTHORS.md`](AUTHORS.md) — maintainer + contact channels + AI-assistant disclosure |
|
||||
| 🤖 Telegram bot | [`@my_skull_bot`](https://t.me/my_skull_bot) — Scraper Info Game bot, see [`CONTRIBUTING.md`](CONTRIBUTING.md) |
|
||||
|
||||
### What's new in v3.0.0
|
||||
|
||||
<details>
|
||||
<summary><b>Web app at <code>poli0981.github.io/free-steam-games-list/</code></b></summary>
|
||||
<summary><b>Web app at <code>free-steam-games.win/</code></b></summary>
|
||||
|
||||
A React/Vite SPA hosted on GitHub Pages, fetching data live from `raw.githubusercontent.com`. Features:
|
||||
|
||||
- **Browse** — virtualised 1.2k-row table (TanStack Table + 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.
|
||||
- **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.
|
||||
@@ -86,7 +86,7 @@ npm run tauri:build # release binary into web/src-tauri/target/release/bundle
|
||||
|
||||
The Python pipeline that powered v2 is untouched and runs daily as before:
|
||||
|
||||
- Schema v2.2 (23 + manual fields per record), MIT-licensed, sharded data in `data/data_*.jsonl` (cap 800 records/shard, current total ~1,230) plus a `data/index.json` manifest.
|
||||
- Schema v2.2 (23 + manual fields per record), CC BY 4.0 (see [LICENSE-DATA](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](https://github.com/poli0981/free-steam-games-list-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.
|
||||
@@ -101,7 +101,7 @@ The Python pipeline that powered v2 is untouched and runs daily as before:
|
||||
.
|
||||
├── data/ # Sharded data (the source of truth)
|
||||
│ ├── data_001.jsonl # ≤ 800 records
|
||||
│ ├── data_002.jsonl # the rest
|
||||
│ ├── data_002.jsonl … 005 # the rest
|
||||
│ └── index.json # last_updated, totals, shard manifest
|
||||
│
|
||||
├── games/ # Auto-generated markdown tables
|
||||
@@ -127,8 +127,9 @@ The Python pipeline that powered v2 is untouched and runs daily as before:
|
||||
│ └── dist/ # build artefacts (PWA + desktop)
|
||||
│
|
||||
├── docs/ # Legal + acknowledgements + contact
|
||||
├── .github/workflows/ # 11 workflows: data pipeline + Pages + desktop release
|
||||
└── LICENSE # MIT
|
||||
├── .github/workflows/ # 24 workflows: data pipeline + CI + desktop/Android release
|
||||
├── LICENSE # MIT — code
|
||||
└── LICENSE-DATA # CC BY 4.0 — dataset
|
||||
```
|
||||
|
||||
</details>
|
||||
@@ -153,8 +154,6 @@ scripts/
|
||||
├── top_online.py # Live leaderboard with trends
|
||||
├── generate_tables.py # Markdown tables + genre files + index
|
||||
├── refetch_all.py # Force re-fetch ALL (manual only)
|
||||
├── migrate_schema.py # Upgrade old records to v2.1
|
||||
├── export_data.py # CSV export
|
||||
└── delete_game.py # Interactive delete
|
||||
```
|
||||
|
||||
@@ -219,13 +218,15 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
|
||||
- [CHANGELOG](CHANGELOG.md) — what changed in each version.
|
||||
- [CONTRIBUTING](CONTRIBUTING.md) — issue templates, web-app sign-in, Telegram bot flow, extension, manual fork.
|
||||
- [PC spec](docs/pc_spec.md) ([VI](docs/i18n/vi/pc_spec.md)) — maintainer's dev hardware + test devices.
|
||||
- [Dev environment](docs/dev_env.md) ([VI](docs/i18n/vi/dev_env.md)) — IDE, toolchains (Python 3.12 / Node ≥ 22 / Rust stable / Tauri 2), workflow.
|
||||
- [Dev environment](docs/dev_env.md) ([VI](docs/i18n/vi/dev_env.md)) — IDE, toolchains (Python 3.12 / Node 24 / Rust stable / Tauri 2), workflow.
|
||||
- [Tauri build](web/src-tauri/TAURI.md) — desktop build prerequisites + signing + auto-update.
|
||||
- [Telegram bot](docs/telegram-bot.md) — pointer to the external bot user guide + how it integrates with this repo.
|
||||
- [DISCLAIMER](docs/DISCLAIMER.md) — accuracy caveats, no-warranty, the broke-maintainer note.
|
||||
- [Terms of Use](docs/ToS.md) — usage agreement, contributions, governing law, **rules for sharing your Telegram `user_id`**.
|
||||
- [EULA](docs/EULA.md) — supplemental to the MIT licence.
|
||||
- [Privacy Policy](docs/PRIVACY_POLICY.md) — zero personal data collected by the site; **Telegram-bot data flow** documented separately.
|
||||
- [EULA](docs/EULA.md) — plain-language commentary on both licences.
|
||||
- [Privacy Policy](docs/PRIVACY_POLICY.md) — no accounts, no analytics, no tracking; what Cloudflare logs as the host, and the one page that still talks to GitHub.
|
||||
- [Deployment](docs/DEPLOYMENT.md) — how a push becomes a deploy, and how to verify or roll one back.
|
||||
- [Admin setup](docs/ADMIN.md) — Cloudflare Access and the GitHub App behind `/admin`.
|
||||
- [Acknowledgements](docs/ACKNOWLEDGEMENTs.md) — credits, AI assistants, third-party libraries.
|
||||
- [Third-party dev tooling](docs/THIRD_PARTY.md) — dead-code / lint / audit tools + the pre-publish check suite.
|
||||
- [Contact](docs/Contact.md) — where to find the maintainer.
|
||||
@@ -233,6 +234,6 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
|
||||
- [SECURITY](SECURITY.md) — vulnerability reporting.
|
||||
- [`web/README.md`](web/README.md) — stack details, per-phase changelog, build instructions.
|
||||
|
||||
Licensed under [MIT](LICENSE) — do whatever; keep the credit if you fork. Star if you find a hidden gem ✨
|
||||
Code is [MIT](LICENSE); the dataset is [CC BY 4.0](LICENSE-DATA) 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](../../actions) or the web app's Health page.
|
||||
+66
-13
@@ -1,20 +1,73 @@
|
||||
# SECURITY POLICY
|
||||
# Security policy
|
||||
|
||||
### Why does this even exist?
|
||||
This repo is literally just a Markdown list of free-to-play Steam games + some JSON maybe later. No executable code, no dependencies, no backend, no user data. The biggest security risk is probably adding a game with toxic chat or aggressive microtransactions.
|
||||
## What this project actually is
|
||||
|
||||
But hey, GitHub recommends it, and I'm paranoid enough after writing all those disclaimers.
|
||||
The previous version of this file said the repository was "just a Markdown
|
||||
list… no executable code, no dependencies, no backend, no user data." That was
|
||||
wrong on every count, so here is the real picture:
|
||||
|
||||
### Reporting a Vulnerability
|
||||
If you somehow find a "security issue" (like a broken link, a game that's actually paid now, or a listing that offends your soul):
|
||||
- Open an Issue with the title starting with "[SECURITY]" or something.
|
||||
- Describe it clearly: What game? What link? Why is it bad?
|
||||
- I'll fix it when I wake up from my nap (or when Grok reminds me).
|
||||
- a **Cloudflare Worker** serving the site, holding a D1 binding and — for the
|
||||
admin path — a credential that can write to this repository
|
||||
- a **React single-page app** with a few dozen npm dependencies
|
||||
- a **Tauri 2 desktop and Android app**, signed, with an auto-updater
|
||||
- a **Python pipeline** run by 24 GitHub Actions workflows, several holding
|
||||
secrets that can push to `main`
|
||||
|
||||
**Do NOT** report fake/malware links here expecting me to click them – that's on you, bro. Steam's client is your friend.
|
||||
There is genuinely something to attack here. Hence a real policy.
|
||||
|
||||
No bounties, no fame, no money – I'm broke. Just a "thanks" in the ACKNOWLEDGEMENTS if you're lucky.
|
||||
## Reporting
|
||||
|
||||
If it's actually serious (lmao unlikely), email... wait, I don't have one for this. Just open an issue.
|
||||
**Use GitHub's private vulnerability reporting**, which is enabled on this
|
||||
repository: *Security → Report a vulnerability*. It is private between you and
|
||||
the maintainer.
|
||||
|
||||
Thanks for keeping the list safe-ish. Peace out.
|
||||
If that does not work for you, email **lopop05905@proton.me**. (The old file
|
||||
claimed there was no contact address. There is; it is published in
|
||||
`AUTHORS.md`, `CONTRIBUTING.md`, `docs/Contact.md` and `username.txt`.)
|
||||
|
||||
**Please do not open a public issue for anything exploitable.** Public issues
|
||||
are fine for a dead link or a game that is no longer free — those are data
|
||||
problems, not security ones.
|
||||
|
||||
Useful report: what you did, what happened, why it matters, and how to
|
||||
reproduce. A proof-of-concept URL beats a paragraph of description.
|
||||
|
||||
## In scope
|
||||
|
||||
- The Cloudflare Worker (`web/worker/**`) — the data proxy, the image proxy,
|
||||
and anything reachable under `/api/*`
|
||||
- The `/admin` path and its Cloudflare Access gate
|
||||
- The D1 database and anything that writes to it
|
||||
- The GitHub Actions workflows, especially any path where untrusted input
|
||||
reaches a step that can push to `main`
|
||||
- The Tauri updater and its signing key
|
||||
- Dependency vulnerabilities that are actually reachable from shipped code
|
||||
|
||||
Things worth probing specifically: making `/img/*` fetch an origin that is not
|
||||
`shared.akamai.steamstatic.com` or `shared.fastly.steamstatic.com`; making
|
||||
`/api/data/*` return a path outside its allowlist; reaching admin
|
||||
functionality without an Access session.
|
||||
|
||||
## Out of scope
|
||||
|
||||
- Games in the list being bad, predatory, or full of microtransactions. Take it
|
||||
up with the developer.
|
||||
- Anything about Valve or Steam itself.
|
||||
- Missing security headers with no demonstrated impact, and scanner output
|
||||
pasted without a working exploit.
|
||||
- Denial of service by volume.
|
||||
- Social engineering of the maintainer.
|
||||
|
||||
## What to expect
|
||||
|
||||
One person, as a hobby, in a timezone that is probably not yours. A first reply
|
||||
usually within a week. Serious issues get fixed before they are discussed
|
||||
publicly; minor ones may sit for a while.
|
||||
|
||||
No bounty programme, no money — the disclaimers about the maintainer being
|
||||
broke are not a joke. Credit in `docs/ACKNOWLEDGEMENTs.md` if you want it.
|
||||
|
||||
## Supported versions
|
||||
|
||||
The deployed site and `main` are the only supported versions. Desktop and
|
||||
Android releases are supported at the latest tag only; there are no backports.
|
||||
+161
@@ -0,0 +1,161 @@
|
||||
# Admin setup
|
||||
|
||||
How the maintainer-only surface is wired: Cloudflare Access in front of
|
||||
`/admin`, and a GitHub App behind it so the Worker can commit to the
|
||||
repository.
|
||||
|
||||
Nothing here is needed to run or browse the site. The public app is read-only.
|
||||
|
||||
---
|
||||
|
||||
## Why a GitHub App rather than a token
|
||||
|
||||
The site previously kept a GitHub personal access token in the browser's
|
||||
localStorage on a public origin. That is gone. The replacement needs a
|
||||
credential that lives only on the server, and a GitHub App is the right shape:
|
||||
|
||||
| | Classic PAT | Fine-grained PAT | GitHub App |
|
||||
|---|---|---|---|
|
||||
| Expires silently | yes — this stalled the pipeline for a month in Aug 2026 | yes, max 366 days | **no** |
|
||||
| Scope | whole account | per-repo | per-repo, per-permission |
|
||||
| Credential at rest | the token itself | the token itself | a private key that mints 1-hour tokens |
|
||||
| Attribution in history | your account | your account | its own bot identity |
|
||||
|
||||
The App's private key never expires; the tokens it mints die in an hour. That
|
||||
removes the failure mode that already bit this project once.
|
||||
|
||||
---
|
||||
|
||||
## 1. Create the App
|
||||
|
||||
**GitHub → Settings → Developer settings → GitHub Apps → New GitHub App**
|
||||
(<https://github.com/settings/apps/new>)
|
||||
|
||||
| Field | Value |
|
||||
|---|---|
|
||||
| GitHub App name | `f2p-tracker-admin` (must be globally unique) |
|
||||
| Homepage URL | `https://free-steam-games.win` |
|
||||
| Webhook | **Uncheck "Active"** — the Worker calls GitHub, not the reverse |
|
||||
| Where can this be installed | **Only on this account** |
|
||||
|
||||
### Permissions
|
||||
|
||||
Under **Permissions → Repository permissions**, set exactly these and nothing
|
||||
else:
|
||||
|
||||
| Permission | Access | Why |
|
||||
|---|---|---|
|
||||
| **Contents** | **Read and write** | commit to `data/*.jsonl`, `data/index.json`, `scripts/temp_info.jsonl` |
|
||||
| **Metadata** | Read-only | mandatory; GitHub adds it automatically |
|
||||
|
||||
Leave everything else at **No access**. In particular:
|
||||
|
||||
- **Actions — not needed.** A push made with an App installation token *does*
|
||||
trigger workflows (unlike the built-in `GITHUB_TOKEN`), so committing to
|
||||
`scripts/temp_info.jsonl` starts `ingest-new.yml` on its own. Do not grant
|
||||
Actions write just to dispatch runs.
|
||||
- **Issues, Pull requests, Workflows — not needed.** The Worker only writes
|
||||
data files. Granting `Workflows` would let a compromised Worker rewrite
|
||||
`.github/workflows/**`, which is the single worst permission to hand out.
|
||||
|
||||
Click **Create GitHub App**.
|
||||
|
||||
## 2. Collect the credentials
|
||||
|
||||
On the App's settings page:
|
||||
|
||||
1. Note the **App ID** (a number near the top).
|
||||
2. **Private keys → Generate a private key.** A `.pem` file downloads. This is
|
||||
the credential — treat it like a password. GitHub keeps no copy; if you lose
|
||||
it, generate a new one and delete the old.
|
||||
|
||||
## 3. Install it on the repository
|
||||
|
||||
**Install App** in the left sidebar → your account → **Only select
|
||||
repositories** → `free-steam-games-list` → Install.
|
||||
|
||||
Then note the **Installation ID**, which is the trailing number in the URL of
|
||||
*Settings → Applications → Installed GitHub Apps → Configure*:
|
||||
`https://github.com/settings/installations/<INSTALLATION_ID>`.
|
||||
|
||||
## 4. Give the Worker the credentials
|
||||
|
||||
From `web/`:
|
||||
|
||||
```bash
|
||||
npx wrangler secret put GH_APP_ID
|
||||
npx wrangler secret put GH_APP_INSTALLATION_ID
|
||||
npx wrangler secret put GH_APP_PRIVATE_KEY
|
||||
```
|
||||
|
||||
For the private key, paste the **entire** `.pem` including the
|
||||
`-----BEGIN RSA PRIVATE KEY-----` and `-----END RSA PRIVATE KEY-----` lines.
|
||||
|
||||
Secrets set this way are encrypted at rest and are **not** in `wrangler.jsonc`,
|
||||
so they never reach the repository. Never put them in `vars`.
|
||||
|
||||
The Worker signs a short JWT with the private key, exchanges it for an
|
||||
installation token, and uses that token for about an hour before minting
|
||||
another.
|
||||
|
||||
## 5. Put Cloudflare Access in front of `/admin`
|
||||
|
||||
The App is only half of it — without Access, `/admin` is public.
|
||||
|
||||
**Cloudflare dashboard → Zero Trust → Access controls → Applications → Add an
|
||||
application → Self-hosted.**
|
||||
|
||||
| Field | Value |
|
||||
|---|---|
|
||||
| Application name | `f2p-tracker-admin` |
|
||||
| Session duration | 24 hours or less |
|
||||
| Domain | `free-steam-games.win`, path `admin` |
|
||||
|
||||
Add a second application for `free-steam-games.win/api/admin` so the API is
|
||||
covered too, not just the page.
|
||||
|
||||
**Policy:** Action *Allow*, rule *Emails* → your address. Access applications
|
||||
are deny-by-default, so everyone else gets the login screen and never reaches
|
||||
the Worker.
|
||||
|
||||
Zero Trust's free plan covers up to 50 users, which is 49 more than this needs.
|
||||
|
||||
### Two things that are easy to get wrong
|
||||
|
||||
- **`workers_dev` must stay `false`.** A zone-scoped Access policy does not
|
||||
cover `*.workers.dev`. If that hostname is live, `/admin` is reachable
|
||||
around Access, with the repo-write credential behind it.
|
||||
`web/wrangler.jsonc` already sets `workers_dev: false` — keep it that way.
|
||||
- **The Worker must verify the Access JWT itself.** Do not trust the path
|
||||
alone. Access forwards a `Cf-Access-Jwt-Assertion` header; the Worker
|
||||
validates it against the team JWKS and checks the `aud` claim. Belt and
|
||||
braces, because the cost of getting this wrong is repository write access.
|
||||
|
||||
Add a second Access identity (a backup email, or a one-time-PIN policy) before
|
||||
you rely on this. If you lock yourself out, the break-glass path is editing
|
||||
`data/*.jsonl` directly on github.com — which works precisely because Git, not
|
||||
D1, remains the source of truth.
|
||||
|
||||
## 6. The database
|
||||
|
||||
`f2p-admin` (D1, region APAC) already exists and is bound as `DB` in
|
||||
`web/wrangler.jsonc`. It holds the new-games queue, edit drafts and an audit
|
||||
log — never game records. Migrations live in `web/worker/migrations/` and are
|
||||
applied out of band:
|
||||
|
||||
```bash
|
||||
npx wrangler d1 migrations apply f2p-admin --remote
|
||||
```
|
||||
|
||||
Confirm the database is on a paid plan before depending on it: since
|
||||
2026-09-01, queries that exceed the free daily row limits **fail** rather than
|
||||
throttle, including the queries you would use to diagnose the problem.
|
||||
|
||||
---
|
||||
|
||||
## What is not built yet
|
||||
|
||||
The Access application, the GitHub App and the D1 tables are the prerequisites.
|
||||
The `/admin` UI, the queue schema and the approve-to-commit path are still to
|
||||
come; `/admin` currently returns 404 by design rather than serving the public
|
||||
app shell.
|
||||
@@ -0,0 +1,108 @@
|
||||
# Deployment
|
||||
|
||||
The site is a Cloudflare Worker serving a Vite build. Pushing to `main` is what
|
||||
deploys — there is deliberately no deploy workflow in `.github/workflows/`.
|
||||
|
||||
---
|
||||
|
||||
## How it fits together
|
||||
|
||||
```
|
||||
push to main
|
||||
└─> Cloudflare Workers Builds (root directory: web)
|
||||
npm ci → npm run build → wrangler deploy
|
||||
└─> Worker "free-steam-games-list"
|
||||
├─ static assets from web/dist
|
||||
├─ /api/data/* → proxies GitHub raw
|
||||
├─ /img/* → proxies Valve's CDN
|
||||
└─ /admin → Access-gated (not built yet)
|
||||
```
|
||||
|
||||
`web/wrangler.jsonc` is the only deployment config. Two fields in it are
|
||||
load-bearing and easy to break:
|
||||
|
||||
- **`name` must stay `free-steam-games-list`.** That is the Worker holding the
|
||||
`free-steam-games.win` custom domain. Deploying under any other name creates
|
||||
a second, domainless Worker and leaves the live site on the old build, with
|
||||
a completely green build log.
|
||||
- **`assets.directory` must be `./dist`, not `.`.** Pointing it at the source
|
||||
directory serves an unbuilt `index.html` that references `/src/main.tsx` —
|
||||
a blank page — and publishes the whole source tree. This happened.
|
||||
|
||||
## Data does not redeploy the site
|
||||
|
||||
The catalogue is proxied at `/api/data/*`, not built into `dist/`. A pipeline
|
||||
commit to `data/**` therefore changes the site's content without any rebuild.
|
||||
|
||||
Keep it that way. If the data ever moves into the build output, the Worker's
|
||||
build watch paths must include `data/**` — otherwise the site silently serves
|
||||
a frozen dataset with no error anywhere, and a health check that reads the repo
|
||||
rather than production will report green while it happens.
|
||||
|
||||
## Verifying a deploy
|
||||
|
||||
```bash
|
||||
curl -sI https://free-steam-games.win/ | head -3
|
||||
curl -s https://free-steam-games.win/ | grep -o '<html lang="[a-z]*"'
|
||||
curl -so /dev/null -w '%{http_code}\n' https://free-steam-games.win/api/data/data/index.json
|
||||
curl -so /dev/null -w '%{http_code} %{size_download}b\n' https://free-steam-games.win/img/t/570/header.jpg
|
||||
curl -so /dev/null -w '%{http_code}\n' https://free-steam-games.win/admin # expect 404
|
||||
```
|
||||
|
||||
The image should come back around 3–4 KB: the Worker prefers Steam's small
|
||||
capsule asset over the full header.
|
||||
|
||||
**A stale service worker will show you the old app after a deploy.** The site
|
||||
is a PWA, so a browser that visited before the deploy serves its cached shell
|
||||
until the service worker updates. If you are checking whether a deploy landed,
|
||||
use a fresh profile or a hard reload — otherwise you will diagnose a
|
||||
deployment problem that does not exist.
|
||||
|
||||
## Local development
|
||||
|
||||
```bash
|
||||
cd web
|
||||
npm ci
|
||||
npm run dev # Vite + HMR; /api/* and /img/* proxy to the live Worker
|
||||
npx wrangler dev # the real Worker against web/dist — required for worker/ changes
|
||||
```
|
||||
|
||||
`npm run dev` cannot exercise `worker/` source. It proxies those paths to
|
||||
production so the app has real data and images; changes under `web/worker/`
|
||||
need `wrangler dev`.
|
||||
|
||||
Stop `wrangler dev` before running `npm ci`. On Windows the install deletes
|
||||
`node_modules` and fails partway if a dev server holds files open.
|
||||
|
||||
## Checks
|
||||
|
||||
`.github/workflows/web-ci.yml` runs on pull requests and on pushes to `main`
|
||||
touching `web/**`: `npm ci`, both typechecks (app and Worker), the build,
|
||||
`wrangler deploy --dry-run`, and `knip`.
|
||||
|
||||
It uses a plain `npm ci`, never `npm ci || npm install`. That fallback is what
|
||||
hid a lockfile conflict which broke installs for a month.
|
||||
|
||||
## Rolling back
|
||||
|
||||
Roll back the Worker deployment in the Cloudflare dashboard
|
||||
(*Workers → free-steam-games-list → Deployments*). Reverting the commit also
|
||||
works but takes a full build cycle.
|
||||
|
||||
GitHub Pages is **not** a fallback. It now serves only a redirect to this
|
||||
domain; the app cannot run there because it is built with `base: "/"`.
|
||||
|
||||
## Secrets
|
||||
|
||||
`wrangler.jsonc` holds no secrets — only the D1 `database_id`, which is an
|
||||
account-scoped identifier and safe to commit. Anything sensitive goes through
|
||||
`npx wrangler secret put`. See [ADMIN.md](./ADMIN.md).
|
||||
|
||||
## Cost notes
|
||||
|
||||
Image transformations are **off** (`IMG_TRANSFORM: "false"`), so `/img/*` is a
|
||||
cached passthrough. Cloudflare Images bills separately from Workers Paid —
|
||||
5,000 unique transformations a month are free, and there is **no spend cap**.
|
||||
Measure real `/img/*` volume in Workers Logs before enabling them, and land an
|
||||
appid allowlist first: without one the endpoint can be pointed at any of
|
||||
Steam's ~200,000 apps at your expense.
|
||||
+4
-4
@@ -2,7 +2,7 @@
|
||||
|
||||
**This repository — including its data, scripts, web app, and documentation — is provided "AS IS" without warranty of any kind**, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, title, accuracy, completeness, and non-infringement. In no event shall the author(s) or copyright holder(s) be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the repository or the use or other dealings in its contents.
|
||||
|
||||
The MIT License (see [LICENSE](../LICENSE)) is the actual binding instrument. Everything below is supplemental — bullet points, not legalese — written so a human can understand the limits before relying on this list.
|
||||
Two licences are the binding instruments: [MIT](../LICENSE) for the code and [CC BY 4.0](../LICENSE-DATA) for the dataset. Everything below is supplemental — bullet points, not legalese — written so a human can understand the limits before relying on this list.
|
||||
|
||||
---
|
||||
|
||||
@@ -31,10 +31,10 @@ These are the known classes of error you should expect when relying on the data:
|
||||
The HTML scraper, Python ingest pipeline, and the web-app filters all assume Steam pages and their search/store responses are returned in English. Steam's regional storefronts (`store.steampowered.com/?cc=jp`, `&cc=de`, etc.) sometimes localise game titles, genre strings, language-support tables, and DLC descriptions. If you hit the data via a regional storefront — or if Steam silently changes its localisation behaviour — names, genres, language counts, and DLC flags can come back wrong. Run anything important against the canonical EN page.
|
||||
|
||||
3. **Test-data leakage.**
|
||||
While building the web app, the maintainer ran live edit / add / delete tests against the production repo. Some test commits bumped genre/notes/anti-cheat fields on real games, and a handful of "queue 1 game for ingest" entries may have introduced dummy rows that the daily pipeline later cleaned up. If a row looks like it was edited mid-test (default values, joke notes), file a [Bug Report](https://github.com/poli0981/free-steam-games-list/issues/new?template=bug_report.yml).
|
||||
While building the web app, the maintainer ran live edit / add / delete tests against the production repo. Some test commits bumped genre/notes/anti-cheat fields on real games, and a handful of "queue 1 game for ingest" entries may have introduced dummy rows that the daily pipeline later cleaned up. If a row looks like it was edited mid-test (default values, joke notes), file a [Bug Report](https://github.com/poli0981/free-steam-games-list/issues/new?template=bug_report.yml). In-browser editing was removed in September 2026, so this class of artefact is now closed — but historic rows were never audited.
|
||||
|
||||
4. **"Unsigned" commits in `Activity` are mostly dev artefacts.**
|
||||
The web app signs commits via the maintainer's OpenPGP key only when the key is unlocked in the browser session. Many commits that landed during development happened with the key locked — they show as `unsigned` rather than `Verified ✓`. They are not malicious; they're just lock-state artefacts. If you depend on Verified-only commits for trust, filter to Verified in the activity feed.
|
||||
The web app used to sign commits with the maintainer's OpenPGP key, held in the browser, and only when that key was unlocked for the session. Plenty of commits landed with it locked, so they show as `unsigned` rather than `Verified ✓`. They are not malicious — just lock-state artefacts. That signing path was removed in September 2026 along with in-browser editing, so the mix of signed and unsigned history is now frozen as it stands. Commits from the automated pipeline have always been unsigned. If you depend on Verified-only commits for trust, filter accordingly in the activity feed.
|
||||
|
||||
5. **Anti-cheat assessments come from regex over text.**
|
||||
`anti_cheat`, `is_kernel_ac`, and `anti_cheat_note` are populated by matching known AC names (VAC, EAC, BattlEye, Vanguard, …) against the Steam page text. If a game ships an AC under a vendor-renamed brand or only mentions it in a launcher EULA, the field will be `-`. Cross-check before relying on this for kernel-driver risk decisions.
|
||||
@@ -57,6 +57,6 @@ Whenever the maintainer remembers, plus whatever the GitHub Actions cron schedul
|
||||
|
||||
---
|
||||
|
||||
This project is licensed under the MIT License — see the [LICENSE](../LICENSE) file. The MIT text already includes broad disclaimer language; this file restates and extends it because (a) accuracy caveats deserve their own section, and (b) paranoia is free.
|
||||
Code is MIT ([LICENSE](../LICENSE)); the dataset is CC BY 4.0 with carve-outs ([LICENSE-DATA](../LICENSE-DATA)). Both include broad disclaimer language; this file restates and extends it because (a) accuracy caveats deserve their own section, and (b) paranoia is free.
|
||||
|
||||
Last updated: whenever the maintainer remembered.
|
||||
+52
-34
@@ -1,55 +1,73 @@
|
||||
# END USER LICENSE AGREEMENT (EULA)
|
||||
# END USER LICENCE AGREEMENT
|
||||
|
||||
**Short version:** the entire repository — data, scripts, web app, and docs — is licensed under the [MIT License](../LICENSE). The MIT text is the actual binding instrument. This file is supplemental commentary in plain language.
|
||||
**Short version:** two licences, not one. The code is
|
||||
[MIT](../LICENSE); the dataset is [CC BY 4.0 with carve-outs](../LICENSE-DATA).
|
||||
Where either licence conflicts with anything below, the licence text wins.
|
||||
|
||||
There is no installable software, no executable, no SaaS contract, no subscription, no telemetry. The "product" is a Markdown / JSONL list of free-to-play Steam games plus a static, client-side web app that reads it. By accessing, viewing, forking, starring, cloning, redistributing, or otherwise interacting with this repository or the deployed Pages site, you agree to the terms below.
|
||||
This file is plain-language commentary. It is not a separate contract that
|
||||
grants or removes rights.
|
||||
|
||||
---
|
||||
|
||||
### 1. Governing licence
|
||||
### 1. What you are actually getting
|
||||
|
||||
The MIT License governs everything. Read [`LICENSE`](../LICENSE) — it is short and unambiguous. If anything in this EULA conflicts with the MIT text, the MIT text wins.
|
||||
Three things, and they are not the same:
|
||||
|
||||
### 2. Nature of the work
|
||||
- **A dataset** of free-to-play Steam games, in `data/` and `games/`.
|
||||
- **A website** at <https://free-steam-games.win> that reads it. Read-only:
|
||||
browse, search, filter, chart, export. There is no account and no sign-in.
|
||||
- **Optionally, an installable app** — a desktop and Android build of the same
|
||||
interface, signed, with an auto-updater that checks GitHub Releases.
|
||||
|
||||
You are not "using" software in the traditional sense. You are reading a curated list and, optionally, viewing it through a static client-side web app. There is no backend, no server-side processing of your data, no account.
|
||||
The previous version of this file said there was "no installable software."
|
||||
That was never true of the desktop and Android builds, and is corrected here.
|
||||
|
||||
### 3. Your responsibilities
|
||||
### 2. Licences
|
||||
|
||||
- Play games from the list at your own risk. Steam's own [Subscriber Agreement](https://store.steampowered.com/subscriber_agreement/) and [refund policy](https://store.steampowered.com/steam_refunds/) govern your relationship with Valve and the game developers.
|
||||
- Do not blame the maintainer if a game is bad, predatory, addictive, riddled with microtransactions, has a kernel-level anti-cheat that conflicts with your system, or any other complaint that is fundamentally about the game and not about this list.
|
||||
- Do your own malware / safety due diligence. The `safe` and `anti_cheat` columns are best-effort signals from a single person, not audited output.
|
||||
- If you fork the repository or build a derivative work, the MIT terms travel with you. Attribute appropriately.
|
||||
- Source code, scripts, configuration and docs: **MIT** ([LICENSE](../LICENSE)).
|
||||
- The dataset: **CC BY 4.0** ([LICENSE-DATA](../LICENSE-DATA)), with explicit
|
||||
exclusions. Read that file before redistributing data — some fields are not
|
||||
the project's to license, notably `description` (publisher store copy) and
|
||||
`header_image` (a URL to publisher artwork).
|
||||
|
||||
### 4. Maintainer's responsibilities
|
||||
### 3. What you agree to by using it
|
||||
|
||||
- The maintainer commits to nothing. There is no SLA, no uptime guarantee, no roadmap obligation, no support contract, no response-time promise.
|
||||
- The pipeline runs daily under GitHub Actions on a best-effort basis. Workflow runs may fail, be paused, or be re-architected without notice.
|
||||
- You use the list at your own risk, and your relationship with any game is
|
||||
between you, Valve and that game's developer. Steam's
|
||||
[Subscriber Agreement](https://store.steampowered.com/subscriber_agreement/)
|
||||
governs that, not this.
|
||||
- You will not treat the derived fields as authoritative. `genre`, `safe`,
|
||||
`anti_cheat` and `is_kernel_ac` are one person's best effort. Details in
|
||||
[DISCLAIMER.md](./DISCLAIMER.md).
|
||||
- If you redistribute, you carry the correct licence for the part you are
|
||||
redistributing and keep the caveats visible.
|
||||
|
||||
### 5. Accuracy notice (incorporated by reference)
|
||||
### 4. What the maintainer commits to
|
||||
|
||||
[`DISCLAIMER.md`](./DISCLAIMER.md) lists specific known-error classes — genre best-effort, English-language assumption, test-data leakage, unsigned-commit artefacts, AC regex limits, sampled player counts, manual safe-flag scope. Read it before relying on any individual data point.
|
||||
Nothing. No SLA, no uptime guarantee, no support, no roadmap, no promise the
|
||||
pipeline runs tomorrow. It is a hobby project maintained by one person and it
|
||||
has already gone weeks at a time without updating.
|
||||
|
||||
### 5. The installable app
|
||||
|
||||
The desktop and Android builds are signed and update themselves from GitHub
|
||||
Releases. Install them only from this project's Releases page. Nobody else's
|
||||
build is this project's build, whatever it claims.
|
||||
|
||||
### 6. Trademarks
|
||||
|
||||
- **Steam**, the **Steam logo**, **Steam Store**, **Steam Community**, **Valve Anti-Cheat**, **VAC**, and related marks are trademarks of Valve Corporation. Their use here is descriptive / nominative; the project is independent and not affiliated with, endorsed by, or sponsored by Valve.
|
||||
- **GitHub** and the **GitHub Actions** marks are trademarks of GitHub, Inc.
|
||||
- All other game titles, developer names, publisher names, and logos in the data are property of their respective owners. Their inclusion is descriptive (the same way a directory or review aggregator names games) and does not imply endorsement.
|
||||
**Steam**, the Steam logo, **Valve**, **VAC** and related marks belong to Valve
|
||||
Corporation. Game names and artwork belong to their publishers. All are used
|
||||
here nominatively, to identify what a row refers to. This project is
|
||||
independent and is not affiliated with, endorsed by, or sponsored by Valve or
|
||||
any publisher listed.
|
||||
|
||||
### 7. Termination
|
||||
### 7. Warranty and liability
|
||||
|
||||
If you breach the MIT License, your rights under it terminate per the licence text. The maintainer additionally reserves the right to ignore disputes, decline pull requests, and laugh at cease-and-desist letters that are addressed to a hobby project on a public GitHub repo.
|
||||
None, to the extent the law allows. See [DISCLAIMER.md](./DISCLAIMER.md) and
|
||||
the warranty clauses in both licence files.
|
||||
|
||||
### 8. Governing law
|
||||
### 8. Changes
|
||||
|
||||
Vietnam, plus whatever the MIT License + GitHub Terms of Service require. The maintainer is not a lawyer; this document is not legal advice.
|
||||
|
||||
### 9. Changes
|
||||
|
||||
This document may be updated to reflect actual project changes. Continued access after an update means you accept the new version. Diffs are visible in the repo's commit history.
|
||||
|
||||
---
|
||||
|
||||
If you are a lawyer reading this for a real reason: I'd rather you open an issue than draft a letter. Open-source maintainers respond better to GitHub mentions than to certified mail.
|
||||
|
||||
Last updated: whenever the maintainer remembered.
|
||||
This file is versioned in git. Material changes bump `TERMS_VERSION` in the
|
||||
app, which re-prompts everyone rather than quietly swapping the terms.
|
||||
+91
-54
@@ -1,87 +1,124 @@
|
||||
# PRIVACY POLICY
|
||||
|
||||
**Effective date:** whenever this file was first committed (see git history). Updates are documented in commit log.
|
||||
**Applies to:** the website at <https://free-steam-games.win>, the repository at
|
||||
<https://github.com/poli0981/free-steam-games-list>, and the desktop / Android
|
||||
app built from it.
|
||||
|
||||
### Short version
|
||||
|
||||
This repository and the static Pages site at <https://poli0981.github.io/free-steam-games-list/> collect **no personal data on the maintainer's side**.
|
||||
|
||||
There is no backend, no server-side log, no analytics SDK, no advertising tracker, no fingerprinting library. Everything happens client-side in your browser, against either GitHub's API or `raw.githubusercontent.com`.
|
||||
**Last substantive change:** September 2026, when the site moved from GitHub
|
||||
Pages to Cloudflare and sign-in was removed. See git history for the exact diff.
|
||||
|
||||
---
|
||||
|
||||
### What the maintainer does NOT collect
|
||||
## Short version
|
||||
|
||||
- No accounts, sign-ups, or sessions on this side.
|
||||
- No analytics. No Google Analytics, Plausible, Fathom, etc.
|
||||
- No cookies set by this domain.
|
||||
- No advertising / behavioural-ad tracking.
|
||||
- No fingerprinting.
|
||||
- No server-side request logging — there is no server other than GitHub's CDN.
|
||||
- No data sent to third-party SDKs.
|
||||
The site does not ask who you are. There are no accounts, no sign-in, no
|
||||
analytics, no advertising, and no tracking cookies.
|
||||
|
||||
### What runs in your browser
|
||||
It is not, however, "serverless" any more, and the previous version of this
|
||||
document said things that are no longer true. The site is now served by a
|
||||
Cloudflare Worker, which means a server does sit between you and the page, and
|
||||
that server keeps operational logs. This document says exactly what that
|
||||
involves.
|
||||
|
||||
The static web app fetches:
|
||||
## What runs the site
|
||||
|
||||
- `https://raw.githubusercontent.com/poli0981/free-steam-games-list/main/data/*.jsonl` — the game data.
|
||||
- `https://api.github.com/...` — only when the user signs in with their own GitHub PAT for editing/adding/deleting. Never from anonymous visitors.
|
||||
- `https://shared.akamai.steamstatic.com/store_item_assets/.../header.jpg` — Steam game header images. Each `<img>` tag emits an HTTP GET to Akamai; Akamai's standard CDN logs apply.
|
||||
- `https://avatars.githubusercontent.com/...` — the signed-in user's avatar, only when authenticated.
|
||||
**Cloudflare** serves every request. Like any CDN or web server, Cloudflare
|
||||
processes your IP address, User-Agent and the URL you asked for in order to
|
||||
deliver the page, and retains operational and security logs under its own
|
||||
policy. Cloudflare acts as a processor for the site; see the
|
||||
[Cloudflare Privacy Policy](https://www.cloudflare.com/privacypolicy/).
|
||||
|
||||
These third-party endpoints have their own privacy policies and may log your IP / User-Agent according to their terms:
|
||||
The maintainer does not run any additional logging, does not have
|
||||
Cloudflare Web Analytics enabled, and does not export logs anywhere.
|
||||
|
||||
- **GitHub** — [Privacy Statement](https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement).
|
||||
- **Akamai** — see Steam's [Privacy Policy](https://store.steampowered.com/privacy_agreement/) (Akamai is Steam's CDN).
|
||||
**No cookies are set by this site.** Cloudflare may set its own operational
|
||||
cookies for security purposes; those are Cloudflare's, not the site's.
|
||||
|
||||
### What stays local in your browser
|
||||
## What the page loads
|
||||
|
||||
The web app uses three local-storage mechanisms:
|
||||
Game data and artwork are fetched **same-origin**, through the site itself:
|
||||
|
||||
1. **`localStorage`** — your GitHub PAT (only if you sign in), your selected GPG key (encrypted by the key's own passphrase), your theme + auto-lock preferences. Nothing is uploaded.
|
||||
2. **IndexedDB** — a cache of the JSONL records keyed on `data/index.json.last_updated`, so reloads are fast. Nothing is uploaded.
|
||||
3. **Service Worker cache** — the app shell + the last-known data shards, for offline browsing. Nothing is uploaded.
|
||||
- `/api/data/*` — the catalogue. The Worker fetches these files from GitHub on
|
||||
the server side, so your browser never contacts GitHub for them and GitHub
|
||||
does not see your IP.
|
||||
- `/img/*` — game artwork. The Worker fetches it from Valve's CDN on the server
|
||||
side, so Valve does not see your IP either.
|
||||
|
||||
You can clear all of the above at any time via your browser's site-data settings ("Clear site data" works fully).
|
||||
That is a deliberate change: previously your browser fetched data from GitHub
|
||||
and images from Valve's CDN and a third-party image proxy directly.
|
||||
|
||||
### What the *editing* path actually sends
|
||||
### The exceptions, stated plainly
|
||||
|
||||
Only when you sign in and edit, add, or delete:
|
||||
**The Activity page** (`/activity`) is the one part of the site that still
|
||||
talks to a third party from your browser. It calls the public GitHub commits
|
||||
API and loads contributor avatars from `avatars.githubusercontent.com`. If you
|
||||
open that page, GitHub sees your IP address and User-Agent. Every other page
|
||||
does not. If that matters to you, do not open it.
|
||||
|
||||
- Your PAT goes only to `api.github.com`, never anywhere else.
|
||||
- The commits you make are public on the repo and visible to anyone — that is by design. Author and committer email come from your GPG key's user ID (when unlocked) or from GitHub's noreply email format (when the key is locked). The web app never alters these without your input.
|
||||
**The desktop and Android apps** additionally check the GitHub Releases API on
|
||||
launch to see whether an update exists. Same exposure, same reason.
|
||||
|
||||
### Telegram bot (opt-in contribution channel)
|
||||
GitHub's handling is covered by the
|
||||
[GitHub Privacy Statement](https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement).
|
||||
|
||||
If you choose to contribute games via the **Scraper Info Game bot** ([`@my_skull_bot`](https://t.me/my_skull_bot)) instead of GitHub issues, the following data is exchanged:
|
||||
## What is stored on your device
|
||||
|
||||
- **What you give the maintainer**: your Telegram numeric `user_id` (sent privately, never via public channels — see [`CONTRIBUTING.md`](../CONTRIBUTING.md)).
|
||||
- **Where it's stored**: in a private allowlist file on the maintainer's local machine (the bot runs in Docker on the maintainer's box, ~2–5 hrs/day). The allowlist is **not** committed to this public repository.
|
||||
- **What the bot then sees**: the messages you send it (Steam URLs + any manual-field overrides you specify in the conversation flow). Telegram itself stores the chat per its own [Privacy Policy](https://telegram.org/privacy).
|
||||
- **What ends up public**: only the resulting game records (links + Steam-derived metadata) appear in `data/*.jsonl`. The author/committer of the resulting commit is `github-actions[bot]`, not your Telegram handle. Your `user_id` never appears in the repo.
|
||||
- **What you can ask for**: removal from the allowlist (DM the maintainer; processing time depends on Docker uptime). Removal blocks future bot use; previously-ingested games stay in the dataset under MIT licence as they are unattributed contributions.
|
||||
All of it stays on your device. None of it is transmitted anywhere.
|
||||
|
||||
**Maintainer's commitment**:
|
||||
- The Telegram `user_id` you share is treated as confidential. It is never published, never shared with third parties, and never logged into the public repo.
|
||||
- Public Discord, public Telegram groups, and GitHub issues are **not** acceptable channels for sharing your `user_id` — the maintainer will refuse to record IDs that arrived via those channels and will ask you to re-send privately.
|
||||
- Other personal information (real name, email, location, demographics) should not be sent at all. The bot does not need it.
|
||||
| Where | Key | Why |
|
||||
|---|---|---|
|
||||
| localStorage | `f2p:legal_consent` | that you accepted the terms, and which version |
|
||||
| localStorage | `f2p:welcome_seen` | that you have seen the introduction |
|
||||
| localStorage | `f2p:theme` | light / dark / system |
|
||||
| localStorage | `f2p:lang` | interface language |
|
||||
| sessionStorage | `f2p:chunk-reload` | one-shot flag so a failed script load retries once |
|
||||
| IndexedDB | `f2p:records`, `f2p:index` | the catalogue, cached so the site works offline and does not re-download ~6 MB each visit |
|
||||
| Cache Storage | `workbox-precache-*`, `f2p-data-v3`, `f2p-img-v1` | the offline app shell, data and images |
|
||||
|
||||
### LLM / AI
|
||||
Clearing site data in your browser removes all of it. Doing so re-shows the
|
||||
consent gate and the introduction, and the catalogue downloads again.
|
||||
|
||||
About 70 % of the code in this repo was generated with help from Grok (v1) and Claude (v2+). Those LLM calls happen on the maintainer's development machine — never from your browser. No user data is sent to any AI service at runtime.
|
||||
## The admin area
|
||||
|
||||
### Children
|
||||
An admin area exists at `/admin`, gated by Cloudflare Access. It is for the
|
||||
maintainer. If you are not signed in through Access it returns 404 and sets
|
||||
nothing.
|
||||
|
||||
This is a directory of free-to-play Steam games. Steam itself has age-rating guidance per game; consult that before letting minors install anything found here. The maintainer does not moderate game content for age-appropriateness.
|
||||
When the maintainer signs in there, Cloudflare Access sets a `CF_Authorization`
|
||||
cookie **on that session only**, and administrative actions are recorded in a
|
||||
Cloudflare D1 database — what was changed, when, and by which Access identity.
|
||||
That log exists so a bad change can be traced. It records no visitor data,
|
||||
because visitors never reach it.
|
||||
|
||||
### Changes
|
||||
## What is not collected
|
||||
|
||||
If anything in this policy changes (it probably won't), the diff is in the repo commit history.
|
||||
No accounts. No analytics or telemetry of any kind. No advertising or
|
||||
behavioural profiles. No fingerprinting. No session recording. No email list.
|
||||
No sale or sharing of anything, because there is nothing to sell or share.
|
||||
|
||||
### Contact
|
||||
Sign-in was removed entirely in September 2026. The site previously stored a
|
||||
GitHub access token and an encrypted signing key in your browser; it no longer
|
||||
has any mechanism to do so. If you used the old version, clearing site data
|
||||
removes any leftovers.
|
||||
|
||||
Open an issue or use any of the channels listed in [`Contact.md`](./Contact.md). Privacy-specific questions: tag the issue `privacy`.
|
||||
## Your rights
|
||||
|
||||
---
|
||||
Since the site holds no personal data about you, there is nothing to export or
|
||||
delete on this end — clearing your browser storage is the complete picture.
|
||||
|
||||
The maintainer has no server, no backend, and no commercial motive to collect user data — and is not interested in starting now.
|
||||
For the operational logs Cloudflare keeps as processor, requests go to
|
||||
Cloudflare under their policy. If you want to raise something directly, the
|
||||
contact address is in [docs/Contact.md](./Contact.md). The maintainer is one
|
||||
person running this as a hobby, so expect a slow, human reply rather than a
|
||||
formal privacy desk.
|
||||
|
||||
## Children
|
||||
|
||||
The site is a catalogue of games and is not directed at children. It collects
|
||||
nothing from anyone, of any age.
|
||||
|
||||
## Changes
|
||||
|
||||
This file is versioned in git. Material changes bump `TERMS_VERSION` in the
|
||||
app, which re-prompts everyone at the consent gate rather than quietly
|
||||
substituting new terms.
|
||||
+6
-6
@@ -1,6 +1,6 @@
|
||||
# TERMS OF USE
|
||||
|
||||
By accessing, forking, contributing to, mirroring, scraping, or otherwise using this repository (`free-steam-games-list`) or the deployed Pages site, you agree to these Terms of Use, the [MIT License](../LICENSE), and the supplemental [Disclaimer](./DISCLAIMER.md). The MIT text governs in case of conflict.
|
||||
By accessing, forking, contributing to, mirroring, scraping, or otherwise using this repository (`free-steam-games-list`) or the site at <https://free-steam-games.win>, you agree to these Terms of Use, the two licences that cover this project — [MIT](../LICENSE) for the code and [CC BY 4.0](../LICENSE-DATA) for the dataset — and the supplemental [Disclaimer](./DISCLAIMER.md). The licence texts govern in case of conflict.
|
||||
|
||||
---
|
||||
|
||||
@@ -18,7 +18,7 @@ You acknowledge the following:
|
||||
|
||||
1. **Genre is heuristic.** The genre column is derived from Steam tags + a description-text parser. Hybrids, indie experiments, and non-traditional titles are frequently mis-bucketed. Use the `tags` array for the unfiltered set.
|
||||
2. **English-only assumptions.** The scraper, ingest pipeline, and web app assume Steam responses come back in English. Regional storefronts can return localised strings that break parsing. Names, genres, language-support tables, and DLC flags can be wrong for non-EN sessions. Compare against the canonical EN store page before acting on the data.
|
||||
3. **Test data may have leaked in.** During web-app development, the maintainer ran live edit / add / delete tests against the production repo. Some rows may carry test artefacts; the daily pipeline cleans most of these up but stragglers exist.
|
||||
3. **Test data may have leaked in.** During web-app development the maintainer ran live edit / add / delete tests against the production repo, so some rows may carry test artefacts. The daily pipeline cleans most of these up but stragglers exist. In-browser editing was removed in September 2026, so no new artefacts of this kind can appear.
|
||||
4. **`unsigned` Activity entries are dev artefacts.** Many commits during development were made while the GPG key was locked. They are not malicious — just unsigned. If you require Verified-only trust, filter the Activity feed accordingly.
|
||||
5. **Anti-cheat detection is regex-based.** `anti_cheat` / `is_kernel_ac` are populated by matching known AC names against page text; rebrands and launcher-only mentions are missed.
|
||||
6. **Player counts are sampled.** `current_players` and `peak_today` lag by minutes-to-hours.
|
||||
@@ -29,14 +29,14 @@ See [`DISCLAIMER.md`](./DISCLAIMER.md). Short version: the maintainer is not res
|
||||
|
||||
### 5. Contributions
|
||||
|
||||
Pull requests are welcome but optional to merge. By submitting a contribution you license it under the same MIT terms as the rest of the repo. Don't include code or data you don't have the right to share.
|
||||
Pull requests are welcome but optional to merge. By submitting a contribution you license it under whichever licence covers the part you touched — MIT for code, CC BY 4.0 for data. Don't include code or data you don't have the right to share.
|
||||
|
||||
#### 5.1 Sharing personal information when contributing
|
||||
|
||||
For the Telegram-bot contribution path ([`@my_skull_bot`](https://t.me/my_skull_bot), see [`CONTRIBUTING.md`](../CONTRIBUTING.md)):
|
||||
|
||||
1. **Your Telegram `user_id` must be sent via a private channel only** — Telegram DM, email, or any 1-on-1 chat. Posting it in public Discord channels, public Telegram groups, GitHub issues, or any other public surface is forbidden by these Terms; the maintainer will reject IDs that arrived via public channels and ask for a re-send.
|
||||
2. **You retain control of your data.** The maintainer's allowlist is local and unpublished. You can request removal at any time via the same private channels. Removal blocks future bot use; previously-ingested game records remain in the public dataset since they are unattributed Steam-link submissions and form part of the curated MIT-licensed list.
|
||||
2. **You retain control of your data.** The maintainer's allowlist is local and unpublished. You can request removal at any time via the same private channels. Removal blocks future bot use; previously-ingested game records remain in the public dataset since they are unattributed Steam-link submissions and form part of the curated dataset, which is CC BY 4.0.
|
||||
3. **No other personal information should be transmitted.** The bot needs only your `user_id`. Real names, addresses, payment info, government IDs, biometric data, or any sensitive personal data should NOT be sent — the maintainer is a hobbyist with no infrastructure for handling them, and the bot does not request them.
|
||||
4. **Public-channel discussion of `user_id`s is a security issue.** If you accidentally post a Telegram `user_id` (yours or anyone else's) in a public channel of this project, edit/delete it immediately and notify the maintainer via DM. The maintainer will assist with cleanup but cannot recall messages already mirrored by third parties.
|
||||
|
||||
@@ -49,11 +49,11 @@ These rules are non-negotiable: they protect contributors from doxxing and the m
|
||||
|
||||
### 7. Forking, mirroring, derivative works
|
||||
|
||||
Allowed under the MIT terms. Carry the licence text with you and attribute the original repo. If you build something that financially benefits from the list, you are not obligated to share the proceeds — but a "thanks" via [Ko-fi / Patreon](https://ko-fi.com/skullmute) is appreciated.
|
||||
Allowed. Carry the right licence with you — MIT for code, CC BY 4.0 for data, and read [LICENSE-DATA](../LICENSE-DATA) for the fields the project cannot license to you — and attribute the original repo. If you build something that financially benefits from the list, you are not obligated to share the proceeds — but a "thanks" via [Ko-fi / Patreon](https://ko-fi.com/skullmute) is appreciated.
|
||||
|
||||
### 8. No commercial drama
|
||||
|
||||
You can fork and modify; the maintainer can't help if your downstream project blows up, gets DMCA'd, or has a launch-day disaster. The MIT licence's no-warranty clause covers this.
|
||||
You can fork and modify; the maintainer can't help if your downstream project blows up, gets DMCA'd, or has a launch-day disaster. The no-warranty clauses in both licences cover this.
|
||||
|
||||
### 9. Updates
|
||||
|
||||
|
||||
+2
-2
@@ -7,6 +7,6 @@ patreon, ko-fi: skullmute
|
||||
steam profile: https://steamcommunity.com/profiles/76561199544666292/
|
||||
bluesky: https://bsky.app/profile/skullmute0011.bsky.social
|
||||
mastodon instance: https://mastodon.social/@skullmute1122
|
||||
telegram bot: @my_skull_bot (Scraper Info Game bot — see CONTRIBUTING.md)
|
||||
telegram user: @SkullMute0011
|
||||
telegram bot: @my_skull_bot or QR (in `assets/qr`, file untracked)
|
||||
telegram user: @SkullMute0011 or QR
|
||||
email: lopop05905@proton.me
|
||||
@@ -3,11 +3,11 @@
|
||||
"title": "Before you continue",
|
||||
"intro": "By using this site you accept and agree to be bound by the documents below. Open any of them to read the full text.",
|
||||
"docsLabel": "Legal documents",
|
||||
"checkboxLabel": "I have read and accept the License, EULA, Privacy Policy, Disclaimer, and Terms of Use.",
|
||||
"checkboxLabel": "I have read and accept the code licence, the data licence, the EULA, the Privacy Policy, the Disclaimer, and the Terms of Use.",
|
||||
"continue": "Continue",
|
||||
"decline": "Decline",
|
||||
"declinedTitle": "You need to accept the terms",
|
||||
"declinedBody": "You must accept the License, EULA, Privacy Policy, Disclaimer, and Terms of Use to use F2P Tracker.",
|
||||
"declinedBody": "You must accept the licences, EULA, Privacy Policy, Disclaimer, and Terms of Use to use F2P Tracker.",
|
||||
"back": "Back"
|
||||
},
|
||||
"welcome": {
|
||||
|
||||
@@ -3,11 +3,11 @@
|
||||
"title": "Trước khi tiếp tục",
|
||||
"intro": "Khi sử dụng trang này, bạn chấp nhận và đồng ý tuân thủ các văn bản dưới đây. Bấm vào từng mục để đọc toàn văn.",
|
||||
"docsLabel": "Văn bản pháp lý",
|
||||
"checkboxLabel": "Tôi đã đọc và chấp nhận License, EULA, Chính sách bảo mật, Tuyên bố miễn trừ và Điều khoản sử dụng.",
|
||||
"checkboxLabel": "Tôi đã đọc và chấp nhận giấy phép mã nguồn, giấy phép dữ liệu, EULA, Chính sách quyền riêng tư, Tuyên bố miễn trừ và Điều khoản sử dụng.",
|
||||
"continue": "Tiếp tục",
|
||||
"decline": "Từ chối",
|
||||
"declinedTitle": "Bạn cần chấp nhận điều khoản",
|
||||
"declinedBody": "Bạn phải chấp nhận License, EULA, Chính sách bảo mật, Tuyên bố miễn trừ và Điều khoản sử dụng để dùng F2P Tracker.",
|
||||
"declinedBody": "Bạn phải chấp nhận các giấy phép, EULA, Chính sách quyền riêng tư, Tuyên bố miễn trừ và Điều khoản sử dụng để dùng F2P Tracker.",
|
||||
"back": "Quay lại"
|
||||
},
|
||||
"welcome": {
|
||||
|
||||
@@ -17,7 +17,8 @@ export interface LegalDoc {
|
||||
}
|
||||
|
||||
export const LEGAL_DOCS: LegalDoc[] = [
|
||||
{ label: "MIT License", path: "LICENSE", hint: "the actual binding terms — short and friendly", consent: true },
|
||||
{ label: "MIT License (code)", path: "LICENSE", hint: "covers the source code", consent: true },
|
||||
{ label: "Data Licence (CC BY 4.0)", path: "LICENSE-DATA", hint: "covers the dataset, and names what it cannot cover", consent: true },
|
||||
{ label: "Disclaimer", path: "docs/DISCLAIMER.md", hint: "no warranty, accuracy caveats, liability shrug", consent: true },
|
||||
{ label: "Terms of Use", path: "docs/ToS.md", hint: "what you agree to by using the repo / site", consent: true },
|
||||
{ label: "EULA", path: "docs/EULA.md", hint: "redundant with MIT but exists for paranoia", consent: true },
|
||||
|
||||
@@ -536,9 +536,11 @@ export function AboutPage() {
|
||||
trademarks of Valve Corporation. This site is not affiliated with
|
||||
Valve.
|
||||
<br />
|
||||
Steam header images served from Akamai (
|
||||
<code>shared.akamai.steamstatic.com</code>). Public-key search for
|
||||
commit verification uses <code>api.github.com</code>.
|
||||
Game data and artwork are served from this site, which fetches
|
||||
them from GitHub and Valve's CDN server-side — your browser
|
||||
does not contact either. The Activity page is the exception: it
|
||||
calls <code>api.github.com</code> and loads avatars from GitHub
|
||||
directly. See the Privacy Policy for the full picture.
|
||||
</div>
|
||||
</CardContent>
|
||||
</Card>
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
/**
|
||||
* Legal consent state: whether the user has accepted the current version of
|
||||
* the terms. Persisted to localStorage (no backend, no cookie — same pattern
|
||||
* as f2p:theme / f2p:lang / f2p:gpg_*). Incognito tabs get a fresh storage
|
||||
* as f2p:theme / f2p:lang / f2p:welcome_seen). Incognito tabs get a fresh storage
|
||||
* partition, so the gate naturally re-shows there with zero extra code.
|
||||
*/
|
||||
import { create } from "zustand";
|
||||
@@ -12,7 +12,11 @@ const KEY = "f2p:legal_consent";
|
||||
* Bump this whenever the binding legal documents change materially. A stored
|
||||
* acceptance for an older version no longer counts, so everyone is re-prompted.
|
||||
*/
|
||||
const TERMS_VERSION = 1;
|
||||
// 2 (Sept 2026): the licence split, and a Privacy Policy that now discloses
|
||||
// edge logging where the previous one claimed there was no server at all.
|
||||
// That is a material change, so everyone re-consents rather than being
|
||||
// silently moved onto different terms.
|
||||
const TERMS_VERSION = 2;
|
||||
|
||||
interface StoredConsent {
|
||||
version: number;
|
||||
|
||||
Reference in new issue
Block a user