Synchronizing Your Plex Media Server with AniList: A Dream Come True for Anime Fans
As an anime enthusiast, I’ve always struggled with keeping my watch progress up to date across different platforms. If you’re like me, you’re probably using Plex to manage your media library and AniList to track your anime watching journey. But manually updating your watch status and episode progress can be a chore. That’s why I’m excited to share with you a tool that has changed my life: PlexAniBridge.
What is PlexAniBridge?
PlexAniBridge is a synchronization tool that bridges the gap between your Plex media server and your AniList profile. Developed by Elias Benb, this tool allows you to keep your watch status, episode progress, started/completed dates, ratings, reviews, watchlists, and rewatch counts in sync across both platforms. With PlexAniBridge, you can say goodbye to manual updates and hello to a seamless anime watching experience.
Core Features
So, what makes PlexAniBridge so special? Here are some of its core features:
- Multi-profile support: You can set up multiple profiles with distinct settings and customization options, allowing you to sync different Plex servers, libraries, and accounts to different AniList users.
- Sync modes: You can choose from interval-based scans, poll for changes, or use Plex webhooks for instant updates, or any combination of these.
- Per-field control: You can exclude any fields, such as score or notes, from being synced to AniList if you want to keep them separate.
- Web UI: There’s a user-friendly web interface to view sync history, stats, and manage mappings, with plans to add configuration options in the future.
- Automatic AniList backups: PlexAniBridge includes automatic backups of your AniList data in JSON format, along with a restore function through the UI or a CLI script.
- Undo functionality: Every sync operation is recorded with before/after state, allowing you to undo selected operations via the UI.
- Custom mappings: You can add or override mappings through the UI or by dropping JSON files in the data directory.
- Smart matching: PlexAniBridge uses a curated anime mappings database, with title search fallback disabled by default, but can be turned on and controlled with a similarity threshold.
The Curated Anime Mappings Database
One of the most impressive features of PlexAniBridge is its curated anime mappings database, which contains mappings for over 19,900 AniList entries, covering 94.8% of the entire AniList database. This database is a separate repository that has been contributed to by several users, including Luceo, who has done an amazing job in helping to create this resource. With such extensive coverage, title-based fuzzy search is disabled by default, but can be opted-in if needed.
Nerd Stuff
If you’re interested in the technical details, PlexAniBridge is built using Python, with a FastAPI and SQLAlchemy stack, and an async frontend using Svelte. It uses SQLite for internal state and history tracking, with caching layers to minimize API calls to AniList and Plex. Rate limit handling is also included, with automatic retries and backoff for AniList API limits.
Getting Started with PlexAniBridge
If you’re excited to try out PlexAniBridge, you can find the repository on GitHub, along with documentation and a mappings database. There’s also a Discord channel for chat and help. Note that this project is intended for use with the official Plex Metadata agents, and third-party agents may not be supported.
In conclusion, PlexAniBridge is a powerful tool that simplifies the process of keeping your Plex media server and AniList profile in sync. With its extensive feature set, curated anime mappings database, and user-friendly interface, it’s a must-have for any anime fan. So why not give it a try and experience the convenience of seamless synchronization?
PlexAniBridge – Synchronizacja serwera medialnego Plex z AniList: marzenie spełnione dla fanów anime
Jako miłośnik anime, zawsze miałem problemy z utrzymaniem mojego postępu w oglądaniu w różnych platformach. Jeśli jesteś jak ja, prawdopodobnie używasz Plex do zarządzania swoją biblioteką medialną i AniList do śledzenia twojej przygody z oglądaniem anime. Ale ręczne aktualizowanie statusu oglądania i postępu odcinków może być uciążliwe. Dlatego jestem podekscytowany, że mogę podzielić się z tobą narzędziem, które zmieniło moje życie: PlexAniBridge.
Czym jest PlexAniBridge?
PlexAniBridge to narzędzie synchronizacyjne, które mostuje przepaść pomiędzy twoim serwerem medialnym Plex a twoim profilem AniList. Stworzone przez Eliasa Benb, to narzędzie pozwala ci utrzymać status oglądania, postęp odcinków, daty rozpoczęcia i zakończenia, oceny, recenzje, listy oglądania i liczbę powtórzeń w synchronizacji na obu platformach. Z PlexAniBridge, możesz pożegnać się z ręcznymi aktualizacjami i powitać się z bezproblemowym doświadczeniem oglądania anime.
Główne funkcje
Co sprawia, że PlexAniBridge jest tak wyjątkowy? Oto beberapa z jego głównych funkcji:
- Obsługa wielu profili: Możesz utworzyć wiele profili z różnymi ustawieniami i opcjami dostosowywania, co pozwala ci synchronizować różne serwery Plex, biblioteki i konta z różnymi użytkownikami AniList.
- Tryby synchronizacji: Możesz wybrać spośród skanów opartych na interwalach, sondowania zmian lub używania webhooków Plex do aktualizacji w czasie rzeczywistym, lub dowolnej kombinacji tych.
- Kontrola pola po polu: Możesz wykluczyć dowolne pola, takie jak ocena lub notatki, z synchronizacji z AniList, jeśli chcesz je trzymać osobno.
- Interfejs sieciowy: Istnieje przyjazny interfejs sieciowy do wyświetlania historii synchronizacji, statystyk i zarządzania mapowaniami, z planami dodania opcji konfiguracji w przyszłości.
- Automatyczne kopie zapasowe AniList: PlexAniBridge obejmuje automatyczne kopie zapasowe twoich danych AniList w formacie JSON, wraz z funkcją przywracania przez interfejs sieciowy lub skrypt CLI.
- Funkcja cofania: Każda operacja synchronizacji jest rejestrowana ze stanem przed i po, co pozwala ci cofnąć wybrane operacje za pomocą interfejsu sieciowego.
- Niestandardowe mapowania: Możesz dodać lub zastąpić mapowania za pomocą interfejsu sieciowego lub przez umieszczenie plików JSON w katalogu danych.
- Inteligencka dopasowanie: PlexAniBridge używa wycurated bazy danych mapowań anime, z wyłączonym domyślnie wyszukiwaniem tytułu, ale można je włączyć i kontrolować za pomocą progu podobieństwa.
Baza danych mapowań anime
Jedną z najbardziej imponujących funkcji PlexAniBridge jest jego wycurated bazy danych mapowań anime, która zawiera mapowania dla ponad 19 900 wpisów AniList, pokrywając 94,8% całej bazy danych AniList. Ta baza danych jest oddzielnym repozytorium, które zostało przyczynione przez kilku użytkowników, w tym Luceo, który zrobił niesamowitą robotę w pomocy tworzenia tego zasobu. Z takim zakresem, wyszukiwanie tytułu jest wyłączone domyślnie, ale można je włączyć, jeśli potrzebne.
Techniczne
Jeśli jesteś zainteresowany szczegółami technicznymi, PlexAniBridge jest zbudowany przy użyciu Pythona, z stackiem FastAPI i SQLAlchemy, oraz frontendem async używającym Svelte. Używa SQLite do śledzenia stanu wewnętrznego i historii, z warstwami buforowania do minimalizowania wywołań API do AniList i Plex. Obsługa limitu stawek jest również uwzględniona, z automatycznymi powtórkami i wycofaniem dla limitów API AniList.
Rozpoczęcie pracy z PlexAniBridge
Jeśli jesteś podekscytowany, aby wypróbować PlexAniBridge, możesz znaleźć repozytorium na GitHub, wraz z dokumentacją i bazą danych mapowań. Istnieje również kanał Discord dla czatu i pomocy. Należy zauważyć, że ten projekt jest przeznaczony do użytku z oficjalnymi agentami metadanych Plex, a agenci trzeciej strony mogą nie być obsługiwani.
Podsumowując, PlexAniBridge to potężne narzędzie, które upraszcza proces utrzymania twojego serwera medialnego Plex i twojego profilu AniList w synchronizacji. Z jego obszernym zestawem funkcji, wycurated bazą danych mapowań anime i przyjaznym interfejsem, jest to must-have dla każdego fana anime. Więc dlaczego nie spróbować i doświadczyć wygody bezproblemowej synchronizacji?