Now that there are a host of excellent Docker-based extensions for Channels DVR, @mjitkop and @bnhf thought it was about time we had an excellent way to install them! Specifically, an all-in-one "one-click" approach that would spin-up the container and do the Custom Channels setup as well.
OliveTin and Portainer were perfect for this project, and are prerequisites. OliveTin provides the user interface for the minimal set of values you need to provide and Portainer, with its API, allows for the creation of a stack that can be modified in the future if needed. A CDVR Custom Channels source is created with a custom starting channel number (if desired), and guide data is downloaded.
From that first click in OliveTin, to watching TV using your new source is typically a matter of a few minutes. No searching the forum for the bits and pieces need to get it running.
The following extensions are currently supported:
- ADBTuner
- ah4c
- cc4c
- EPlusTV
- Filebot
- FrndlyTV-for-Channels
- MediaInfo
- MLB.tv-for-Channels
- Organizr
- Plex-for-Channels
- Pluto-for-Channels
- Samsung-TVPlus-for-Channels
- Stirr-for-Channels
- Tubi-for-Channels
- VLC-Bridge-Fubo
- VLC-Bridge-PBS
- Watchtower
Here are few images of the process for FrndlyTV:
OliveTin Actions menu:
FrndlyTV Action button:
OliveTin "stdout" showing success with the stack and custom channels source creation:
The new frndlytv-for-channels Docker container up-and-running:
The Channels DVR Custom Channels setup (including the special two source setup for FrndlyTV) done for you, with guide data on its way:
And, the guide populated:
Watching FrndlyTV:
Elapsed time -- maybe two minutes!
To get this going for yourself, you'll need to install Portainer and OliveTin. In addition, you'll need to create a Portainer API Token:
OliveTin installation described here:
Portainer API Token is just a couple of steps. First go to My account:
Next create a token with the name OliveTin, and copy it -- this is the only time you'll see it:
Your OliveTin Portainer-Stack requires a couple of new environment variables, PORTAINER_TOKEN and PORTAINER_HOST:
version: '3.9'
services:
olivetin: # This docker-compose requires little or no editing. Set the variables in the Environment section of Portainer-Stacks.
# GitHub home for this project: https://github.com/bnhf/OliveTin
# Docker container home for this project with setup instructions: https://hub.docker.com/repository/docker/bnhf/olivetin
image: bnhf/olivetin:${TAG} # Add the tag like latest or test to the environment variables below
container_name: olivetin
hostname: olivetin
dns_search: ${DOMAIN} # For Tailscale users using Magic DNS, add your Tailnet (tailxxxxx.ts.net) to use hostnames for remote nodes, otherwise use your local domain name
ports:
- ${HOST_PORT}:1337
environment:
- CHANNELS_DVR=${CHANNELS_DVR_HOST}:${CHANNELS_DVR_PORT} # Add your Channels DVR server in the form CHANNELS_DVR_HOST=<hostname or ip> and CHANNELS_DVR_PORT=<port>
- CHANNELS_DVR_ALTERNATES=${CHANNELS_DVR_ALTERNATES} # Space separated list of alternate Channels DVR servers to choose from in the form hostname:port or ip:port
- CHANNELS_CLIENTS=${CHANNELS_CLIENTS} # Space separated list of Channels DVR clients you'd like notifications sent to in the form hostname or IP
- UPDATE_YAMLS=${UPDATE_YAMLS} # Set this to true to update config.yaml
- UPDATE_SCRIPTS=${UPDATE_SCRIPTS} # Set this to true to update all included scripts
- TZ=${TZ} # Add your local timezone in standard linux format. E.G. US/Eastern, US/Central, US/Mountain, US/Pacific, etc
- PORTAINER_TOKEN=${PORTAINER_TOKEN} # Generate via <username> dropdown (upper right of WebUI), "My account", API tokens
- PORTAINER_HOST=${PORTAINER_HOST} # Hostname or IP of the Docker host you're running Portainer on.
volumes:
- ${HOST_DIR}/olivetin:/config # Add the parent directory on your Docker you'd like to use
- ${DVR_SHARE}:/mnt/${CHANNELS_DVR_HOST}-${CHANNELS_DVR_PORT} # This can either be a Docker volume or a host directory that's connected via Samba or NFS to your Channels DVR network share
#- ${DVR2_SHARE}:/mnt/remote-server-8089 # Note that these volume mounts should always be to /mnt/hostname-port or /mnt/ip-port (dash rather than a colon between)
restart: unless-stopped
static-file-server:
image: halverneus/static-file-server:latest
container_name: static-file-server
dns_search: ${DOMAIN}
ports:
- ${HOST_SFS_PORT}:8080
environment:
- FOLDER=${FOLDER}
volumes:
- ${HOST_DIR}/olivetin/data:${FOLDER}
restart: unless-stopped
#volumes: # use this section if you've setup a docker volume named channels-dvr, with CIFS or NFS, to bind to /mnt/dvr inside the container. Set ${HOST_DIR} to channels-dvr (HOST_DIR=channels_dvr) in that example
#channels-dvr:
#external: true
Sample env vars:
TAG=latest
DOMAIN=tailxxxxx.ts.net
HOST_PORT=1337
CHANNELS_DVR_HOST=local-server
CHANNELS_DVR_PORT=8089
CHANNELS_DVR_ALTERNATES=another-server:8089
CHANNELS_CLIENTS=appletv4k-den firestick-bedroom
UPDATE_YAMLS=true
UPDATE_SCRIPTS=true
TZ=US/Mountain
HOST_DIR=/data
DVR_SHARE=/mnt/dvr
HOST_SFS_PORT=8080
FOLDER=/web
PORTAINER_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
PORTAINER_HOST=docker-host