HUB
Sign inSign up

ziixeu/ziix-tv

By ziixeu

•Updated about 7 hours ago

Your own media server for films and series. One price, everything included, no ads.

Image
0

444

ziixeu/ziix-tv repository overview

⁠ZiiX.TV

Your own media server for films and series. ZiiX.TV runs on your own machine, finds posters and descriptions for what you have, and plays it in the browser. Apps for Apple TV, iPhone and Android are on their way.

  • One price with everything included, no ads.
  • Your media and watch history stay on your server.
  • Users with their own watch history, "Continue watching" and watchlists.
  • Video is converted on the fly when a device cannot play a file as it is, on the CPU or on an NVIDIA graphics card.
  • Bring over what your users have watched in Plex or Emby.
  • Web interface in English and Danish.

Images for linux/amd64 and linux/arm64.

⁠Quick start

Make a folder for ZiiX.TV, and put this docker-compose.yml in it:

services:
  ziix-tv:
    image: ziixeu/ziix-tv:latest
    container_name: ziix-tv
    restart: unless-stopped
    ports:
      - "8470:8470"
    volumes:
      - ./config:/config
      - ${ZIIX_MEDIA:-./media}:/media:ro
      - ${ZIIX_PREVIEWS:-./previews}:/previews
    cap_drop: [ALL]
    cap_add: [CHOWN, FOWNER, DAC_OVERRIDE, SETUID, SETGID]
    security_opt:
      - no-new-privileges:true
    environment:
      PUID: ${PUID:-1000}
      PGID: ${PGID:-1000}
      TZ: ${TZ:-Europe/Copenhagen}
      ZIIX_TMDB_API_KEY: ${ZIIX_TMDB_API_KEY:-}
      ZIIX_TVDB_API_KEY: ${ZIIX_TVDB_API_KEY:-}
      ZIIX_TVDB_PIN: ${ZIIX_TVDB_PIN:-}
      ZIIX_METADATA_LANGUAGE: ${ZIIX_METADATA_LANGUAGE:-en-US}
      ZIIX_SCAN_INTERVAL: ${ZIIX_SCAN_INTERVAL:-15m}
      ZIIX_HWACCEL: ${ZIIX_HWACCEL:-auto}
      ZIIX_PREVIEW_DIR: /previews

Next to it, a .env file that says where your media is and which user may read it (id on the host shows your user and group numbers):

ZIIX_MEDIA=/path/to/media
PUID=1000
PGID=1000
TZ=Europe/Copenhagen
ZIIX_METADATA_LANGUAGE=en-US

Start it:

docker compose up -d

Open http://<your server>:8470, create the administrator, and add your libraries under Settings → Libraries: one for films, one for series, pointing at their folders under /media.

⁠Trial and license

A new server runs as a 30-day trial with everything included. To get posters and descriptions through ZiiX.TV during the trial, confirm your email address under Settings → Server; a code is mailed to you. There is one trial per email address.

Buy a license for the server under Settings → Server → Buy a license, yearly or monthly. The server renews its license key by itself every day. A key lasts two weeks, and the server keeps working a week past that, so a spell without internet does no harm. When the trial or license ends, nothing is deleted: libraries, users and watch history wait for you.

Payment goes through Stripe, and the subscription is managed in Stripe's customer portal, linked from the purchase page.

⁠Metadata

Posters, descriptions, cast and episode names come from TMDB and TheTVDB, fetched through ZiiX.TV's metadata service with your server's license. You need no keys of your own.

If you would rather use keys of your own, set ZIIX_TMDB_API_KEY (free from themoviedb.org) and/or ZIIX_TVDB_API_KEY (from thetvdb.com; with ZIIX_TVDB_PIN if it is a subscriber key) in .env. The server then talks to TMDB and TheTVDB directly.

⁠Folders

In the containerWhat
/configDatabase and settingsBack it up
/mediaYour films and seriesRead-only is enough
/previewsSeek-bar picturesCan be made again, but it takes hours for a big library

ZiiX.TV starts as root only to hand /config and /previews to PUID:PGID, then runs as that user with no privileges.

⁠Settings

VariableDefault
PUID, PGID1000User and group ZiiX.TV runs as; must be able to read /media
TZEurope/CopenhagenTime zone
ZIIX_METADATA_LANGUAGEen-USLanguage for titles and descriptions, e.g. da-DK, de-DE
ZIIX_SCAN_INTERVAL15mHow often libraries are checked for new and removed files; 0 turns it off
ZIIX_HWACCELautoauto uses an NVIDIA card when it works; off always uses the CPU
ZIIX_TMDB_API_KEYYour own TMDB key (optional)
ZIIX_TVDB_API_KEY, ZIIX_TVDB_PINYour own TheTVDB key (optional)
ZIIX_NAMEZiiX.TVName shown to the apps on your network
ZIIX_DISCOVERYonoff stops announcing the server on the local network

⁠NVIDIA graphics card

With the NVIDIA driver and the NVIDIA Container Toolkit on the host, give the container the card with an extra file, docker-compose.nvidia.yml:

services:
  ziix-tv:
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]
docker compose -f docker-compose.yml -f docker-compose.nvidia.yml up -d

Settings → Server shows whether the card is in use.

⁠Apps finding the server

The apps find ZiiX.TV on your network by themselves through Bonjour (mDNS). Multicast does not pass Docker's own network, so this needs network_mode: host (Linux) instead of the ports: mapping. Otherwise, give the app the server's address by hand.

⁠Updating

docker compose pull
docker compose up -d

latest is the newest release. To stay on one version, use its tag instead, e.g. ziixeu/ziix-tv:0.9.1. Take a copy of config before updating.

⁠Tags

  • latest: the newest release
  • 0.9.4: plain hyphens instead of long dashes in the web app's texts
  • 0.9.3: shared demo accounts (ZIIX_DEMO_USERS) that cannot be changed and are reset each night; dates in the license settings in the user's language
  • 0.9.2: the web app speaks English, Danish, German, French and Spanish, following the browser's language
  • 0.9.1: Settings → Devices shows who is logged in, on what, and what they play; a device can be logged out
  • 0.9.0: first public release (beta)

ZiiX.TV is made by ZiiX ApS, Denmark. https://ziix.tv⁠

Tag summary

Content type

Image

Digest

sha256:7834fd6f1…

Size

206.1 MB

Last updated

about 7 hours ago

docker pull ziixeu/ziix-tv