Skip to content

hacan359/tonkatsu_box

Repository files navigation

Tonkatsu Box

Tonkatsu Box

Your personal collection manager for games, movies, TV shows, anime, visual novels, and manga

Windows Linux Android

Tests License: MIT Flutter 3.38+ Discord


Warning

This app is in active development. Updates may include database migrations that change data format. Please create a backup before updating (Settings → Backup → Create Backup). Alternatively, you can manually copy the app data folder:

  • Windows: %APPDATA%\Roaming\Tonkatsu Box\Tonkatsu Box
  • Android: use the built-in backup feature (Settings → Backup)

Tonkatsu Box is a free, open-source app to organize your media collections. Search millions of titles from IGDB, TMDB, VNDB, and AniList. Track your progress, rate everything, create visual boards and mood grids, and import your library from Steam, Trakt.tv, RetroAchievements, MyAnimeList, or AniList.

Main screen

Screenshots

Collections Collection Grid
Collections Collection Grid
Bulk Selection Item Details
Bulk selection Item Details
Game Search Add to Collection
Game Search Add to collection
Settings Search Sources
Settings Search Sources
Tier List Mood Grid
Tier List Mood grid

Features

Collections Organize by platform, genre, or any way you like. Grid, list, and table views
Search IGDB (games), TMDB (movies/TV), AniList (anime & manga), VNDB (visual novels)
Progress Tracking Status, ratings 1-10, episode tracking for TV shows and anime
Discord Rich Presence Show what you're playing/watching/reading in Discord (desktop)
Visual Boards Drag-and-drop canvas with posters, notes, and connections
Tier Lists & Mood Grids Rank items into S/A/B/C tiers, or arrange them on a visual N×M board with labels — export either as PNG
Import Steam library, Trakt.tv history, RetroAchievements progress, MyAnimeList XML, AniList by username
Export & Share .xcoll / .xcollx files with full offline support
Gamepad Navigate with Xbox controller
Languages English & Russian

Download

Platform Link
Windows Download .exe
Linux Download .AppImage
Android Download .apk

Linux support is experimental.

Quick Start

  1. Download and install from the links above
  2. Launch the app — Welcome Wizard guides you through setup
  3. Start adding items from Search, or import ready-made collections

The app works offline after setup. API keys are built-in.

Full guide on Wiki

Ready-made Collections

Tonkatsu Collections — 25,000+ games across 23 platforms, top movies, TV shows & anime. Download .xcollx → Import → Done.

Import Your Data

Already tracking elsewhere? Bring your data:

Source What's imported
Steam Steam Owned games, playtime, last played date
Trakt.tv Trakt.tv Watch history, ratings, watchlist, episode progress
RetroAchievements RetroAchievements Retro game library, achievement progress, awards
MyAnimeList MyAnimeList Anime and manga lists with scores, status and progress from an XML export
AniList AniList Anime and manga directly by a public username — no API key required
📦 .xcollx files Collections shared by others

Import guides on Wiki

Data Sources

Type Source API Key
IGDB Games IGDB Built-in
TMDB Movies & TV TMDB Built-in
VNDB Visual Novels VNDB Not required
AniList Anime & Manga AniList Not required
SteamGridDB Artwork SteamGridDB Built-in
ScreenScraper Retro media gallery ScreenScraper Required (user account)
RetroAchievements Achievements RetroAchievements Required

API Keys Setup

Platform Support

Feature Windows Linux Android
Collections & search
Progress tracking
Visual boards
Tier lists
Import (Steam/Trakt/RA)
VGMaps browser
Gamepad
Discord Rich Presence

Documentation

Building from Source

git clone https://github.com/hacan359/tonkatsu_box.git
cd tonkatsu_box
flutter pub get
flutter run -d windows  # or linux / android

Requires Flutter 3.38+. See CONTRIBUTING.md for details.

Community

Contributing

Contributions welcome! See CONTRIBUTING.md for build instructions, code style, and PR guidelines.

Credits

Data: IGDB · TMDB · VNDB · AniList · MyAnimeList · RetroAchievements · SteamGridDB · ScreenScraper

This product uses the TMDB API but is not endorsed or certified by TMDB.

License

MIT

About

Free open-source app to organize collections of retro games, movies, TV shows & anime. Track progress, rate favorites, create visual boards, share with friends. Flutter · Windows · Android · Linux

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages