Skip to content

Trailarr Settings

There are several settings that you can use to customize the behavior of Trailarr app. These settings can be set by opening the app in browser http://localhost:7889/settings and navigating to Settings > General page.

General Settings

Downloads Enabled

v0.10.2

  • Default is true

When disabled, Trailarr switches to Preview mode: the scheduled Download Missing Trailers task computes and publishes its full work list but downloads nothing. The media pages show a Preview mode banner with the would-download count and the list of every (media, profile) pair. Scans, syncs and attribution keep running so the preview stays accurate, and manual downloads from Media Details still work.

Useful for pointing Trailarr at a large, carefully curated library and reviewing exactly what it would do before letting it do it.

Monitor Trailers

  • Default is true

Enable this setting to monitor trailers for connections. When enabled, the app will automatically download trailers for media in Radarr and Sonarr.

Note

Disabling this will disable monitoring of media for all connections.

App Theme

  • Default is Auto. Available options are Light, Dark, and Auto.

Select the theme for the app UI. - Light theme will use light colors for the UI. - Dark theme will use dark colors for the UI. - Auto theme will use the system theme of the host system.

Selection will be saved across devices

Once you change the theme, Trailarr will remember the selection for next time across your devices.

WebUI Disable Authentication

v0.6.6

  • Default is false

Enable this setting to disable authentication for the WebUI. Use with caution, as this will allow anyone with access to the WebUI to control the app without needing to log in.

Warning

Disabling WebUI authentication can expose your app to unauthorized access. Only disable this if you are running the app in a secure environment.

File Settings

Wait For Media

  • Default is false

Enable this setting to wait for media to be downloaded before downloading trailers.

Create Missing Folders

v0.11.2

  • Default is false
  • Environment variable: CREATE_MISSING_FOLDERS

Trailarr normally skips a media item when its folder does not exist on disk, because a missing folder usually means the media is not downloaded yet. Enable this setting to create the folder instead, so the trailer downloads anyway.

This helps when you keep trailers in a folder of their own, or when you want trailers ready before the media arrives. Trailarr creates the full folder path and gives it the permissions of the closest folder above it, so the new folder stays writable for the user Trailarr runs as.

Folders are never created on unreachable storage

A disconnected network share or an unmounted drive looks the same as a missing folder. Trailarr checks that the storage is reachable first, and skips the media item when it is not — writing into a dead mount would hide your real media when it comes back. See Network Drives.

Trailarr always creates the trailer's own destination folder (for example a Trailers subfolder, or a custom folder from a profile). This setting is only about the media folder itself.

Force Full Files Scan

v0.9.1

  • Default is false
  • Environment variable: FILES_FULL_SCAN

When enabled, the next Scan Media Folders task run will scan every media folder in full, bypassing the folder-change optimisation that normally skips unchanged folders.

This is a one-shot fix for situations where download records or media_exists flags are stale (e.g. a trailer was deleted externally while the folder itself was not modified). Once the full scan completes, the setting is automatically reset to false — future scans resume the optimised behaviour.

Tip

You can also set FILES_FULL_SCAN=true as an environment variable or in your .env file and restart the app. The setting will reset itself after the first scan run.

Advanced Settings

These are advanced settings, if you don't know what they do, do not modify them!

Log Level

  • Default is Info

Select the logging level for the app logs to display in it's console. Available options are Debug, Info, Warning, Error.

Console logs only

Trailarr logs all logs in it's database (starting from v0.4.3), setting this will change what logs are reported by container to Docker.

Info

If you are having issues and need to troubleshoot or request help, set the log level to Debug to get more detailed logs.

Yt-dlp Cookies Path

  • Default is None

If you are having issues downloading trailers due to age restrictions, bot detection, etc., you can set the path to a file containing YouTube cookies. This will allow the app to use the cookies to bypass restrictions.

See Export YouTube Cookies.txt file for more info.

