Skip to content

Profiles

Profiles allow you to define how and when trailers should be downloaded and processed in Trailarr.

Profiles are made up of two things:

  • Settings: Audio, Video, File and Search settings
  • Filters: Conditions that determine when the profile should be applied to a media item.

This might probably be too much information, you can skip to the Usage section to understand how profiles are used in Trailarr or directly to the Examples page.

You can create different profiles for different types of media or situations.

For example, you can create a profile for movies with high-quality trailers, another for series with specific audio settings, or a profile that only applies to media in a certain language.

Profiles are located in the Settings > Profiles page of the Trailarr app http://localhost:7889/settings/profiles.

Tip

The next sections will explain what each of the settings and filters do, how to create a profile, and how to use profiles in Trailarr.

View Profiles

A list of existing profiles can be viewed in the Profiles page.

Click on any of the profiles to view its details.

Create Profile

Clicking on the Add New button on the Profiles page will allow you to create a new profile.

  • A dialog will open where you can set the profile name, filters, and settings for the profile. Don't worry, you can change these settings later.
  • Once you are done, click on the Create button to create the profile.
  • This will take you to the profile settings page where you can edit the settings for the profile.

Not saved until you click Create

The profile is not saved until you click the Create button.

  • If you are trying to figure out what Filters to use, just add a Filter like ID > 999999 and then click Create.
  • This will create a profile with just one filter which you know will never match any media, which you can then edit later.

Edit Profiles

To edit an existing profile, click on the relevant profile in the Profiles page.

Edit Profile Name

To edit a profile name, click on the ✏️ (pencil) icon next to the profile name on the profile details page.

Edit the JSON directly

You can also edit the profile JSON directly by clicking on the Edit JSON button at the very end of the profile details page. This is useful for advanced users who want to edit the profile settings directly.

Duplicate Profile

You can duplicate a profile by clicking on the Duplicate button at the top right corner of the profile details page. This will open the Create Profile dialog, edit the name and click Create to create a new profile with the same settings as the original profile, which you can then edit as needed.

Delete Profiles

To delete a profile, open the Profile edit page and click on the Delete button at the top right corner.

Downloads are owned by the profile that made them

v0.10.0 Deleting a profile does not delete its downloaded trailers, but the ownership link is lost — its downloads show their profile as Deleted. If you later create a similar profile, the new profile does not own those downloads and will download its own trailers for all matching media. Prefer editing an existing profile over deleting and recreating it.

Usage

Trailarr uses profiles as follows:

  • When downloading a trailer from the UI. A dialog will appear allowing you to select a profile from existing profiles. Filters will not be applied in this case.
  • When running the Download Missing Trailers task (which runs periodically). v0.10.0
    • If no profiles are available, the task will not run.
    • The task finds all profiles that match all the filters for each monitored media item, in order of priority (highest first).
    • A matching profile only downloads if it does not already own a downloaded video for that media item. Downloads are tracked per profile — a profile that already has its video never downloads again, so media can stay monitored forever without being re-downloaded.
    • If a trailer already exists on disk that Trailarr is not tracking, the highest-priority matching profile claims it instead of downloading a duplicate.
    • Failed downloads back off before retrying: 1 day after the first failure, then 2 days, then 4, capped at weekly per media + profile. A successful download (including a manual one) resets the backoff.
    • Media items that do not match any profiles will not be processed.
    • Media items that match a profile but do not have a valid Media folder or have monitor set to false will not be processed.

The next sections will explain the settings and filters available in profiles. You can instead skip to the Examples page to see some examples of profiles and how they can be used.

Multiple Profiles - Multiple Downloads

You can create multiple profiles to download multiple videos for the same media item — each matching profile downloads (and keeps track of) its own video. For example, one profile for a Spanish trailer and another for an English trailer will download both for every media item that matches both profiles.

v0.10.0 Stop Monitoring is no longer needed for this workflow and is deprecated — see Stop Monitoring.

Trailarr is evolving

Trailarr is still evolving and the profiles feature is still being developed. If you have any suggestions or feedback, please join our Discord server and join the discussion.

Things that are planned for the future:

  • Improve Profiles to make downloading Season specific trailers easier.
  • Maybe (maybe, no promises!) let the user download Featurettes, Clips, etc. as well.