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>
25 KiB
Danh sách Game Itch.io Miễn Phí
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-18 (English source revision 2026-09-18). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
Bản tiếng Anh tại
README.mdlà bản chính thức. Bản dịch tiếng Việt của các tài liệu chính sách nằm trongdocs/i18n/vi/.
Một danh mục được tuyển chọn và tự động cập nhật gồm hơn 2,600 game miễn phí trên itch.io. Duyệt tại https://freeitchgames.win: tìm kiếm, lọc, sắp xếp và mở thẳng trang itch.io của bất kỳ game nào. Website chỉ để xem, với tất cả mọi người: không tài khoản, không đăng nhập, không bình luận, không quảng cáo, không thanh toán.
Mục lục
- Duyệt danh mục
- Ứng dụng desktop và Android
- Thêm game
- Dữ liệu được cập nhật thế nào
- Bên trong dự án
- Cấu trúc dự án
- Tự động hóa
- Các trường dữ liệu
- Đóng góp
- Kết nối / hỗ trợ
- Giấy phép
- Pháp lý
Duyệt danh mục
Mọi thứ nằm trên website https://freeitchgames.win:
- Danh sách game: toàn bộ danh mục trong một bảng chạy nhanh (dạng thẻ trên điện thoại), lọc theo thể loại, nền tảng, trạng thái và nhiều thứ khác, cùng một trang chi tiết cho từng game.
- Biểu đồ: danh mục được chia ra sao, và đã lớn lên thế nào theo thời gian.
- Đã gỡ (Removed): mọi game bị loại khỏi danh mục, kèm lý do (https://freeitchgames.win/removed).
- Nội dung 18+ bị ẩn theo mặc định. Game được đánh dấu
nsfw: Yessẽ bị ẩn (kể cả ảnh bìa) trừ khi bạn tự bật trong Settings sau khi xác nhận mình đủ 18 tuổi. Lựa chọn đó chỉ được lưu trong trình duyệt của bạn.
Mọi link đều dẫn tới trang riêng của game trên itch.io. Ảnh bìa trên website là bản thu nhỏ do freeitchgames.win phục vụ, nên trình duyệt của bạn không kết nối tới itch.io cho tới khi bạn bấm vào một link.
Muốn lấy dữ liệu gốc? Đó là JSON thuần, nằm trong data_game/ của repo này và tại https://freeitchgames.win/data/index.json (cùng các file mà nó liệt kê). Vui lòng dùng các file đó thay vì cào (scrape) website; xem Giấy phép để biết bạn được tái sử dụng chúng thế nào.
(Địa chỉ cũ poli0981.github.io/free-games-itchio-list giờ chỉ chuyển hướng sang website mới. Các bảng markdown theo thể loại trong lists/ và file deleted_games.txt đã bị bỏ: danh mục giờ chỉ có trên web.)
Ứng dụng desktop và Android
Cùng một app cũng được phát hành dưới dạng ứng dụng native chỉ để xem, build bằng Tauri 2 từ cùng mã nguồn. Tải từ GitHub Release mới nhất:
| Nền tảng | File |
|---|---|
| Windows | Trình cài đặt .msi hoặc .exe |
| macOS | .dmg, .pkg hoặc .app.tar.gz (cần Safari/WebKit 16.4 trở lên) |
| Linux | .deb hoặc .AppImage |
| Android 11+ (arm64-v8a) | .apk (cài tay, xem bên dưới) |
Các app tải JSON danh mục từ https://freeitchgames.win/data và tải ảnh bìa trực tiếp từ CDN ảnh của itch.io (img.itch.zone); bấm vào một game sẽ mở itch.io trong trình duyệt của bạn. Không có telemetry. Cập nhật thủ công: khi có bản mới thì tải bản mới về. Cài app đồng nghĩa với việc chấp nhận EULA (EN).
Android (tải & cài đặt)
Không có trên Play Store: chỉ cần tải .apk về và cài tay (Android cho phép, chỉ hỏi xác nhận trước):
- Mở Release mới nhất và tải
FreeGamesItchio_<version>_arm64-v8a.apk. Chỉ cài APK từ trang đó: file được ký bằng khóa của dự án. - Bấm vào file. Android sẽ hỏi cho phép cài từ nguồn này (trình duyệt / trình quản lý file). Hãy bật lên (Cài đặt → Ứng dụng → Truy cập đặc biệt → Cài ứng dụng không xác định).
- Chấp nhận cảnh báo "không từ Play Store" và cài. Vẫn là app y hệt bản web/desktop.
Lưu ý: chỉ arm64-v8a (mọi điện thoại từ ~2017; không hỗ trợ máy chỉ chạy 32-bit), và Android 11+ (API 30). Phiên bản cũ hơn không cài được. Đây là cố ý: giữ mức tối thiểu ở phiên bản còn được gia cố bảo mật và là phiên bản bọn mình thật sự test (≈87% thiết bị đang hoạt động; lý do). Cách tự build có trong mục Android của webapp/TAURI.md.
Thêm game
Có ba cách để một game vào danh mục. Cả ba đều đi qua hàng chờ duyệt: không có gì được thêm cho tới khi Maintainer duyệt.
- Trang Suggest: https://freeitchgames.win/suggest. Dán link game itch.io và, nếu muốn, một ghi chú ngắn (tối đa 500 ký tự; ghi chú bị xóa sau 180 ngày). Một bước kiểm tra Cloudflare Turnstile và giới hạn tần suất giúp chặn spam. Vui lòng không ghi dữ liệu cá nhân vào ghi chú.
- Extension trình duyệt: itch-f2p-extension của chính Maintainer (repo riêng, GPL-3.0) gửi link qua một API có xác thực trong lúc duyệt itch.io.
- Tự động phát hiện: cứ 4 giờ một lần, website đọc một trong các RSS feed công khai của itch.io về game miễn phí mới và phổ biến (mỗi lượt một feed) rồi đưa những gì tìm được vào hàng chờ.
Maintainer duyệt hàng chờ trong một khu vực quản trị riêng (được bảo vệ bởi Cloudflare Access). Link được duyệt sẽ được chuyển cho pipeline dữ liệu, pipeline này cào từng trang game; game trả phí bị loại.
Thích dùng GitHub hơn, hoặc có cả một danh sách dài? Issue template "Add Games (bulk list)" cũng dùng được; các link đó đi qua cùng quy trình duyệt. Xem CONTRIBUTING.
Muốn gỡ một game, hoặc sửa dữ liệu của nó (nhất là các nhà phát triển game)? Gửi email tới takedown@freeitchgames.win hoặc mở issue "Remove a game". Ghi rõ URL game, bạn là ai (người tạo / chủ sở hữu quyền, hoặc người được họ ủy quyền) và lý do. Chi tiết: Điều khoản sử dụng và Tuyên bố miễn trừ.
Dữ liệu được cập nhật thế nào
Trang Suggest ─┐
Extension ─┼─→ hàng chờ duyệt ─→ Maintainer duyệt ─→ scripts/temp_link.json
RSS feed ─┘ (admin) │
▼
update.yml → update_info.py (game mới) ──┐
refresh.yml → refresh.py (1/7 mỗi ngày) ──┴─→ patch ─→ apply_patch.py
(validate + push)
│
freeitchgames.win/data ←── data_game/*.json
- Hàng chờ: link đã duyệt được GitHub App của dự án commit vào
scripts/temp_link.json(commit đã xác minh). - Ingest:
update.ymlchạyupdate_info.pyngay khi hàng chờ thay đổi (và mỗi ngày một lần để dự phòng). Mỗi link được chuẩn hóa, fetch, kiểm tra còn miễn phí không rồi cào dữ liệu; game trả phí, đã chết, trùng hoặc từng bị gỡ sẽ bị bỏ qua. Lỗi tạm thời được giữ lại trong hàng chờ để thử lại (tối đa 3 lượt chạy). - Refresh:
refresh.ymlmỗi ngày kiểm tra lại 1/7 danh mục (mỗi game một request), nên mọi game được kiểm tra lại hằng tuần: link chết (404/410), game chuyển sang trả phí, rating và trạng thái. Game chỉ bị gỡ khi cùng một vấn đề được thấy lại sau ít nhất 20 giờ. Việc gỡ được ghi kèm lý do trongscripts/deleted_games.json, và một lượt chạy định gỡ số game nhiều bất thường sẽ giữ chúng lại và cảnh báo thay vì gỡ. - Commit an toàn: cả hai bước xuất ra một patch theo URL;
apply_patch.pyáp nó lênmainmới nhất, validate mọi file dữ liệu (validate.py) rồi mới push, và thử lại nếu có tiến trình ghi khác push trước. - Xuất bản: mỗi lần push vào
mainsẽ build lại website, gói kèm danh mục tại https://freeitchgames.win/data.
Pipeline cư xử lịch sự với itch.io: nó tự xưng danh là FreeItchGamesBot/4.0 (+https://freeitchgames.win/about), giãn nhịp request và tuân thủ HTTP 429 / Retry-After. Chỉ các trang và feed công khai của itch.io được đọc.
Bên trong dự án
- Web app (
webapp/src/): React + TypeScript + Vite + Tailwind CSS, TanStack Query / Table / Virtual, React Router, Zustand. Giao diện tiếng Anh và tiếng Việt. - Cloudflare Worker (
webapp/worker/): phục vụ website và/data, proxy ảnh (/img, ảnh bìa WebP đã thu nhỏ lưu trên Cloudflare R2), API Suggest và ingest, hàng chờ duyệt (Cloudflare D1), API quản trị và lịch phát hiện qua RSS. Cấu hình:webapp/wrangler.jsonc. - App quản trị (
webapp/admin/): màn hình duyệt chỉ dành cho Maintainer tại/admin, đứng sau Cloudflare Access. Nó ghi vào repo này dưới danh nghĩa một GitHub App. - Vỏ native (
webapp/src-tauri/): Tauri 2 cho Windows, macOS, Linux và Android. Xemwebapp/TAURI.md. - Pipeline dữ liệu (
scripts/, Python 3.14): scraper, refresh, patch/apply và validate, chạy bằng GitHub Actions.
Việc deploy do Cloudflare Workers Builds đảm nhận (thư mục gốc webapp, npm run build, rồi npx wrangler deploy): mỗi lần push vào main sẽ tự động lên site.
Dev cục bộ nhanh (thiết lập đầy đủ, gồm Worker, secret và test, có trong docs/dev_env.md (VI)):
cd webapp
npm ci
npm run dev # http://localhost:5173 (Vite)
npm run build # ghi vào webapp/dist/ (Worker phục vụ thư mục này làm assets)
npx wrangler dev # terminal thứ hai: Worker ở cổng :8787; Vite chuyển tiếp /api và /img tới đó
npm run tauri:dev # cửa sổ desktop native (cần Rust)
Cấu trúc dự án
data_game/ # Danh mục (JSON chia khối, tối đa 500 game/file) + LICENSE.md (CC BY 4.0)
├── game_info_001.json
├── ...
├── index.json # Bảng kê các khối (tổng + số lượng từng file)
└── count_history.json # Tổng số theo ngày cho biểu đồ "số game theo thời gian"
scripts/
├── scraper.py # Dùng chung: HTTP session, giãn nhịp / lùi lại khi 429, nhận diện free, parse
├── data_store.py # Dùng chung: đọc/ghi theo khối (diff tối thiểu), index.json, count_history.json
├── canonical.py # Một dạng chuẩn duy nhất cho URL game itch.io
├── update_info.py # URL trong hàng chờ → patch (game mới)
├── refresh.py # Kiểm tra xoay vòng → patch (còn sống / trả phí / rating / trạng thái); --full cào lại
├── apply_patch.py # Áp patch lên main mới nhất, rồi validate
├── validate.py # Kiểm tra schema + tính nhất quán cho mọi file dữ liệu
├── temp_link.json # Hàng chờ ingest (link đã duyệt)
├── deleted_games.json # Nhật ký game đã gỡ kèm lý do (công khai)
└── state/ # Sổ sách của pipeline (lần kiểm tra cuối, strike, lần thử lại), không công khai
bash/commit_push.sh # fetch main → áp patch → validate → commit → push (có thử lại)
tests/ # Bộ test pytest (không dùng mạng) + fixture dùng chung với Worker
webapp/
├── src/ # App React (route, component, store, i18n)
├── admin/ # App quản trị chỉ dành cho Maintainer (/admin)
├── worker/ # Cloudflare Worker (dữ liệu, proxy ảnh, API, hàng chờ duyệt, phát hiện qua RSS)
├── src-tauri/ # Vỏ Tauri 2 (desktop + Android)
├── wrangler.jsonc # Cấu hình Cloudflare
└── TAURI.md # Ghi chú build desktop / Android
LICENSE # MIT (mã nguồn)
LICENSES/CC-BY-4.0.txt # Toàn văn pháp lý CC BY 4.0 (dữ liệu + tài liệu)
NOTICE.md # Bản đồ giấy phép, tuyên bố không liên kết, ghi công
docs/ # Chính sách, môi trường dev, danh sách bên thứ ba (+ bản tiếng Việt trong docs/i18n/vi/)
Tự động hóa
| Tác vụ | Lịch | Mục đích |
|---|---|---|
Ingest (update.yml) |
Khi hàng chờ đổi + hằng ngày 01:23 UTC | Cào link đã duyệt từ temp_link.json, bỏ qua game trả phí / đã chết / từng bị gỡ |
Refresh (refresh.yml) |
Hằng ngày 02:47 UTC | Kiểm tra lại 1/7 danh mục: link chết, game chuyển sang trả phí, rating, trạng thái |
Force update (force_update.yml) |
Thủ công | Cào lại mọi trường (một URL hoặc lô tiếp theo); giữ nguyên safe_virus / notes / nsfw |
| Phát hiện qua RSS (Cloudflare Worker) | Mỗi 4 giờ | Đọc một feed itch.io mỗi lượt; game mới vào hàng chờ duyệt |
| Python CI / Webapp CI | Pull request | Lint, test, validate dữ liệu / type-check, test, build |
| Deploy website | Khi push vào main |
Cloudflare Workers Builds (webapp/wrangler.jsonc) → freeitchgames.win |
| Release desktop / Android | Khi push tag v* |
Trình cài đặt Tauri (Win/macOS/Linux) và APK đã ký → draft Release |
Lỗi mạng được coi là tạm thời; game chỉ bị gỡ khi cùng lỗi 404/410 hoặc trạng thái trả phí được thấy lại ít nhất 20 giờ sau lần đầu. Lỗi, lượt bị hủy, bị giới hạn tốc độ và thay đổi hàng loạt đáng ngờ được báo về Discord của dự án dưới dạng thông báo tự động.
Các trường dữ liệu
Mỗi game trong data_game/game_info_NNN.json có 20 trường sau (cộng thêm dấu thời gian tùy chọn added_at / updated_at do pipeline thêm vào). Chỉ safe_virus, notes và nsfw do Maintainer quản lý; mọi thứ khác được cào từ trang itch.io công khai của game, và không lần cào lại nào ghi đè ba trường đó.
| Trường | Mô tả |
|---|---|
url |
URL trang game |
name |
Tên game |
dev |
Tên nhà phát triển / tác giả |
description |
Mô tả ngắn (câu đầu tiên, tối đa 200 ký tự) |
genre |
Thể loại theo itch.io |
tags |
Tất cả tag |
status |
Trạng thái phát hành |
platforms |
Nền tảng hỗ trợ (Windows, macOS, Linux, Web) |
publisher |
Nhà phát hành (nếu khác tác giả) |
release_date |
Ngày phát hành đầy đủ từ metadata của trang |
made_with |
Engine / công cụ sử dụng |
rating |
Điểm đánh giá trung bình (tổng hợp từ itch.io) |
rating_count |
Số lượt đánh giá |
average_session |
Thời lượng một phiên chơi điển hình |
languages |
Ngôn ngữ hỗ trợ |
inputs |
Cách điều khiển (bàn phím, chuột, tay cầm) |
nsfw |
Cờ 18+, Yes / No (được gợi ý từ tag, cảnh báo nội dung và mô tả khi thêm game; do Maintainer quản lý) |
safe_virus |
Ghi chú an toàn thủ công: ? (mặc định), Yes, No, Caution. Chỉ là ghi chú, không phải bảo đảm: file tải về không được quét |
notes |
Ghi chú thủ công |
thumbnail |
URL ảnh bìa (trên itch.io) |
Các trường được cào mặc định là N/A khi trang game không có thông tin.
Đóng góp
Xem CONTRIBUTING (tiếng Việt) để có hướng dẫn đầy đủ (bản chính thức: CONTRIBUTING.md).
- Thêm game: dùng trang Suggest.
- Gỡ game / sửa dữ liệu: gửi email tới takedown@freeitchgames.win hoặc mở issue "Remove a game".
- Báo lỗi: dùng issue template "Bug Report".
- Đề xuất tính năng: dùng template "Feature Request / Improvement", hoặc gửi PR.
- Vấn đề bảo mật: báo cáo riêng tư, đừng bao giờ mở issue công khai. Xem SECURITY (EN).
- Câu hỏi về quyền riêng tư: xem Chính sách quyền riêng tư (EN) hoặc gửi email tới privacy@freeitchgames.win.
- Vui lòng tuân thủ Quy tắc ứng xử (EN).
Người đóng góp được ghi nhận trong ACKNOWLEDGEMENTS.md.
Cấu hình máy + môi trường dev của Maintainer: docs/pc_spec.md (VI), docs/dev_env.md (VI).
Kết nối / hỗ trợ
Hai server Discord giờ đã tồn tại (câu "if I ever make one" chính thức lỗi thời):
- Chat: Discord: Repo discussion · Game chat
- Mạng xã hội: X/@SkullMute0011 · YouTube/@SkullMute · Bluesky · Mastodon
- Nhắn tin: Telegram (DM)
- Ủng hộ (hoàn toàn tùy chọn, giống
.github/FUNDING.yml): GitHub Sponsors · Patreon · Ko-fi · Buy Me a Coffee · PayPal - Gaming: Steam profile
DM mở ở mọi nơi; trả lời chậm (hướng nội max level). Trang About của website có cùng danh sách dưới dạng nút bấm.
Giấy phép
Repo này dùng ba giấy phép (bản đồ đầy đủ trong NOTICE.md):
| Phần nào | Giấy phép | File |
|---|---|---|
Mã nguồn: scripts/, webapp/, bash/, workflow, test, mọi thứ không liệt kê bên dưới |
MIT, Copyright (c) 2025-2026 poli0981 (SkullMute) | LICENSE |
Dữ liệu danh mục: data_game/, scripts/deleted_games.json và các file dẫn xuất tại https://freeitchgames.win/data |
CC BY 4.0, cho phần đóng góp của Maintainer (xem bên dưới) | data_game/LICENSE.md |
Tài liệu: các file *.md ở thư mục gốc repo và trong docs/ (README này, các chính sách) |
CC BY 4.0 | LICENSES/CC-BY-4.0.txt |
Giấy phép dữ liệu bao gồm: việc tuyển chọn và sắp xếp bộ sưu tập, ba trường do Maintainer viết (safe_virus, notes, nsfw), các bản ghi gỡ game, cùng cấu trúc và số liệu thống kê dẫn xuất.
Không bao gồm (thuộc sở hữu của người khác, dự án không cấp phép): mô tả game và mọi văn bản khác do người làm game viết, ảnh bìa / thumbnail và các phương tiện khác, tên game, logo và nhãn hiệu, cùng nhãn hiệu của itch.io. Các dữ kiện đơn thuần như URL, giá và điểm đánh giá vốn không được bảo hộ quyền tác giả.
Khi tái sử dụng dữ liệu, vui lòng ghi công như sau:
Free itch.io games catalog by poli0981 (SkullMute) — https://freeitchgames.win — CC BY 4.0
Các thành phần bên thứ ba giữ giấy phép riêng của chúng: xem docs/THIRD_PARTY.md và trang About của website. Extension trình duyệt là một repo riêng theo GPL-3.0. Đóng góp được nhận theo cùng giấy phép với phần mà nó thay đổi (inbound = outbound): MIT cho mã nguồn, CC BY 4.0 cho dữ liệu và tài liệu.
Không liên kết với itch.io. Đây là một dự án độc lập do người hâm mộ làm. Dự án không liên kết với, không được chứng thực hay tài trợ bởi itch.io, Leaf Corcoran hoặc itch corp. "itch.io" cùng mọi tên game, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng.
Pháp lý
Bản tiếng Việt nằm trong docs/i18n/vi/; bản tiếng Anh là bản chính thức cho mọi giải thích pháp lý.
- Điều khoản sử dụng (EN): áp dụng cho website và mọi thứ trên đó
- Chính sách quyền riêng tư (EN)
- Tuyên bố miễn trừ (EN)
- EULA (EN): chỉ áp dụng cho app desktop và Android
- Quy tắc ứng xử (EN)
- Chính sách bảo mật (Security Policy) (EN)
- NOTICE
Liên hệ (được chuyển tiếp tới Maintainer):
- Quyền riêng tư: privacy@freeitchgames.win
- Gỡ nội dung / bản quyền: takedown@freeitchgames.win
- Lỗ hổng bảo mật: security@freeitchgames.win (hoặc tính năng báo cáo lỗ hổng riêng tư của GitHub)
- Mọi vấn đề pháp lý khác: legal@freeitchgames.win