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:

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:

• Discord
• Reddit

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. See the Roadmap to v1.0.0 page in the docs under References for more details.

• 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 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. 🎬
• 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 - planned for v0.10.0 (Aug 2026)
• Use TMDB API for finding trailers as an option - planned for v0.12.0 (Oct-Nov 2026)

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.