Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Woahai321/list-sync
ListSync automates the import of your IMDB & Trakt lists into Overseerr & Jellyseerr, simplifying your movie management.
https://github.com/Woahai321/list-sync
beautifulsoup beautifulsoup4 docker imdb imdb-webscrapping jellyfin jellyseerr overseerr plex plex-media-server python radarr sonarr trakt trakt-tv
Last synced: 13 days ago
JSON representation
ListSync automates the import of your IMDB & Trakt lists into Overseerr & Jellyseerr, simplifying your movie management.
- Host: GitHub
- URL: https://github.com/Woahai321/list-sync
- Owner: Woahai321
- Created: 2024-09-22T19:29:14.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-23T22:12:24.000Z (16 days ago)
- Last Synced: 2024-10-24T06:39:58.098Z (15 days ago)
- Topics: beautifulsoup, beautifulsoup4, docker, imdb, imdb-webscrapping, jellyfin, jellyseerr, overseerr, plex, plex-media-server, python, radarr, sonarr, trakt, trakt-tv
- Language: Python
- Homepage: https://soluify.com
- Size: 225 KB
- Stars: 44
- Watchers: 2
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: ReadMe.md
Awesome Lists containing this project
- awesome-jellyfin - List-Sync ` 🔸 ` - Automatically import movies and TV shows from IMDB or Trakt lists into [Jellyseerr](https://github.com/Fallenbagel/jellyseerr). (👾 Other)
README
# 🍿 ListSync - Bridge Your Watchlist & Media Server 🎬
[](https://soluify.com/)
[](https://www.linkedin.com/company/soluify)
Welcome to the **ListSync Tool**! This powerful tool automates the import of your carefully curated IMDB and Trakt lists into Overseerr, transforming movie and TV show management into a breeze.
## 📜 Table of Contents
1. [Compatibility](#-compatibility)
2. [Getting Started](#-getting-started)
3. [Obtaining List IDs](#-obtaining-list-ids)
4. [How it Works](/docs/how-it-works.md)
5. [Troubleshooting](/docs/troubleshooting.md)
6. [Roadmap](/docs/roadmap.md)
7. [Notes](#-notes)
8. [Contributing](#-contributing)
9. [License](#-license)
## 📊 Compatibility
| Application | Status | Notes |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------: | :--------------------------------- |
| [](https://github.com/Woahai321/SeerrBridge) | ✅ Supported | Fully compatible |
|  | ✅ Supported | Full functionality with Overseerr |
|  | ✅ Supported | Full functionality with Jellyseerr |
|  | ✅ Supported | Started with supporting movies |
|  | ✅ Supported | Now also supports TV shows |
### Supported List Services
| Service | Status | Notes |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------: | :------------------ |
|  | ✅ Supported | Currently supported |
|  | ✅ Supported | Currently supported |
## 🚀 Getting Started
| Installation Method | Command |
| :----------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|  | `sudo docker pull ghcr.io/woahai321/list-sync:main && sudo docker run -it --rm -v "$(pwd)/data:/usr/src/app/data" -e TERM=xterm-256color ghcr.io/woahai321/list-sync:main` |
|  | `pip install -r requirements.txt && python add.py` |
|  | `poetry install && poetry run python add.py` |
For detailed installation instructions, please refer to our [Installation Guide](/docs/installation.md).
## 🔍 Obtaining List IDs
### IMDB List ID
To obtain an IMDB list ID:
1. Navigate to your IMDB list.
2. Look at the URL. It should be in the format: `https://www.imdb.com/list/ls012345678/`
3. The list ID is the `ls` number. In this example, it would be `ls012345678`.
### Trakt List ID
To obtain a Trakt list ID:
1. Go to your Trakt list.
2. Look for the blue "Share" button, located in the list.
3. 
4. Hover over it, it should say "**Copy Link**".
5. The copied link will be in the format: `https://trakt.tv/lists/12345678`
6. The list ID is the number at the end. In this example, it would be `12345678`.
### Adding Multiple List IDs
When inputting list IDs, you can add multiple IDs by separating them with commas.
## 📋 Notes
- **Security Best Practices:** Please read scripts you find online before running them.
- **API Credentials:** Always keep your API credentials secure.
- **Rate Limiting:** Be mindful of Overseerr's rate limiting policies during imports.
- **Permissions:** Only import and manage media you have the rights to handle.
## 💰 Donations
If you find ListSync useful and would like to support its development, consider making a donation:
- BTC (Bitcoin): `bc1qxjpfszwvy3ty33weu6tjkr394uq30jwkysp4x0`
- ETH (Ethereum): `0xAF3ADE79B7304784049D200ea50352D1C717d7f2`
Thank you for your support!
## 🔎 How it Works
For detailed information on how ListSync works, please refer to our [How it Works](/docs/how-it-works.md) document.
## 🛠 Troubleshooting
If you encounter any issues while using ListSync, please check our [Troubleshooting Guide](/docs/troubleshooting.md) for solutions to common problems.
## 🛤️ Roadmap
To see our plans for future development and features, visit our [Roadmap](/docs/roadmap.md).
## 🤝 Contributing
We welcome contributions! For guidelines on how to contribute, please see our [Contributing Guide](/docs/contributing.md).
## 📄 License
This project is licensed under the [MIT License](https://opensource.org/license/mit). Review the LICENSE file for more details.
## 🛡️ Legal Disclaimer
For important legal information about using ListSync, please refer to our [Legal Disclaimer](/docs/legal-disclaimer.md).
## Star History
[](https://star-history.com/#Woahai321/list-sync&Date)