CrunchyList Sync is a modern, GUI-based tool written in Python that automatically synchronizes your Crunchyroll watch history to your AniList profile.
Built with Flet, it offers a clean, dark-themed user interface to manage your anime tracking without manual data entry.
- GUI Interface: No command line required; user-friendly dashboard.
- One-Click Sync: Fetches your Crunchyroll history and updates AniList automatically.
- Smart Matching: Uses fuzzy search to match Crunchyroll titles (English/Romaji) to AniList IDs.
- Persistence: Remembers your login session so you don't have to re-authenticate every time.
- Safety: Runs locally on your machine. Your tokens are stored only on your computer.
- Python 3.10 or higher
- A Crunchyroll account
- An AniList account
-
Clone the repository
git clone [https://github.com/YOUR_USERNAME/CrunchyList-Sync.git](https://github.com/YOUR_USERNAME/CrunchyList-Sync.git) cd CrunchyList-Sync -
Create a virtual environment (Optional but Recommended)
python -m venv .venv source .venv/bin/activate # On Windows use: .venv\Scripts\activate
-
Install dependencies
pip install -r requirements.txt
-
Run the App
python main.py
- Login to AniList: Click the "Login" button. A browser window will open asking you to authorize the app. Once accepted, the app will confirm your login.
- Get Crunchyroll Token:
- Open Crunchyroll in your browser.
- Open Developer Tools (F12) -> Application -> Cookies.
- Look for
etp_rtor look for your Bearer token in network requests. (This can be found by looking for the watch-history request.) - Paste this token into the "Crunchyroll Token" field in the app and click Save.
- Sync: Click "Sync Crunchyroll -> AniList".
- The app will first fetch your history from Crunchyroll.
- It will then search AniList for every show and update your progress if the Crunchyroll episode count is higher than your AniList record.
Contributions, forks, and pull requests are highly encouraged! This is a community project built by anime fans for anime fans.
- Fork the Project (Top right corner of this page).
- Create your Feature Branch (
git checkout -b feature/AmazingFeature). - Commit your Changes (
git commit -m 'Add some AmazingFeature'). - Push to the Branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
- Improve the anime title matching algorithm (fuzzy matching).
- Add support for "Completed" status updates.
- Add support for other services (HIDIVE, Funimation).
- Improve the UI/UX.
Distributed under the MIT License. See LICENSE for more information.
This project is not affiliated with, endorsed, or sponsored by Crunchyroll or AniList. It is a fan-made tool utilizing public APIs. Use responsibly.