Torsher

Your home cinema in one container, built for the TV first

  • ghcr.io/torsher-app/torsher:1.5.2
  • v1.5.2
  • Updated 10 Nov 2026
  • port 6197
  • port 6198
  • port 6198
  • amd64 · arm64
  • Media
  • 88 stars

Screenshots

Torsher screenshot 1: TV showcase

Open the app

Control Panel

http://localhost:6197/panel/

TV Showcase

http://localhost:6197/

About Torsher

Torsher is a media center in one container: a catalog for your TV, playback while the file downloads, your own library and new episodes that arrive on their own. It does the jobs of a torrent client, a media server, series and movie managers and a request app. It connects to a Torznab indexer you run, like Prowlarr or Jackett; it includes no sources.

Features

  • Watch right away: Torsher finds releases and plays while the file downloads
  • Keep what you like in your library, laid out for Jellyfin, Plex and Kodi too
  • Follow a series and new episodes download by themselves
  • A TV showcase for LG webOS, Android TV and any browser, with profiles for the household
  • Converts files the TV can't play on the fly, on the GPU if there is one
  • Control panel for sources, storage, profiles, backups and notifications

How to use

  1. Open http://[ZIMAOS-IP-ADDRESS]:6197/panel/ and create the owner account.
  2. Follow the setup wizard. Connect your indexer, like Prowlarr, with its address and API key.
  3. Open http://[ZIMAOS-IP-ADDRESS]:6197/ on your TV or in a browser, and connect it with the code under Profiles and devices.

Before you install

Torsher needs a Torznab indexer, like Prowlarr or Jackett, installed first; add only the indexers you are allowed to use. There is no password to set: the first person to open /panel/ creates the owner account. Downloads, the watch cache and your library all live in the data folder, so kept files are hard-linked instead of copied; /DATA/Media is available read-only at /media/zimaos for the movies and series you already have. Forward port 6198 (TCP and UDP) on your router for faster downloads. Hardware transcoding needs /dev/dri added as a device in the app settings. The other settings are in the Variables tab; most things are set in the control panel instead.

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. It is filled in from your ZimaOS time zone. Leave it unless you need another.
ENGINE_PEER_PORT6198The port torrent peers connect to. It must be the same number inside and outside the container. Leave it at 6198, and forward 6198 on your router for faster downloads.

Files

VariableDefault valueDescription
PUID1000The user that owns the files Torsher writes. Leave it out to use 1000, the usual ZimaOS user. Never set it to an empty value.
PGID1000The group that owns the files Torsher writes. Leave it out to use 1000.

Catalog

VariableDefault valueDescription
TMDB_ACCESS_TOKEN—Your own TMDB API Read Access Token for the catalog, instead of the key built into the image. A key set in the panel wins over both.

Security

VariableDefault valueDescription
TORSHER_SECRET—The key that encrypts saved indexer keys and notification tokens. Leave it out: Torsher makes db/secret.key itself on first start. Keep that file with your backups.
TRUST_PROXY—Only behind a reverse proxy: its address or subnet, like 172.18.0.0/16, so sign-in limits see each person's own address.

Network

VariableDefault valueDescription
HTTPS_PROXY—A proxy for outgoing requests, like http://192.168.1.5:3128, until you set routes in the panel under Settings, Network.

Logs

VariableDefault valueDescription
LOG_LEVELinfoerror, warn, info or debug.
docker-compose.yml
name: torsher

