https://github.com/nandyalu/trailarr
Trailarr is a Docker application to download and manage trailers for your Radarr and Sonarr libraries.
https://github.com/nandyalu/trailarr
plex radarr sonarrr trailers video-conversion
Last synced: about 2 months ago
JSON representation
Trailarr is a Docker application to download and manage trailers for your Radarr and Sonarr libraries.
- Host: GitHub
- URL: https://github.com/nandyalu/trailarr
- Owner: nandyalu
- License: gpl-3.0
- Created: 2024-03-07T19:28:45.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-10T02:34:39.000Z (6 months ago)
- Last Synced: 2026-01-11T00:21:58.253Z (6 months ago)
- Topics: plex, radarr, sonarrr, trailers, video-conversion
- Language: Python
- Homepage:
- Size: 26.4 MB
- Stars: 326
- Watchers: 6
- Forks: 18
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-jellyfin - trailarr - Manages trailer downloads for your Radarr and Sonarr libraries. (👾 Companion Apps & Tools / 📥 Content Import)
- awesome-arr - Trailarr - A Docker application to download and manage trailers for your Radarr, and Sonarr libraries. (Complimenting Apps)
README
#
Trailarr is a Docker application to download and manage trailers for your [Radarr](https://radarr.video/), and [Sonarr](https://sonarr.tv/) libraries.
GitHub: [https://github.com/nandyalu/trailarr/](https://github.com/nandyalu/trailarr/)
Docker Hub: [https://hub.docker.com/r/nandyalu/trailarr/](https://hub.docker.com/r/nandyalu/trailarr/)
Documentation: [https://nandyalu.github.io/trailarr](https://nandyalu.github.io/trailarr/)
Reddit: [https://www.reddit.com/r/trailarr](https://www.reddit.com/r/trailarr/)
Discord: [https://discord.gg/KKPr5kQEzQ](https://discord.gg/KKPr5kQEzQ)
## Features
- Manages multiple Radarr and Sonarr instances to find media
- Detects existing trailers for media items.
- Downloads trailer and organizes it in the media folder.
- Follows plex naming conventions. Works with [Plex](https://www.plex.tv/), [Emby](https://emby.media/), [Jellyfin](https://jellyfin.org/), etc.
- Customizable profiles to manage trailer downloads and processing.
- Responsive UI to view media items and manage trailers.
- Built with Angular and FastAPI.
> Let us know that you appreciate the project by giving us a star on [GitHub](https://github.com/nandyalu/trailarr).
## Installation & Setup
Trailarr can be installed using Docker (recommended) or directly on Debian based systems. See the [Documentation](https://nandyalu.github.io/trailarr/) for detailed instructions on [Getting Started](https://nandyalu.github.io/trailarr/getting-started/) and [User Guide](https://nandyalu.github.io/trailarr/user-guide/).
We don't have an official video yet, but there is a video by [AlienTech42](https://www.youtube.com/@AlienTech42) on [YouTube](https://www.youtube.com/watch?v=Hz31zWEtY5k&t=8s&pp=ygUOdHJhaWxhcnIgc2V0dXA%3D) that explains Trailarr installation and setup on Unraid.
[](https://www.youtube.com/watch?v=Hz31zWEtY5k "Setting up Trailarr - AlienTech42")
## Dependencies
Trailarr is built using the following libraries and tools:
- [Angular](https://angular.dev/)
- [Ffmpeg](https://ffmpeg.org/)
- [FastAPI](https://fastapi.tiangolo.com)
- [Material for Mkdocs](https://github.com/squidfunk/mkdocs-material)
- [Python](https://www.python.org/)
- [Quiv](https://nandyalu.github.io/quiv/)
- [Yt-dlp](https://github.com/yt-dlp/yt-dlp)
## Support
If you have any questions or need help, please read the [FAQ](https://nandyalu.github.io/trailarr/troubleshooting/faq/) first.
If you still need help, please use the below:
- [Discord](https://discord.gg/KKPr5kQEzQ)
- [Reddit](https://www.reddit.com/r/trailarr)
> **Note:** Please do not use the GitHub issues for support requests!
## Issues
If you encounter any bugs/issues, please create an issue on the [GitHub repository](https://github.com/nandyalu/trailarr/issues) or post on our [Discord Server](https://discord.gg/KKPr5kQEzQ) (recommended).
## 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.
- [x] Add Profiles for Trailers Quality with custom filters (include wait time between downloads)
- [x] Add custom filters to Media pages in frontend
- [x] Add a new method for making path mappings easier
- [x] Add options to disable conversion of downloaded videos
- [x] Update media objects to include more metadata received from Radarr/Sonarr, include media_available flag, downloaded trailer info, etc.
- [x] Add an option to trim videos in `Media Details` page to remove unwanted parts of the trailer. This will help in cases where the trailer has unwanted parts at the beginning or end. 🎬
- [x] Add Plex integration to send notifications to Plex and scan media signals
- [x] Add support for some fields with translated values
- [x] Update docs for Windows path mappings
- [x] Improve task logging
- [x] Add Support for Hardware Acceleration using VAAPI (Intel and AMD)
- [x] Add Event tracking similar to History in Radarr/Sonarr
- [ ] Add Discord notifications for important events
If you have any suggestions or ideas for new features, please feel free to reach out on [Discord](https://discord.gg/KKPr5kQEzQ). We are always looking for ways to improve the project.
## Contributing
Contributions are welcome! Please see the [Contributing](https://nandyalu.github.io/trailarr/references/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](https://discord.gg/KKPr5kQEzQ).
## License
This project is licensed under the terms of the GPL v3 license. See [GPL-3.0 license](https://github.com/nandyalu/trailarr?tab=GPL-3.0-1-ov-file) for more details.
## Disclaimer
For important legal information about using Trailarr, please refer to our [Legal Disclaimer](https://nandyalu.github.io/trailarr/references/legal-disclaimer/).