Youtarr

Downloads and organizes YouTube channels on a schedule for your media server

  • ghcr.io/hsinghhira/youtarr:latest
  • v1.93.0
  • Updated 20 Nov 2026
  • port 6755
  • amd64 · arm64
  • Media
  • 1.8k stars

Screenshots

Youtarr screenshot 1: HomeYoutarr screenshot 2: ChannelsYoutarr screenshot 3: VideosYoutarr screenshot 4: Playlists

Open the app

Web UI

http://localhost:6755/

About Youtarr

Youtarr downloads videos from the YouTube channels you pick, on a schedule, and files them so Plex, Jellyfin, Emby or Kodi show them like TV shows. MariaDB is built in, so it is one container.

Features

  • Subscribe to channels and get new videos on a schedule
  • Download single videos or playlists by pasting a link
  • Pick the quality, and skip Shorts or live streams
  • Saves thumbnails and info files your media server reads
  • Refreshes your Plex library when new videos land
  • Clean-up rules and notifications

How to use

  1. Open Youtarr from your dashboard.
  2. Sign in as admin with the password from the app's logs (the box marked CREDENTIALS).
  3. Go to Channels and add a channel link.
  4. Videos land in /DATA/Media/YouTube. Add that folder to your media server as a TV or Other Videos library.

Before you install

Videos go to /DATA/Media/YouTube; change the folder if you want them elsewhere. The admin password is made on first start and shown in the app's logs in the box marked CREDENTIALS; to use your own, set AUTH_PRESET_PASSWORD in the app settings. Open it from other devices at http://[ZIMAOS-IP-ADDRESS]:6755. More settings are in the Variables tab; add them in the app settings. The first start takes about 2 minutes.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. Scheduled downloads and nightly clean-up run by it. It is filled in from your ZimaOS time zone.

Sign-in

VariableDefault valueDescription
AUTH_PRESET_USERNAMEadminThe admin's user name, 1 to 32 characters.
AUTH_PRESET_PASSWORD—Your own admin password, 8 to 64 characters. Leave it out to keep the one made on first start (shown in the CREDENTIALS box).
AUTH_ENABLEDtrueSet to false only when Youtarr sits behind another sign-in, like a VPN or a reverse proxy with its own login.

Features

VariableDefault valueDescription
EXTERNAL_API_ENABLEDfalseSet to true to turn on the external API (it always needs an API key).
YOUTARR_COOKIES_FILE—A YouTube cookies file Youtarr reads, like /app/config/cookies.external.txt. Put the file in /DATA/AppData/youtarr/data/youtarr/config and turn on Cookies in Settings.

Server

VariableDefault valueDescription
TRUST_PROXY—Set to 1 or your proxy's network when a reverse proxy sends the real client address; false when there is none.
OUTPUT_DIR_HEALTHCHECK_TIMEOUT—How long the health check waits for the videos folder, in milliseconds. Raise it for a slow network share.

Logs

VariableDefault valueDescription
LOG_LEVELinfowarn, info or debug.
LOG_FILE_MAX_SIZE—The largest a log file gets before a new one starts.
LOG_FILE_MAX_COUNT—How many old log files to keep.
docker-compose.yml
name: youtarr

services:
  youtarr:
    image: ghcr.io/hsinghhira/youtarr:latest
    container_name: youtarr
    restart: unless-stopped
    stop_grace_period: 60s
    privileged: true
    environment:
      - TZ=$TZ
    ports:
      - target: 8080
        published: "6755"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/Media/YouTube
        target: /videos
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://127.0.0.1:8080/api/health"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 180s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 2048M
        reservations:
          cpus: "0.10"
          memory: 256M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/youtarr/icon.png
    x-casaos:
      id: com.icestore.youtarr
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. Scheduled downloads and nightly clean-up run
              by it. It is filled in from your ZimaOS time zone.
      ports:
        - container: "8080"
          description:
            en_US: Youtarr web UI and API, published on host as 6755
      volumes:
        - container: /data
          description:
            en_US: >-
              The MariaDB database (channels, videos, jobs), Youtarr's
              config, job files and thumbnails, and state/secrets.env. Back
              it up.
        - container: /videos
          description:
            en_US: >-
              Where downloaded videos go, one folder per channel. Add
              /DATA/Media/YouTube to Plex, Jellyfin, Emby or Kodi.

x-casaos:
  id: com.icestore.youtarr
  architectures:
    - amd64
    - arm64
  main: youtarr
  author: HSinghHira
  category: Media
  developer: DialmasterOrg
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/youtarr/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/youtarr/screenshot-1.jpg
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/youtarr/screenshot-1.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/youtarr/screenshot-2.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/youtarr/screenshot-3.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/youtarr/screenshot-4.jpg
  title:
    en_US: Youtarr
  tagline:
    en_US: Downloads and organizes YouTube channels on a schedule for your media server
  description:
    en_US: >-
      Youtarr downloads videos from the YouTube channels you pick, on a
      schedule, and files them so Plex, Jellyfin, Emby or Kodi show them like
      TV shows. MariaDB is built in, so it is one container.


      **Features**


      - Subscribe to channels and get new videos on a schedule

      - Download single videos or playlists by pasting a link

      - Pick the quality, and skip Shorts or live streams

      - Saves thumbnails and info files your media server reads

      - Refreshes your Plex library when new videos land

      - Clean-up rules and notifications


      **How to use?**


      1. Open Youtarr from the ZimaOS dashboard.

      2. Sign in as admin with the password from the app's logs (the box
         marked CREDENTIALS).

      3. Go to Channels and add a channel link.

      4. Videos land in /DATA/Media/YouTube. Add that folder to your media
         server as a TV or Other Videos library.
  tips:
    before_install:
      en_US: >-
        1. Videos go to /DATA/Media/YouTube. Change it if you want them
           somewhere else.


        2. More settings, like your own admin password and the YouTube
           cookies file, are listed on the Youtarr page at
           https://icestore.hsinghhira.me/app/youtarr/ (Variables tab). You
           can add them now or later in the app settings.


        3. Start the installation. The first start takes about 2 minutes.


        4. Open the app's logs. Find the box marked CREDENTIALS. It has the
           admin name and password.


        5. Open http://[ZIMAOS-IP-ADDRESS]:6755 and sign in.
  index: /
  port_map: "6755"
  scheme: http
  is_uncontrolled: false
  version: "v1.93.0"
  update_at: "2026-11-20"
  release_notes:
    en_US: |-
      - First IceStore release, on port 6755
      - All in one container: dialmaster/youtarr v1.93.0, MariaDB and an nginx gateway
      - Each install makes its own database and admin passwords on first start
      - Videos are saved to /DATA/Media/YouTube
  repo: "https://github.com/DialmasterOrg/Youtarr"
  support: "https://github.com/DialmasterOrg/Youtarr/issues"
  docs: "https://github.com/DialmasterOrg/Youtarr/tree/main/docs"

Install Youtarr

Something not working with Youtarr?

Report it so it gets fixed, or ask for an app that is not here yet.

More Media apps

See all