services:
  torsher:
    image: ghcr.io/torsher-app/torsher:1.5.2
    container_name: torsher
    restart: unless-stopped
    stop_grace_period: 40s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - ENGINE_PEER_PORT=6198
    ports:
      - target: 8080
        published: "6197"
        protocol: tcp
      - target: 6198
        published: "6198"
        protocol: tcp
      - target: 6198
        published: "6198"
        protocol: udp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/Media
        target: /media/zimaos
        read_only: true
        bind:
          create_host_path: true
    deploy:
      resources:
        limits:
          cpus: "4.00"
          memory: 2048M
        reservations:
          cpus: "0.10"
          memory: 256M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/torsher/icon.png
    x-casaos:
      id: com.icestore.torsher
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
              Leave it unless you need another.
        - container: ENGINE_PEER_PORT
          description:
            en_US: >-
              The port torrent peers connect to. It must be the same number
              inside and outside the container. Leave it at 6198, and forward
              6198 on your router for faster downloads.
      ports:
        - container: "8080"
          description:
            en_US: Torsher showcase (/), control panel (/panel/) and API, published on host as 6197
        - container: "6198"
          description:
            en_US: Torrent peer connections, TCP and UDP, published on host as 6198
      volumes:
        - container: /data
          description:
            en_US: >-
              The database and its keys (db/), downloads and the watch cache
              (torrents/) and the files you keep (library/). Keep them in this
              one folder so kept files are hard-linked, not copied.
        - container: /media/zimaos
          description:
            en_US: >-
              Your existing movies and series, read-only. Add the folders
              inside it in the control panel under Library.

x-casaos:
  id: com.icestore.torsher
  architectures:
    - amd64
    - arm64
  main: torsher
  author: HSinghHira
  category: Media
  developer: torsher-app
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/torsher/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/torsher/screenshot-1.jpg
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/torsher/screenshot-1.jpg
  title:
    en_US: Torsher
  tagline:
    en_US: Your home cinema in one container, built for the TV first
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/torsher/](https://icestore.hsinghhira.me/app/torsher/) for full details


      Torsher is a media center in one container: a catalog for your TV,
      playback while the file downloads, your own library and new episodes
      that arrive on their own. It does the jobs of a torrent client, a media
      server, series and movie managers and a request app. It connects to a
      Torznab indexer you run, like Prowlarr or Jackett; it includes no
      sources.


      **Features**


      - Watch right away: Torsher finds releases and plays while the file
        downloads

      - Keep what you like in your library, laid out for Jellyfin, Plex and
        Kodi too

      - Follow a series and new episodes download by themselves

      - A TV showcase for LG webOS, Android TV and any browser, with
        profiles for the household

      - Converts files the TV can't play on the fly, on the GPU if there is
        one

      - Control panel for sources, storage, profiles, backups and
        notifications


      **How to use?**


      1. Open http://[ZIMAOS-IP-ADDRESS]:6197/panel/ and create the owner
         account.


      2. Follow the setup wizard. Connect your indexer, like Prowlarr, with
         its address and API key.


      3. Open http://[ZIMAOS-IP-ADDRESS]:6197/ on your TV or in a browser,
         and connect it with the code under Profiles and devices.
  tips:
    before_install:
      en_US: >-
        1. Torsher needs a Torznab indexer, like Prowlarr or Jackett. Install
           one first, and add only the indexers you are allowed to use.


        2. Start the installation.


        3. Open http://[ZIMAOS-IP-ADDRESS]:6197/panel/, like
           http://192.168.1.20:6197/panel/.


        4. Create the owner account. The first person to open the panel
           makes it.


        5. Follow the setup wizard. It asks for your indexer's address and
           API key.


        6. Open http://[ZIMAOS-IP-ADDRESS]:6197/ on your TV or in a browser.
           Type the code it shows in the panel under Profiles and devices,
           Connect a device.


        7. For faster downloads, forward port 6198 (TCP and UDP) on your
           router to your ZimaOS box.
  index: /panel/
  port_map: "6197"
  scheme: http
  is_uncontrolled: false
  version: "1.5.2"
  update_at: "2026-11-10"
  release_notes:
    en_US: |-
      - First IceStore version: ghcr.io/torsher-app/torsher 1.5.2
      - Web on 6197, torrent peers on 6198 (TCP and UDP, same number inside and outside)
      - /DATA/Media is available read-only at /media/zimaos for your existing library
      - Fixed: Torsher did not start when ZimaOS passed an empty PUID/PGID ("setpriv: failed to parse reuid"). They are left out now, so the files belong to user 1000:1000; add PUID and PGID in the app settings to choose another owner.
  repo: "https://github.com/torsher-app/torsher"
  support: "https://github.com/torsher-app/torsher/issues"
  docs: "https://torsher.app/docs/"

Install Torsher

Something not working with Torsher?

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

More Media apps

See all