About this project

Miraru (anime-tracker) is a desktop application, with a backend in Python/FastAPI and SQLite, designed to manage a personal library of anime, series, and movies. The frontend is HTML/CSS/JS without frameworks and is packaged with PyInstaller to offer a portable executable or a Windows installer. Search and sources: it integrates eight anime sources (AniList, Jikan v4, Kitsu, Crunchyroll, AnimeFLV, AnimePlanet, AnimeAV1, and MAL), which can be queried separately or all at once. For non-anime movies and series, it uses TMDB data. The search engine shows a preview before adding a record. Organization: it allows custom lists, favorites, season, rating, and notes; grid or compact table view; quick star rating from the card; drag and drop between lists; multiple selection for bulk actions (status, list, favorite, delete). Interface and productivity: command palette with Ctrl+K, keyboard shortcuts (/, Esc, N), search operators like genre:, score:, eps:, year:, or fav:, and an undo snackbar when deleting for five seconds. Discovery: each record includes a trailer, platforms where to watch it, and similar titles (AniList). There are statistics with a donut chart, genre pills, and time to complete; a news section with upcoming episodes and currently airing anime; a weekly calendar with reminders for the day's episodes; a "Continue watching" widget and marathon mode; automatic recommendations by favorite genres; and web notifications for new episodes. Sync and mobile: it offers optional synchronization with Google Sheets and mobile access via local WiFi through an installable PWA, activatable with a PIN from the PC. The interface is available in Spanish, English, French, and German, with light and dark mode. Installation: for users, there is a portable executable (Miraru-Portable.exe) that does not require Python and saves data next to the file, or an installer (Miraru-Setup.exe) with shortcuts. There are also manifests for publishing on Scoop or winget. To run from source code, just use Miraru.vbs, which locates Python, installs dependencies, and opens the browser; it can also be started manually with launcher.py or main.py. The executables are generated automatically when pushing a tag via GitHub Actions, or locally with compilar.bat and build.py --portable. MIT license.