Trailarr is a self-hosted app to download and manage trailers for your media libraries.
GitHub: https://github.com/nandyalu/trailarr/
Docker Hub: https://hub.docker.com/r/nandyalu/trailarr/
Documentation: https://nandyalu.github.io/trailarr
Reddit: https://www.reddit.com/r/trailarr
Discord: https://discord.gg/KKPr5kQEzQ
Features
- Connect multiple Radarr, Sonarr, and Plex instances
- Auto-downloads trailers and saves them next to your media
- Detects existing trailers — skips duplicates automatically
- Skips PlexPass trailers if they meet a minimum resolution threshold
- Plex naming conventions out of the box — also works with Emby and Jellyfin
- Custom profiles to control quality, format, and processing options
- Web UI to browse your library and manage trailers
Let us know that you appreciate the project by giving us a ⭐ on GitHub.
Installation & Setup
See the Installation Guide for full instructions. Available methods:
- Docker Compose ⭐ — recommended for most users, easiest to set up and update
- Direct Install — native installer script for Linux, macOS, and Windows
- Build and Install — fully manual setup for custom environments or contributors
- Unraid — community template available
Community video by AlienTech42 covering installation and setup on Unraid:
Dependencies
Trailarr is built using the following libraries and tools:
| Tool / Library | Used For | Link |
|---|---|---|
| Angular | Frontend UI framework | angular.dev |
| FastAPI | Backend REST API framework | fastapi.tiangolo.com |
| FFmpeg | Video processing and conversion | ffmpeg.org |
| Python-ffmpeg | Python docker image with yt-dlp, ffmpeg and hardware acceleration drivers pre-installed | github.com/nandyalu/python-ffmpeg |
| Quiv | Background task scheduler | nandyalu.github.io/quiv |
| yt-dlp | Trailer downloading from video sites | github.com/yt-dlp/yt-dlp |
| Zensical | Documentation | zensical.org |
Support
We tried to cover most topics in the Docs and also have a FAQ section, try those first.
If you still need help, please use the below:
Note: We suggest not using GitHub issues for support requests, but won't stop you if you do!
Issues
If you encounter any bugs/issues, please create an issue on the GitHub repository or post on our Discord Server.
Roadmap
There are some changes that are planned for the future. These changes are not guaranteed to be implemented, but they are on the roadmap.
- Add Profiles for Trailers Quality with custom filters (include wait time between downloads)
- Add custom filters to Media pages in frontend
- Add a new method for making path mappings easier
- Add options to disable conversion of downloaded videos
- Update media objects to include more metadata received from Radarr/Sonarr, include media_available flag, downloaded trailer info, etc.
- Add an option to trim videos in
Media Detailspage to remove unwanted parts of the trailer. This will help in cases where the trailer has unwanted parts at the beginning or end. 🎬 - Add Plex integration to send notifications to Plex and scan media signals
- Add support for some fields with translated values
- Update docs for Windows path mappings
- Improve task logging
- Add Support for Hardware Acceleration using VAAPI (Intel and AMD)
- Add Event tracking similar to History in Radarr/Sonarr
- Add Discord notifications for important events
- Use TMDB API for finding trailers as an option
If you have any suggestions or ideas for new features, please feel free to reach out on Discord. We are always looking for ways to improve the project.
Contributing
Contributions are welcome! Please see the Contributing guide for more information.
Looking for a backend (python) / frontend developers (Angular) to help with the project, if you are interested, please reach out on Discord.
License
This project is licensed under the terms of the GPL v3 license. See GPL-3.0 license for more details.
Disclaimer
For important legal information about using Trailarr, please refer to our Legal Disclaimer.