Skip to content

Repository files navigation

🎌 MiyoList - Unofficial AniList Client

A modern, desktop AniList tracker built with Tauri 2 + Preact. Track your anime, manga and light novels with full offline support and automatic sync to your AniList account.

Track your anime & manga with style

Tech Stack Platform License

📦 Download🐛 Report Bug


✨ Why MiyoList?

MiyoList is an unofficial AniList client that elevates your anime and manga tracking with:

  • Lightning Fast UI: Built with Preact and Tauri 2 for minimal overhead and memory footprint.
  • 💾 Offline-First Storage: Full offline support with bundled SQLite database.
  • 🔄 Smart Queue Sync: Dirty-flag queue that automatically syncs to AniList when you're back online.
  • 📱 Cross-Platform Desktop: Native-feeling application for Windows, Linux, macOS, and Android.
  • 🖼️ Offline Cover Cache: Local cover image cache with prefetching to save bandwidth.
  • 🔔 System Integration: Native OS push notifications for your airing anime and new manga chapters (via MangaUpdates).
  • 🎵 OP/ED Themes: Play opening/ending themes right in the media panel (AnimeThemes.moe).
  • 🎮 Discord Rich Presence: Show what you're watching or reading in your Discord status.
  • 📊 Rich Statistics: Comprehensive totals, score histograms, and a 52-week activity heatmap.

🚀 Key Features

📊 Library & Tracking

  • ✅ Browse Anime, Manga, and Light Novel lists with advanced status filters and sorting.
  • ✅ Multiple view modes: Grid, Compact, and List.
  • ✅ Edit entries completely: status, score, episode/chapter/volume progress, dates, notes, and rewatch counters.
  • ✅ Instant sync to AniList, falling back to local queue if offline.

🔍 Discovery & Details

  • Global Search: Find media, characters, staff, studios, and AniList users easily.
  • Advanced Media Search: Filter by genre, tag, year, format, status, and adult content toggle.
  • Rich Media Panels: View banners, Markdown descriptions, tags, studios, and popularity metrics.
  • People & Studios: Dedicated detail panels with favorites tracking.

🔔 Stay Updated

  • Airing Schedule: Your watchlist grouped by day, complete with episode progress controls.
  • Native Notifications: OS push notifications alert you when new episodes air.
  • Manga Chapter Alerts: New-chapter notifications for your CURRENT/REPEATING manga via the MangaUpdates release indexer, with per-title mute switches.
  • Activity Log: View your last 100 list updates with relative timestamps.

🎵 Media & Extras

  • OP/ED Theme Player: In-panel playback of opening/ending themes from AnimeThemes.moe, with local favourite stars per theme.
  • Discord Rich Presence: "Watching/Reading <title>" status updates (desktop), with a per-media privacy override.

💻 Technology & Performance

  • Tauri 2 Foundation: Lightweight and secure desktop shell.
  • SQLite Backend: Handled via rusqlite—bundled and requires no external installs.
  • Seamless Auth: Localhost callback on port 43821 integrated with Windows Credential Manager.
  • Auto-Updater: Checks GitHub Releases once a day and installs updates from the About dialog.
  • Configurable Hotkeys: Rebindable keyboard shortcuts (navigation, search, sync, refresh).
  • Window Management: "Always on top" toggle and remembered window size/position.

📥 Installation

Quick Start

  1. Download the appropriate installer for your OS from GitHub Releases.
  2. Install and launch MiyoList.
  3. Sign in with your AniList account.
  4. Enjoy tracking your library natively!

Platforms

  • 🪟 Windows: .exe (NSIS), .msi, or portable .zip.
  • 🐧 Linux: AppImage, .deb, or .rpm.
  • 🍎 macOS: .dmg.
  • 🤖 Android: .apk.

🛠️ Tech Stack

Layer Technology
UI Preact 10 + TypeScript
Styling Tailwind CSS v4
Build Vite + Bun
Desktop shell Tauri 2
Database SQLite via rusqlite (bundled, no external install)
Auth AniList OAuth2 — localhost callback + Windows Credential Manager

🤝 Contributing

Contributions are welcome! We have moved the developer setup and architecture details to our contribution guide. Please check CONTRIBUTING.md for details on how to set up the development environment, run checks, and submit PRs.

  • 🐛 Report Bugs: Open an issue.
  • 💡 Suggest Features: Share your ideas.
  • 🔧 Submit PRs: Code contributions appreciated.
  • Star the Repo: Show your support!

📜 License

This project is licensed under the MIT License - see LICENSE for details.


⚠️ Disclaimer

MiyoList is an unofficial third-party client and is not affiliated with AniList. All anime/manga data is provided by the AniList API. Use at your own discretion and respect AniList's Terms of Service.


**Made with ❤️ by Baconana-chan**

⬆ Back to Top

About

A modern, desktop AniList tracker built with Tauri 2 + Preact. Track your anime, manga and light novels with full offline support and automatic sync to your AniList account.

Resources

Contributing

Stars

9 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages