Trailer Finder

Introduction

Trailer Finder is a versatile automation tool designed to streamline the process of searching and downloading movie and TV show trailers. Built with Python, it integrates seamlessly with Radarr and Sonarr APIs, leverages TMDB (The Movie Database) for trailer information, and uses yt-dlp for downloading from YouTube. Whether you're a movie enthusiast or managing a media library, Trailer Finder offers configurable options to enhance your trailer collection effortlessly.

Key Features

• Automated Trailer Downloads: Fetch trailers automatically using keywords and API integrations.
• Multilingual Support: Available in English, Portuguese, Spanish, German, French, Turkish, and Italian.
• Error Handling: Robust error management ensures reliability during API interactions and downloads.
• Integration with Radarr and Sonarr: Seamlessly integrates with these platforms for enhanced trailer management.
• Flexible Configuration: Customize search parameters, download settings, and storage paths using a YAML configuration file.
• Easy Deployment: Available for local execution or in a Docker container.
• Docker Support: Run in isolated environments using Docker or Docker Compose.

Documentation

For detailed information on installation, usage, configuration, and modules, please refer to our comprehensive documentation available on GitHub Pages.

Installation

1. Clone the GitHub repository:

   git clone https://github.com/kalibrado/trailer-finder.git
   cd trailer-finder

2. Install Python dependencies:

   pip install -r requirements.txt

3. Configure the application by renaming config.sample.yaml to config.yaml and adding your API keys and other necessary settings.

Usage

To run Trailer Finder after installation and configuration:

python main.py

To stop the tool, use Ctrl + C in the console. Logs are displayed in the console and can be redirected to log files if needed.

Contributing

We welcome contributions! Please follow the instructions in our contributing guide on GitHub Pages.

Docker

To run Trailer Finder with Docker, follow the instructions available in our Docker section on GitHub Pages.

Troubleshooting

If you encounter issues, please refer to the troubleshooting section of our documentation or open an issue on GitHub.

License

This project is licensed under the MIT License.

Contact

For any questions, you can reach out to me through the following channels:

• GitHub Issues: Open an issue on GitHub.
• GitHub Discussions: Engage in Discussions on GitHub.
• Reddit: Contact me directly on Reddit.
• Discord: Join and connect with the community on our Discord server.

Thank you for using Trailer Finder!