Tentacle TV

Auto-updates built-in via Tauri updater.

Install Tentacle TV on your Android TV, Google TV or NVIDIA Shield with the free Downloader app — no computer needed.

Step-by-step installation

1. 1

   Install the Downloader app

   On your TV home screen, open the Play Store, search for Downloader (by AFTVnews) and install it. It is free.

   
2. 2

   Enter the code

   Open Downloader, select the address bar at the top, type the code 3022864 and press Go.

   
3. 3

   Let it download

   The code opens the link and Downloader automatically downloads the Tentacle TV file (about 160 MB).

   
4. 4

   Allow the installation

   A message says your TV isn’t allowed to install from this source. Press Settings — no need to change anything beforehand, Downloader takes you there.

   
5. 5

   Turn on Downloader

   In the list, switch Downloader to ON, then press the Back button on your remote to return.

   
6. 6

   Install the app

   Confirm by pressing Install and wait a few seconds.

   
7. 7

   Open Tentacle TV

   Press Open — Tentacle TV launches on your TV, ready to pair with your server.

   
8. 8

   Find it again later

   Tentacle TV is now in the Apps (or Applications) tab of your TV. On some models, long-press it and add it to favourites to pin it on the home screen.

   

The download link always points to the latest version — the code never changes.

The fastest way to get Tentacle TV running. Copy, paste, done.

services:
  db:
    image: mariadb:11
    container_name: tentacle-db
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: tentacle_db
      MYSQL_USER: tentacle_user
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - tentacle-db-data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5

  web:
    image: ghcr.io/knaox/tentacle-tv:latest
    container_name: tentacle-tv
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    environment:
      DATABASE_URL: mysql://tentacle_user:${MYSQL_PASSWORD}@db:3306/tentacle_db
      JWT_SECRET: ${JWT_SECRET}
      PORT: "3000"
      HOST: "0.0.0.0"
    volumes:
      - tentacle-data:/app/apps/backend/data
    ports:
      - "3000:3000"

volumes:
  tentacle-db-data:
  tentacle-data:

docker compose up -d

services:
  web:
    image: ghcr.io/knaox/tentacle-tv:latest
    container_name: tentacle-tv
    restart: unless-stopped
    environment:
      JWT_SECRET: ${JWT_SECRET}
      PORT: "3000"
      HOST: "0.0.0.0"
    volumes:
      - tentacle-data:/app/apps/backend/data
    ports:
      - "3000:3000"

volumes:
  tentacle-data:

docker compose -f docker-compose.external.yml up -d

Jellyfin URL and API key are configured through the web setup wizard and stored in the database.