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 import your library from Steam, Trakt.tv, or RetroAchievements.

Main screen

Screenshots

All Items Collection Grid
All Items Collection Grid
Visual Board Item Details
Visual Board Item Details
Game Search Movie Search
Game Search Movie Search
Tier List Wishlist
Tier List Wishlist

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 Rank items into S/A/B/C tiers and export as PNG
Import Steam library, Trakt.tv history, RetroAchievements progress
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 Owned games, playtime, last played date
Trakt.tv Watch history, ratings, watchlist, episode progress
RetroAchievements Retro game library, achievement progress, awards
.xcollx files Collections shared by others

Import guides on Wiki

Data Sources

Type Source API Key
Games IGDB Built-in
Movies & TV TMDB Built-in
Visual Novels VNDB Not required
Anime AniList Not required
Manga AniList Not required
Artwork SteamGridDB Built-in
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 · RetroAchievements · SteamGridDB

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