https://github.com/bonkedbythonk/anicat
The specialized media companion for macOS and Windows. Stream anime, read manga, and sync progress with AniList in one minimalist dashboard.
https://github.com/bonkedbythonk/anicat
anilist anime anime-scraper anime-streaming anime-tracker desktop-app fastapi macos manga media-center nextjs python react self-hosted tauri
Last synced: 11 days ago
JSON representation
The specialized media companion for macOS and Windows. Stream anime, read manga, and sync progress with AniList in one minimalist dashboard.
- Host: GitHub
- URL: https://github.com/bonkedbythonk/anicat
- Owner: bonkedbythonk
- License: gpl-3.0
- Created: 2026-05-02T00:33:23.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-06-12T23:02:46.000Z (12 days ago)
- Last Synced: 2026-06-13T00:20:51.860Z (12 days ago)
- Topics: anilist, anime, anime-scraper, anime-streaming, anime-tracker, desktop-app, fastapi, macos, manga, media-center, nextjs, python, react, self-hosted, tauri
- Language: TypeScript
- Homepage:
- Size: 36.6 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
Anicat
Stream, track, and organize anime and manga — a native desktop app powered by AniList.
---
## Quick Install
Paste in Terminal:
```bash
curl -fsSL https://raw.githubusercontent.com/bonkedbythonk/anicat/master/scripts/install_macos.sh | bash
```
---
## Features
- **Stream & Playback** — External mpv player with Anime4K upscaling and AniSkip, or embedded HLS player. Multi-provider fallback, sub/dub server selection, HLS proxy.
- **Manga Reader** — Read chapters with three viewing modes (single, double, vertical scroll), RTL/LTR support, keyboard navigation, and AniList progress sync.
- **AniList Sync** — Full library sync: progress, scores, list status. Watched episodes auto-register on mpv close. Inline editing in the detail drawer.
- **Download Queue** — Background downloader via yt-dlp with real-time progress. Browse and play offline library.
- **Schedule** — 7-day airing calendar with live countdowns. Filter to your watching list.
- **Discovery** — Home dashboard with configurable rows (trending, seasonal, airing today, continue watching, smart picks). Search with filters. Notification feed from AniList.
- **Discord Rich Presence** — Shows what you're watching in your Discord status.
- **Skins** — Three UI styles: Neon Abyss (default), Sakura Zen (serif), Retro Manga (Bangers + Japanese sans-serif).
- **Nightly Builds** — Early-access features. Switch via Settings → Update Branch.
## Branches
| Branch | Use |
|--------|-----|
| `master` | Stable releases. Tested, reviewed, ready for daily use. |
| `nightly` | Latest features and fixes. May be less stable. |
## Building from Source
```bash
git clone https://github.com/bonkedbythonk/anicat.git
cd anicat/web
npm install
npm run tauri dev
```
Requires Rust, Node.js, system deps for [Tauri v2](https://v2.tauri.app/start/prerequisites/), and `mpv` (`brew install mpv`).
## Dependencies
| Dependency | Purpose |
|-----------|---------|
| [AniList](https://anilist.co) | Library, tracking, search, profile |
| [mpv](https://mpv.io) | External media player (recommended) |
| [yt-dlp](https://github.com/yt-dlp/yt-dlp) | Episode downloading |
| [Python 3](https://python.org) | Scraper subprocess (AniNeko, MangaKatana) |
## Legal
Anicat is for educational and personal use only. See [DISCLAIMER.md](DISCLAIMER.md) and [SECURITY.md](SECURITY.md).
## License
[GNU General Public License v3.0](LICENSE)