Tip

Use the 📁 (folder) icon to open a dialog that shows the container folders and files. Navigate to your cookies.txt file and confirm.

Warning

Make sure to save the cookies file in a secure location and map the volume to the container. Set the path to the file in this setting.

Do NOT use cookies with New Installations

If you are just setting up Trailarr, it is recommended to not use cookies initially for downloading trailers in bulk, as that might lead to your account being flagged for suspicious activity and YouTube placing a ban on your account. Instead, try downloading trailers without cookies first and then setup cookies once the bulk downloads are complete.

Alternatively, you can try setting up a new YouTube account and use cookies from that new account.

FFMPEG Timeout

v0.6.6

  • Default is 15 minutes. Minimum is 10. Maximum is 300.

Set the timeout (in minutes) for downloaded video conversions using FFMPEG. If FFMPEG takes longer than this time to complete an operation, it will be terminated.

Delete Trailer Settings

Delete downloaded trailers when media is removed from Radarr/Sonarr and optionally only if media files are deleted from disk.

On Deleting from Connection

v0.11.1

  • Default is false

Enable this setting to delete the downloaded trailers when media is removed from the connected Arr application. Since v0.11.1, this also applies to Plex-only media that is removed from the Plex library.

Warning

Enabling this setting will delete all downloaded trailers for media that is removed from the connected Arr application. Use with caution!

Only if Media Files Deleted

This setting works only if On Deleting from Connection is enabled.

  • Default is false

Enable this setting to delete the downloaded trailers only when the media files are deleted from disk.

Delete Corrupted Trailers

v0.6.7

  • Default is true

Enable this setting to allow the Trailer Cleanup task to automatically delete trailers that are found to be corrupted (e.g., missing audio or video streams).

Warning

Disabling this means corrupted files will remain on disk and may need to be manually removed. A Warning log will be generated for each corrupted file detected during the cleanup task.

Experimental Settings

These are experimental options, might not work as expected! You can enable them if you want to try. Please report any issues on Discord (recommended) or Github

AMD GPU Acceleration

  • Default is true

Enable this setting to use hardware acceleration for the conversion process by using the AMD GPU for encoding and decoding.

Note

This setting is available only if an AMD GPU is detected on the host system. For setup instructions, see Hardware Acceleration.

Intel GPU Acceleration

  • Default is true

Enable this setting to use hardware acceleration for the conversion process by using the Intel GPU for encoding and decoding.

Note

This setting is available only if an Intel GPU is detected on the host system. For setup instructions, see Hardware Acceleration.

NVIDIA GPU Acceleration

  • Default is true

Enable this setting to use hardware acceleration for the conversion process by using the NVIDIA GPU for encoding and decoding.

Note

This setting is available only if an NVIDIA GPU is detected on the host system. For setup instructions, see Hardware Acceleration.

Update Yt-dlp

  • Default is false

Enable this setting to update yt-dlp to the latest version on every app start. This will ensure that the app uses the latest features and bug fixes.

Yt-dlp Nightly Builds

v0.9.7

  • Default is false

Enable this setting to update yt-dlp to the latest nightly build instead of the latest stable release on every app start. Nightly builds contain the most recent commits and fixes but may be less stable than official releases.

Note

This setting is only available and has effect when Update Yt-dlp is also enabled.

Warning

Changing this setting requires a restart of the app (container) to take effect.

URL Base

v0.6.7

  • Default is (empty)

Enter the base URL of the app for use with subdirectory reverse proxies. This will allow the app to generate correct URLs when behind a reverse proxy.

Make sure to start the URL Base with a / and do not end it with a /. For example, use /trailarr instead of trailarr/ or /trailarr/.

The app will automatically format the URL Base to ensure it starts with a / and does not end with a /.

Note

If you are not using a subdirectory reverse proxy, leave this setting empty.

Warning

Changing this setting requires a restart of the app (container) to take effect.