Common

Download Trailer in Specific Language

If you want trailers to be downloaded in a specific language, you can use the below steps to instruct Trailarr to try searching for trailers in that language.

Note

This is not a foolproof method as it depends on multiple factors like:

• availability of the trailer in that language on YouTube
• YouTube returning that result when searched using the search query
• whether it matches the other filters like duration, quality, etc.

To do this, navigate to Settings > Trailer > Advanced and change the following settings:

• Trailer Always Search to True.

  Info

  This setting will tell Trailarr to not use the YouTube trailer id from Radarr/Sonarr. Instead, it will search for the trailer based on the YouTube Search Query setting.

• YouTube Search Query to the specify desired language like {title} {year} {is_movie} French trailer.

  Info

  The {title}, {year}, {is_movie} are placeholders that will be replaced with the actual values. The language can be any language like French, Spanish, German, etc.

Once you have updated these settings, any trailers downloaded afterwards will be searched using the new search query.

Warning

This will not impact any trailers that have already been downloaded.

YouTube Cookies

If you are having issues downloading trailers due to age restrictions, bot detection, etc., you can save your YouTube cookies and set the Yt-dlp Cookies Path to cookies.txt file containing YouTube cookies. This will allow the app to use the cookies to bypass restrictions.

YouTube rotates cookies frequently on open YouTube browser tabs as a security measure. To export cookies that will remain working with yt-dlp, you will need to export cookies in such a way that they are never rotated.

Note

This is a hack to bypass YouTube restrictions and it might not always work. There is nothing Trailarr can do in those situations.

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. 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.

Export YouTube Cookies.txt file

The suggested way to get the cookies file is:

1. Open Firefox/Chrome browser.

2. Install a cookies exporter extension like Chrome: Get Cookies.txt locally or Firefox: Get Cookies.txt locally or any other cookies exporter extension.

   Extension in Incognito/Private Mode

   You might need to open your browser extension settings and allow the extension to work in incognito/private mode.

3. Open an incognito/private browsing window and login to Youtube.

4. Open a new tab and close the YouTube tab.
5. Export the cookies to a file say cookies.txt by setting Export Format to Netscape.
6. Then close the private browsing/incognito window so the session is never opened in the browser again.
7. Save/Copy that cookies file to Trailarr App data folder. For example, if you mapped /var/appdata/trailarr to /config in the container, save the cookies file in /var/appdata/trailarr folder.
8. Now open Trailarr in browser and navigate to Settings > Trailer. Under Advanced settings, set Yt-dlp Cookies Path to /config/cookies.txt (if you saved the file in /var/appdata/trailarr folder).
9. Any new trailers downloaded will use the cookies to bypass restrictions.

See below for more info regarding youtube downloaders and cookies:

• Yt-dlp: Exporting YouTube cookies and How do I pass cookies to yt-dlp?.
• Youtube-dl: How do I pass cookies to youtube-dl?

Warning

Make sure to save the cookies file in a secure location and map the volume to the container. Set the path to the cookies file in Yt-dlp Cookies Path setting.

Coookies not working

Sometimes the cookies might not work right away. You can try the following steps to troubleshoot:

1. Open Trailarr container shell and check if the cookies file is accessible.
2. Check the permissions of the cookies file. It should be readable and writable by the app.

3. Run the below command to try and download a trailer using the cookies file and watch out for any errors:

   yt-dlp -v --cookies /config/cookies.txt YOUTUBE_URL
   

   Replace YOUTUBE_URL with the actual video URL. If the download works, then the cookies file is working fine.

4. If the download fails, then the cookies file might be invalid or expired. You can try exporting the cookies again and retry the above steps.

5. If the download works with the above command, then restart the container and try downloading trailers again.
6. If the issue still persists, you can hop on to the Discord server for further help.

Windows Docker Desktop Users

Known Issue - File Access Slowness and Workaround

Windows users of Docker Desktop often experience slow read/write speeds when using volume mounts. This is a known limitation of file sharing between the Windows host and Docker containers.

Relevant threads discussing this issue: - File access in mounted volumes extremely slow - Performance volume mount

Docker Compose Example for Windows Users

Below is an example Docker Compose configuration optimized for Windows users:

services:
  trailarr:
    image: nandyalu/trailarr:latest
    container_name: trailarr
    environment:
      - TZ=America/Chicago
    ports:
      - 7889:7889
    volumes:
      - trailarr_data:/config # volume for app data, the first part `trailarr_data` is the volume name
      - M:\Movies:/m/movies   # Movies drive
      - R:\TV:/r/tv           # TV series drive 1
      - S:\TV:/s/tv           # TV series drive 2
      - T:\TV:/t/tv           # TV series drive 3
    restart: unless-stopped

volumes:
  trailarr_data:  # volume name, should match the volume name in the service
    # Any extra options for the volume if needed

More information on Docker Volumes can be found in the Docker documentation.

Path Mappings in Trailarr

To properly map your paths in Trailarr, you need to add Path Mappings in the connections that use the above drives.

For example, if you have Radarr connection that only uses the M:\Movies drive, you can add the following Path Mapping:

Path From     Path To
M:\Movies\    /m/movies/

Similarly, for Sonarr connections that use R:\TV, S:\TV, and T:\TV, you can add the following Path Mappings:

Example Path Mappings:

Path From     Path To
R:\TV\        /r/tv/
S:\TV\        /s/tv/
T:\TV\        /t/tv/

Copying cookies.txt to the Docker Volume

If you need to add a cookies.txt file (for YouTube age verification), you can copy it directly into the container's volume. Follow these steps:

Steps to Copy cookies.txt to the Docker Volume

1. Run the Container (if not already running): Make sure the container is running.

2. Copy the File to the Container's Volume: Use the docker cp command to copy the file from your host machine to the container's /config directory:

   docker cp "C:\docker\trailarr\config\cookies.txt" trailarr:/config/cookies.txt
   

3. "C:\docker\trailarr\config\cookies.txt": Path to the file on your host machine.

4. trailarr:/config/cookies.txt: Destination path in the container.

5. Verify the File Exists: Confirm the file was copied successfully by checking the /config directory in the container:

   docker exec -it trailarr ls /config
   

   You should see cookies.txt listed.

Notes

• The /config directory inside the container is backed by the trailarr_data volume. Once the file is in the volume, it will persist even if you recreate the container.
• If the file path or permissions cause issues, ensure the cookies.txt file on your host machine is accessible and readable.