Migrate from V1 to V2

You're probably here because you just updated the docker container and realized it's no longer working. This is because the config file, and the way this application connects to your devices has changed.

The changes

• iSponsorBlockTV now supports every YouTube TV client, not just the Apple TV one. This means that you can now use this with many other devices, like smart TV's and consoles.
• Your target device and server don't have to be on the same network anymore. This now works over the internet.
• The config file has changed location. You will need to update it.
• A YouTube API key is now only required if you want to use the channel whitelist feature. If you don't want to use it, you can leave it blank.
• When running this program, you won't be able to view YouTube shorts. This is a limitation made by YouTube, and there's nothing I can do about it.

How to migrate

1 Config file is now stored in data directory:

To avoid issues with mounting bare files on docker, and to allow having more files in the future, the config file is now stored in a directory called data. If you're using docker, you'll need to change the mount path to /app/data. See below for a full example.

Warning: you'll need to add ALL your devices again since the method of connecting to them has changed.

2.1 Using the new graphical configurator tool:

You can use the graphical setup wizard (powered by textual). It will guide you through the process of setting up the new config file. Docker users can run it with the following command:

docker run --rm -it \
-v /PATH_TO_YOUR_DATA_DIR:/app/data \
ghcr.io/dmunozv04/isponsorblocktv \
--setup

2.2 Using the cli configurator tool:

Docker users can run it with the following command:

docker run --rm -it \
-v /PATH_TO_YOUR_DATA_DIR:/app/data \
ghcr.io/dmunozv04/isponsorblocktv \
--setup-cli

3.1 Run the container with docker-compose:

version: '3.3'
services:
    iSponsorBlockTV:
        image: ghcr.io/dmunozv04/isponsorblocktv
        container_name: iSponsorBlockTV
        restart: unless-stopped
        volumes:
        - /PATH_TO_YOUR_DATA_DIR:/app/data

3.2 Run the container with docker run:

The container doesn't need the --net=host flag anymore, so you can run it like this:

docker run -d \
--name iSponsorBlockTV \
--restart=unless-stopped \
-v /PATH_TO_YOUR_DATA_DIR:/app/data \
ghcr.io/dmunozv04/isponsorblocktv