{"id":17751450,"url":"https://github.com/Woahai321/list-sync","last_synced_at":"2025-03-15T03:30:56.748Z","repository":{"id":259297016,"uuid":"861398223","full_name":"Woahai321/list-sync","owner":"Woahai321","description":"ListSync automates the import of your IMDB \u0026 Trakt lists into Overseerr \u0026 Jellyseerr, simplifying your movie management.","archived":false,"fork":false,"pushed_at":"2025-03-09T02:17:43.000Z","size":398,"stargazers_count":118,"open_issues_count":7,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-09T02:23:07.871Z","etag":null,"topics":["docker","imdb","imdb-scraper","imdb-webscrapping","jellyfin","jellyseerr","overseerr","plex","plex-media-server","python","radarr","selenium","seleniumbase","sonarr","trakt","trakt-tv","webscraping"],"latest_commit_sha":null,"homepage":"https://soluify.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Woahai321.png","metadata":{"files":{"readme":"ReadMe.md","changelog":null,"contributing":"docs/contributing.md","funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"Woahai321","custom":"https://soluify.com/real-growth"}},"created_at":"2024-09-22T19:29:14.000Z","updated_at":"2025-03-09T02:13:05.000Z","dependencies_parsed_at":"2024-10-28T00:19:46.931Z","dependency_job_id":"b4980cea-23ab-4304-b254-75885b5d5d39","html_url":"https://github.com/Woahai321/list-sync","commit_stats":null,"previous_names":["woahai321/list-sync"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Woahai321%2Flist-sync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Woahai321%2Flist-sync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Woahai321%2Flist-sync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Woahai321%2Flist-sync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Woahai321","download_url":"https://codeload.github.com/Woahai321/list-sync/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243681024,"owners_count":20330152,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","imdb","imdb-scraper","imdb-webscrapping","jellyfin","jellyseerr","overseerr","plex","plex-media-server","python","radarr","selenium","seleniumbase","sonarr","trakt","trakt-tv","webscraping"],"created_at":"2024-10-26T13:01:29.800Z","updated_at":"2025-03-15T03:30:56.742Z","avatar_url":"https://github.com/Woahai321.png","language":"Python","funding_links":["https://github.com/sponsors/Woahai321","https://soluify.com/real-growth"],"categories":["docker","python","👾 Companion Apps \u0026 Tools","*Arr Stack \u0026 Automation"],"sub_categories":["🔍 Media Requests \u0026 Discovery","Hosting Providers (VPS, Seedbox..)"],"readme":"# 🍿 ListSync - Bridge Your Watchlist \u0026 Media Server 🎬\n\n![ListSync Logo](https://share.woahlab.com/-Tdgu2viusH)\n![GitHub last commit](https://img.shields.io/github/last-commit/woahai321/list-sync?style=for-the-badge\u0026logo=github)\n![GitHub issues](https://img.shields.io/github/issues/woahai321/list-sync?style=for-the-badge\u0026logo=github)\n![GitHub stars](https://img.shields.io/github/stars/woahai321/list-sync?style=for-the-badge\u0026logo=github)\n![GitHub release](https://img.shields.io/github/v/release/woahai321/list-sync?style=for-the-badge\u0026logo=github)\n![Docker](https://img.shields.io/badge/Docker-ready-blue?style=for-the-badge\u0026logo=docker)\n![Python](https://img.shields.io/badge/Python-3.7%2B-blue?style=for-the-badge\u0026logo=python)\n[![Website](https://img.shields.io/badge/Website-soluify.com-blue?style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAACXBIWXMAAAsTAAALEwEAmpwYAAABKElEQVQ4jZXTMUoDQRQG4C+7YmFhYSHYWFgIHkAQPICFhYcQBEEQxGNYWHgIC0H0BsELWFhYWAQLC2GzxSzsLrOz2f0hMDDvzXvfzLz3ZkopKKMxxrjHJc7wjjd0UgpfZRYVgbM4P2AevZzEHlZwiU5KYa8QmMUNtnCMh5TCqCR0jgF6eEQfq1jHFfbRxHFKYVQQWMQIZxjGehObeEUH7ZTCJCcYx2Ub99jGEEtYwDnWsIk2LlIK/ZzALK7RwlKsPWMppfAc/m+0UwrTnKCBHt7iZnlp5/GCVkrhKyd4wg5WYv6NTkrhNSdoRd0b2Cg0z0dOcIj9uHnePG/+t/k3wR/kyUNUdQE+UAAAAABJRU5ErkJgg==)](https://soluify.com/)\n[![LinkedIn](https://img.shields.io/badge/LinkedIn-blue?style=for-the-badge\u0026logo=linkedin)](https://www.linkedin.com/company/soluify)\n\n---\n\n## 🚀 What is ListSync?\n\nListSync automatically syncs your watchlists from IMDb, Trakt, and Letterboxd with Overseerr/Jellyseerr. No more manual adding - just add movies and shows to your favorite watchlist, and they'll appear in your media server automatically.\n\nKey Features:\n\n- 🔄 Automatic synchronization\n- 🎬 Support for multiple watchlist platforms\n- 🖥️ Compatible with Overseerr and Jellyseerr\n- ⚡ Easy setup with Docker\n\n---\n\n## 📚 Quick Links\n\n- [🚀 Installation Guide](#-getting-started)\n- [📋 List Setup Guide](#-obtaining-list-ids)\n- [🛠️ Troubleshooting](#-troubleshooting)\n- [📖 Documentation](docs/)\n- [🌉 SeerrBridge Integration](#-seerrbridge-integration)\n\n---\n\n### Currently in Development for v0.6.0\n\nFor the most stable experience, use the source code from the latest release [here](https://github.com/Woahai321/list-sync/releases/tag/v0.5.6).\n\n## 🎬 Demo\n\n![Bot In Action](https://share.woahlab.com/-BZtwSD96LN)\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003eHow Does It Work?\u003c/summary\u003e\n\nListSync seamlessly syncs your watchlists with your media server in three simple steps:\n\n#### 1. **Fetch Watchlists**\n\nListSync retrieves your watchlists from **IMDb**, **Trakt** or **Letterboxd** using Selenium web scraping techniques.\n\n#### 2. **Search Media on Media Server**\n\nListSync searches for each item on your media server (**Overseerr** or **Jellyseerr**) using its API. It handles edge cases like special characters or multiple results for accurate matches.\n\n#### 3. **Request Media**\n\nListSync checks if the media is already available or requested. If not, it automatically requests the item:\n\n- For **Movies**, it requests the title.\n- For **TV Shows**, it requests all available seasons.\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eWhy Use ListSync?\u003c/summary\u003e\n\n- **Save Time**: Automates adding movies and TV shows to your media server.\n- **Stay Organized**: Keeps your media server in sync with your watchlists.\n- **Flexible**: Works with IMDb, Trakt, Letterboxd, Overseerr, and Jellyseerr.\n- **Customizable**: Set sync intervals to match your preferences.\n\u003c/details\u003e\n\n---\n\n## 🚀 Getting Started\n\nYou can run ListSync in two primary modes: **Interactive Mode** and **Automated Mode**. \n\n### 1. **Interactive Mode** (Recommended for Quick Start)\n\nThe quickest way to get started is by using our Docker one-liner, which runs ListSync in Interactive Mode. This option will prompt you for all the necessary information during setup:\n\n| Installation Method | Command |\n| :-------------------- | :---------------------------------- |\n| ![Docker](https://img.shields.io/badge/Docker-ready-blue?style=for-the-badge\u0026logo=docker) | `docker pull ghcr.io/woahai321/list-sync:main \u0026\u0026 docker run -it --rm -v \"$(pwd)/data:/usr/src/app/data\" -e TERM=xterm-256color ghcr.io/woahai321/list-sync:main` |\n\n### 2. **Automated Mode** (Preferred for Regular Syncing)\n\nFor a seamless experience, you can run ListSync in Automated Mode using a .env file and Docker Compose. This mode eliminates the need for manual inputs each time you run the script by automatically pulling list IDs and configurations from your `.env` file:\n\n\u003cdetails\u003e\n\u003csummary\u003eExpand for Docker Compose Instructions 🐳\u003c/summary\u003e\n\n#### Running with Docker Compose\n\n**Create a `.env` file**: Configure your settings in a `.env` file with the following template:\n\n```env\n# Overseerr Configuration \nOVERSEERR_URL=https://your-overseerr-instance\nOVERSEERR_API_KEY=your-api-key-here\nOVERSEERR_USER_ID=1\n\n# Set to true for automated mode (recommended for Docker)\nAUTOMATED_MODE=false\n\n# Sync interval in hours (default: 24)\nSYNC_INTERVAL=24\n\n# Request Quality Profile (true for 4K, false for standard)\nOVERSEERR_4K=false\n\n# Lists Configuration (comma-separated)\n# Examples:\nIMDB_LISTS=ls123456789,ur123456789,top,boxoffice,https://www.imdb.com/list/ls123456789/\nTRAKT_LISTS=12345,67890,https://trakt.tv/users/username/lists/listname\nLETTERBOXD_LISTS=https://letterboxd.com/username/list/listname/ \n```\n\n**Create a `docker-compose.yml` file**:\n\n```\nversion: \"3.8\"\n\nservices:\n  listsync:\n    image: ghcr.io/woahai321/list-sync:main\n    container_name: listsync\n    environment:\n      - OVERSEERR_URL=${OVERSEERR_URL}\n      - OVERSEERR_API_KEY=${OVERSEERR_API_KEY}\n      - OVERSEERR_USER_ID=${OVERSEERR_USER_ID:-1}\n      - SYNC_INTERVAL=${SYNC_INTERVAL:-24}\n      - AUTOMATED_MODE=true\n      - OVERSEERR_4K=${OVERSEERR_4K:-false}\n      - IMDB_LISTS=${IMDB_LISTS}\n      - TRAKT_LISTS=${TRAKT_LISTS}\n      - LETTERBOXD_LISTS=${LETTERBOXD_LISTS}\n    volumes:\n      - ./data:/usr/src/app/data\n      - ./.env:/usr/src/app/.env\n    restart: unless-stopped\n```\n\n**Run using Docker Compose**:\n| Installation Method | Command |\n| :----------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| ![Docker](https://img.shields.io/badge/Docker-ready-blue?style=for-the-badge\u0026logo=docker) | `docker-compose up` |\n\n\nThis setup will trigger *Automated Mode*, meaning it will automatically pull in the added lists based on your configuration, streamlining the syncing process.\n\u003c/details\u003e\n\n### 3. **Manual Installation** (Advanced Users)\n\nYou can also set up ListSync manually if you prefer a more hands-on approach:\n\n\u003cdetails\u003e\n\u003csummary\u003eExpand for Manual Installation Instructions 🛠️\u003c/summary\u003e\n\n#### Manual Installation Methods\n\n| Installation Method | Command |\n| :------------------ | :------------------------------------------------------------ |\n| ![Poetry](https://img.shields.io/badge/Poetry-ready-blue?style=for-the-badge\u0026logo=poetry) | `git clone https://github.com/Woahai321/list-sync.git \u0026\u0026 cd list-sync \u0026\u0026 poetry install \u0026\u0026 poetry run python add.py` |\n| ![Python](https://img.shields.io/badge/Python-3.7%2B-blue?style=for-the-badge\u0026logo=python) | `git clone https://github.com/Woahai321/list-sync.git \u0026\u0026 cd list-sync \u0026\u0026 pip install -r requirements.txt \u0026\u0026 python add.py` |\n\nRefer to our [Installation Guide](/docs/installation.md) for detailed instructions.\n\u003c/details\u003e\n\n---\n\n## 📊 Compatibility\n\n### 🌉 SeerrBridge Integration\n\n[![SeerrBridge](https://img.shields.io/badge/SeerrBridge-Compatible-blue?style=for-the-badge\u0026logo=github)](https://github.com/Woahai321/SeerrBridge)\n\nSeerrBridge is our companion application that provides an alternative to traditional \\*arr stack (Radarr/Sonarr) setup. It works alongside ListSync to create a complete media management solution:\n\n- **Automated Processing**: When ListSync adds requests to Jellyseerr/Overseerr, SeerrBridge automatically processes them\n- **Browser Automation**: Uses Selenium to automate media fetching through Debrid Media Manager\n- **Simplified Setup**: Eliminates the need for complex \\*arr stack configuration\n- **Real-Debrid Integration**: Direct integration with Real-Debrid for content retrieval\n\n#### How ListSync \u0026 SeerrBridge Work Together\n\n1. ListSync adds media requests to Jellyseerr/Overseerr\n2. SeerrBridge detects the requests via webhook\n3. SeerrBridge automatically processes the requests through DMM\n4. Media becomes available in your library\n\nFor detailed information about SeerrBridge, visit the [SeerrBridge Repository](https://github.com/Woahai321/SeerrBridge).\n\n### Media Server Compatibility\n\n|                                                                                                                                                                                                                                                                                     Application                                                                                                                                                                                                                                                                                     |    Status    | Notes                              |\n| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------: | :--------------------------------- |\n|  ![Overseerr](https://img.shields.io/badge/Overseerr-1.33.2+-blue?style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAACXBIWXMAAAsTAAALEwEAmpwYAAABKElEQVQ4jZXTMUoDQRQG4C+7YmFhYSHYWFgIHkAQPICFhYcQBEEQxGNYWHgIC0H0BsELWFhYWAQLC2GzxSzsLrOz2f0hMDDvzXvfzLz3ZkopKKMxxrjHJc7wjjd0UgpfZRYVgbM4P2AevZzEHlZwiU5KYa8QmMUNtnCMh5TCqCR0jgF6eEQfq1jHFfbRxHFKYVQQWMQIZxjGehObeEUH7ZTCJCcYx2Ub99jGEEtYwDnWsIk2LlIK/ZzALK7RwlKsPWMppfAc/m+0UwrTnKCBHt7iZnlp5/GCVkrhKyd4wg5WYv6NTkrhNSdoRd0b2Cg0z0dOcIj9uHnePG/+t/k3wR/kyUNUdQE+UAAAAABJRU5ErkJgg==)   | ✅ Supported | Full functionality with Overseerr  |\n| ![Jellyseerr](https://img.shields.io/badge/Jellyseerr-1.9.2+-purple?style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAACXBIWXMAAAsTAAALEwEAmpwYAAABB0lEQVQ4jZXTMUoDQRQG4C+7YmFhYSHYWFgIHkAQPICFhYcQBEEQxGNYWHgIC0H0BsELWFhYWAQLC2GzxSzsLrOz2f0hMDDvzXvfzLz3ZkopKKMxxrjHJc7wjjd0UgpfZRYVgbM4P2AevZzEHlZwiU5KYa8QmMUNtnCMh5TCqCR0jgF6eEQfq1jHFfbRxHFKYVQQWMQIZxjGehObeEUH7ZTCJCcYx2Ub99jGEEtYwDnWsIk2LlIK/ZzALK7RwlKsPWMppfAc/m+0UwrTnKCBHt7iZnlp5/GCVkrhKyd4wg5WYv6NTkrhNSdoRd0b2Cg0z0dOcIj9uHnePG/+t/k3wR/kyUNUdQE+UAAAAABJRU5ErkJgg==) | ✅ Supported | Full functionality with Jellyseerr |\n|    ![Radarr](https://img.shields.io/badge/Radarr-5.11.0+-orange?style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAACXBIWXMAAAsTAAALEwEAmpwYAAABKElEQVQ4jZXTMUoDQRQG4C+7YmFhYSHYWFgIHkAQPICFhYcQBEEQxGNYWHgIC0H0BsELWFhYWAQLC2GzxSzsLrOz2f0hMDDvzXvfzLz3ZkopKKMxxrjHJc7wjjd0UgpfZRYVgbM4P2AevZzEHlZwiU5KYa8QmMUNtnCMh5TCqCR0jgF6eEQfq1jHFfbRxHFKYVQQWMQIZxjGehObeEUH7ZTCJCcYx2Ub99jGEEtYwDnWsIk2LlIK/ZzALK7RwlKsPWMppfAc/m+0UwrTnKCBHt7iZnlp5/GCVkrhKyd4wg5WYv6NTkrhNSdoRd0b2Cg0z0dOcIj9uHnePG/+t/k3wR/kyUNUdQE+UAAAAABJRU5ErkJgg==)     | ✅ Supported | Compatible through Jellyseerr      |\n|     ![Sonarr](https://img.shields.io/badge/Sonarr-4.0.9+-5cad7b?style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAACXBIWXMAAAsTAAALEwEAmpwYAAABB0lEQVQ4jZXTMUoDQRQG4C+7YmFhYSHYWFgIHkAQPICFhYcQBEEQxGNYWHgIC0H0BsELWFhYWAQLC2GzxSzsLrOz2f0hMDDvzXvfzLz3ZkopKKMxxrjHJc7wjjd0UgpfZRYVgbM4P2AevZzEHlZwiU5KYa8QmMUNtnCMh5TCqCR0jgF6eEQfq1jHFfbRxHFKYVQQWMQIZxjGehObeEUH7ZTCJCcYx2Ub99jGEEtYwDnWsIk2LlIK/ZzALK7RwlKsPWMppfAc/m+0UwrTnKCBHt7iZnlp5/GCVkrhKyd4wg5WYv6NTkrhNSdoRd0b2Cg0z0dOcIj9uHnePG/+t/k3wR/kyUNUdQE+UAAAAABJRU5ErkJgg==)     | ✅ Supported | Compatible through Jellyseerr      |\n\n### Supported List Services\n\n|                                                                                                                                                                                                                                                                                   Service                                                                                                                                                                                                                                                                                   |    Status    | Notes               |\n| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------: | :------------------ |\n|       ![IMDB](https://img.shields.io/badge/IMDB-green?style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAACXBIWXMAAAsTAAALEwEAmpwYAAABKElEQVQ4jZXTMUoDQRQG4C+7YmFhYSHYWFgIHkAQPICFhYcQBEEQxGNYWHgIC0H0BsELWFhYWAQLC2GzxSzsLrOz2f0hMDDvzXvfzLz3ZkopKKMxxrjHJc7wjjd0UgpfZRYVgbM4P2AevZzEHlZwiU5KYa8QmMUNtnCMh5TCqCR0jgF6eEQfq1jHFfbRxHFKYVQQWMQIZxjGehObeEUH7ZTCJCcYx2Ub99jGEEtYwDnWsIk2LlIK/ZzALK7RwlKsPWMppfAc/m+0UwrTnKCBHt7iZnlp5/GCVkrhKyd4wg5WYv6NTkrhNSdoRd0b2Cg0z0dOcIj9uHnePG/+t/k3wR/kyUNUdQE+UAAAAABJRU5ErkJgg==)       | ✅ Supported | Currently supported |\n|      ![Trakt](https://img.shields.io/badge/Trakt-green?style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAACXBIWXMAAAsTAAALEwEAmpwYAAABKElEQVQ4jZXTMUoDQRQG4C+7YmFhYSHYWFgIHkAQPICFhYcQBEEQxGNYWHgIC0H0BsELWFhYWAQLC2GzxSzsLrOz2f0hMDDvzXvfzLz3ZkopKKMxxrjHJc7wjjd0UgpfZRYVgbM4P2AevZzEHlZwiU5KYa8QmMUNtnCMh5TCqCR0jgF6eEQfq1jHFfbRxHFKYVQQWMQIZxjGehObeEUH7ZTCJCcYx2Ub99jGEEtYwDnWsIk2LlIK/ZzALK7RwlKsPWMppfAc/m+0UwrTnKCBHt7iZnlp5/GCVkrhKyd4wg5WYv6NTkrhNSdoRd0b2Cg0z0dOcIj9uHnePG/+t/k3wR/kyUNUdQE+UAAAAABJRU5ErkJgg==)      | ✅ Supported | Currently supported |\n| ![Letterboxd](https://img.shields.io/badge/Letterboxd-green?style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAACXBIWXMAAAsTAAALEwEAmpwYAAABKElEQVQ4jZXTMUoDQRQG4C+7YmFhYSHYWFgIHkAQPICFhYcQBEEQxGNYWHgIC0H0BsELWFhYWAQLC2GzxSzsLrOz2f0hMDDvzXvfzLz3ZkopKKMxxrjHJc7wjjd0UgpfZRYVgbM4P2AevZzEHlZwiU5KYa8QmMUNtnCMh5TCqCR0jgF6eEQfq1jHFfbRxHFKYVQQWMQIZxjGehObeEUH7ZTCJCcYx2Ub99jGEEtYwDnWsIk2LlIK/ZzALK7RwlKsPWMppfAc/m+0UwrTnKCBHt7iZnlp5/GCVkrhKyd4wg5WYv6NTkrhNSdoRd0b2Cg0z0dOcIj9uHnePG/+t/k3wR/kyUNUdQE+UAAAAABJRU5ErkJgg==) | ✅ Supported | Currently supported |\n\n---\n\n## 📋 Obtaining List IDs\n\nListSync supports **IMDb**, **Trakt**, and **Letterboxd** lists. You can add them using either the raw URL or the list ID.\n\n\u003cdetails\u003e\n\u003csummary\u003e📋 IMDb List ID or URL\u003c/summary\u003e\n\n#### **Using the Raw URL**:\n1. Navigate to your IMDb list in your browser.  \n2. Copy the URL from the address bar. Examples:  \n   - Custom lists: `https://www.imdb.com/list/ls012345678/`  \n   - IMDb charts: `https://www.imdb.com/chart/top/` (Top 250), `https://www.imdb.com/chart/boxoffice/` (Box Office)  \n   - Watchlists: `https://www.imdb.com/user/ur12345678/watchlist`  \n3. Paste the URL directly into ListSync.\n\n#### **Using the List ID**:\n1. Look at the URL:  \n   - Custom lists: `ls012345678`  \n   - IMDb charts: Use the chart name (e.g., `top`, `boxoffice`)  \n   - Watchlists: `ur12345678`  \n2. Use the list ID in ListSync.\n\n#### **Supported IMDb Charts**:\n- `top` (Top 250 Movies)  \n- `boxoffice` (Box Office)  \n- `moviemeter` (MovieMeter)  \n- `tvmeter` (TVMeter)  \n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e📋 Trakt List ID or URL\u003c/summary\u003e\n\n#### **Using the Raw URL**:\n1. Navigate to your Trakt list in your browser.  \n2. Copy the URL from the address bar. Example:  \n   - `https://trakt.tv/users/username/lists/example-list`  \n3. Paste the URL directly into ListSync.\n\n#### **Using the List ID**:\n1. Click the \"Share\" button on your Trakt list.  \n2. Copy the link, which will look like:  \n   - `https://trakt.tv/lists/12345678`  \n3. The list ID is the number at the end (e.g., `12345678`).  \n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e📋 Letterboxd URL\u003c/summary\u003e\n\n#### **Using the Raw URL**:\n1. Navigate to your Letterboxd list in your browser.  \n2. Copy the URL from the address bar. Example:  \n   - `https://letterboxd.com/user/list/example-list/`  \n3. Paste the URL directly into ListSync.  \n\u003c/details\u003e\n\n### Adding Multiple List IDs\n\nWhen inputting list IDs or URLs, you can add multiple lists by separating them with commas:\n\n- Example: `ls012345678,12345678,https://www.imdb.com/chart/top/,ur987654321,https://letterboxd.com/user/list/example-list/`\n\nThis allows you to sync multiple lists at once, whether they are custom lists, charts, or watchlists.\n\n---\n\n## 📋 Notes\n\n- **Security Best Practices:** Please read scripts you find online before running them.\n- **API Credentials:** Always keep your API credentials secure.\n- **Rate Limiting:** Be mindful of Overseerr's rate limiting policies during imports.\n- **Permissions:** Only import and manage media you have the rights to handle.\n\n## 💰 Donations\n\nIf you find ListSync useful and would like to support its development, consider making a donation:\n\n- BTC (Bitcoin): `bc1qxjpfszwvy3ty33weu6tjkr394uq30jwkysp4x0`\n- ETH (Ethereum): `0xAF3ADE79B7304784049D200ea50352D1C717d7f2`\n\nThank you for your support!\n\n---\n\n## 🔎 How it Works\n\nFor detailed information on how ListSync works, please refer to our [How it Works](/docs/how-it-works.md) document.\n\n## 🛠 Troubleshooting\n\nIf you encounter any issues while using ListSync, please check our [Troubleshooting Guide](/docs/troubleshooting.md) for solutions to common problems.\n\n## 🛤️ Roadmap\n\nTo see our plans for future development and features, visit our [Roadmap](/docs/roadmap.md).\n\n## 🤝 Contributing\n\nWe welcome contributions! For guidelines on how to contribute, please see our [Contributing Guide](/docs/contributing.md).\n\n## 📄 License\n\nThis project is licensed under the [MIT License](https://opensource.org/license/mit). Review the LICENSE file for more details.\n\n## 🛡️ Legal Disclaimer\n\nFor important legal information about using ListSync, please refer to our [Legal Disclaimer](/docs/legal-disclaimer.md).\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=Woahai321/list-sync\u0026type=Date)](https://star-history.com/#Woahai321/list-sync\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWoahai321%2Flist-sync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FWoahai321%2Flist-sync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWoahai321%2Flist-sync/lists"}