### Setup iSponsorBlockTV

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

Run the setup command for iSponsorBlockTV to generate the configuration file.

```bash
main.py --setup
```

--------------------------------

### Run iSponsorBlockTV Setup (Graphical)

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

Execute this command to launch the graphical setup wizard for iSponsorBlockTV. This requires the textual library.

```Shell
isponsorblocktv --setup
```

--------------------------------

### Install iSponsorBlockTV with uv

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

Use this command to install iSponsorBlockTV if you have uv installed. uv manages dependencies and Python environments.

```Shell
uv tool install isponsorblocktv
```

--------------------------------

### Run iSponsorBlockTV Application

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

This command starts the iSponsorBlockTV application after installation.

```Shell
iSponsorBlockTV
```

--------------------------------

### Run iSponsorBlockTV Setup (CLI)

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

Use this command for a text-based command-line interface setup of iSponsorBlockTV, useful if the graphical configurator has issues.

```Shell
isponsorblocktv --setup-cli
```

--------------------------------

### Install iSponsorBlockTV with pipx

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

Use this command to install iSponsorBlockTV if you have pipx installed. pipx manages Python applications and their dependencies.

```Shell
pipx install isponsorblocktv
```

--------------------------------

### Run CLI Setup Tool with Docker

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Migrate-from-V1-to-V2

Execute this command to launch the command-line interface (CLI) setup tool for the new configuration file via Docker. Remember to substitute '/PATH_TO_YOUR_DATA_DIR' with the correct path to your data directory.

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

--------------------------------

### Run Graphical Setup Wizard with Docker

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Migrate-from-V1-to-V2

Use this command to run the graphical setup wizard for the new configuration file when using Docker. Ensure you replace '/PATH_TO_YOUR_DATA_DIR' with your actual data directory path.

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

--------------------------------

### Install Python Dependencies

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

Use pip to install project dependencies from the requirements.txt file. Ensure Python 3.11 or higher is installed and in your PATH.

```bash
python3 -m pip install -r requirements.txt
```

```bash
python -m pip install -r requirements.txt
```

--------------------------------

### Example systemctl status output

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

This is an example of the output you might see when checking the status of the iSponsorBlockTV service, indicating it is active and running.

```Shell
● isponsorblocktv.service - isponsorblocktv background service
     Loaded: loaded (/etc/systemd/system/isponsorblock.service; enabled; preset: enabled)
     Active: active (running) since Thu 2026-01-08 00:06:09 MST; 8h ago
 Invocation: a68e17cbb6da43318f07b23d54fa1775
   Main PID: 7266 (iSponsorBlockTV)
      Tasks: 3 (limit: 163)
        CPU: 53.884s
     CGroup: /system.slice/isponsorblock.service
             └─7266 /home/pi/.local/share/uv/tools/isponsorblocktv/bin/python /home/pi/.local/bin/iSponsorBlockTV

Jan 08 08:20:17 pi iSponsorBlockTV[7266]: 2026-01-08 08:20:17,000 - iSponsorBlockTV-ppmi1vccl8tsfbpl5j347h2oj5 - INFO ->
Jan 08 08:24:52 pi iSponsorBlockTV[7266]: 2026-01-08 08:24:52,629 - iSponsorBlockTV-ppmi1vccl8tsfbpl5j347h2oj5 - INFO ->
```

--------------------------------

### Enable iSponsorBlockTV Service on Boot

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

This command configures the iSponsorBlockTV service to start automatically every time the system boots up.

```Shell
systemctl enable isponsorblocktv.service
```

--------------------------------

### Start iSponsorBlockTV Service

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

This command starts the iSponsorBlockTV service for the current session.

```Shell
systemctl start isponsorblocktv.service
```

--------------------------------

### Run Graphical Configurator with Docker

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

Use this command to run the graphical setup wizard. Ensure the data directory is correctly mapped. The `--net=host` flag is required for auto-discovery on Linux.

```Shell
docker run --rm -it \
-v /PATH_TO_YOUR_DATA_DIR:/app/data \
--net=host \
# Remove line on windows and macOS
-e TERM=$TERM -e COLORTERM=$COLORTERM \
#Remove if you get errors/graphical glitches
ghcr.io/dmunozv04/isponsorblocktv \
--setup
```

--------------------------------

### Systemd Service Configuration for iSponsorBlockTV

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

This is the content for the iSponsorBlockTV systemd service file. It defines how the service runs, restarts, and starts on boot. Ensure 'ExecStart' points to the correct executable path.

```Systemd
[Unit]
Description=isponsorblocktv background service
# Start after basic system initialization and networking are available
After=network.target multi-user.target

[Service]
Type=simple
# Path to your shell script (check your path with: which iSponsorBlockTV)
ExecStart=/home/pi/.local/bin/iSponsorBlockTV
# Ensure the service restarts if it fails
Restart=on-failure
# Wait 10 second before attempting a restart
RestartSec=10
# Optional: specify a user to run the service as (defaults to root if none specified, my user is called pi)
User=pi
StandardOutput=journal

[Install]
# Enable the service to start automatically at boot
WantedBy=multi-user.target
```

--------------------------------

### Run iSponsorBlockTV Service with Docker Run

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

This command starts the iSponsorBlockTV container in detached mode. The `--net=host` flag is not required for this method.

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

--------------------------------

### Create systemd Service File for iSponsorBlockTV

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

This command opens the systemd service file for iSponsorBlockTV in the nano editor. You will paste the service configuration into this file.

```Shell
sudo nano /etc/systemd/system/isponsorblocktv.service
```

--------------------------------

### Run Main Script

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

Execute the main Python script to run the application.

```bash
main.py
```

--------------------------------

### Run Configurator with Docker Compose

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

After defining the service in docker-compose.yml, run this command to set up the configuration.

```Shell
docker compose run iSponsorBlockTV --setup
```

--------------------------------

### Run iSponsorBlockTV V2 Container with Docker

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Migrate-from-V1-to-V2

This command demonstrates how to run the iSponsorBlockTV V2 container using 'docker run'. The '--net=host' flag is no longer required. Ensure '/PATH_TO_YOUR_DATA_DIR' is replaced with your actual data directory.

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

--------------------------------

### Quadlet Systemd Service Configuration

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

This systemd unit file configures iSponsorBlockTV to run as a container service using quadlet. Place this in a .container file and reload systemd.

```systemd
[Unit]
Description="Sponsorblock for networked youtube clients"
Wants=network-online.target
After=network-online.target

[Install]
WantedBy=multi-user.target default.target

[Service]
Restart=always
TimeoutStartSec=900

[Container]
Image=ghcr.io/dmunozv04/isponsorblocktv:latest
Volume=/etc/containers/config/isponsorblocktv:/app/data
#UserNS=auto # uncomment to run under random uid to increase security
```

--------------------------------

### Run CLI Configurator with Docker

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

Execute this command to use the text-based CLI configurator. This is an alternative if the graphical configurator has issues. A TV Link Code is required.

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

--------------------------------

### Check iSponsorBlockTV Service Status

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

Use this command to verify if the iSponsorBlockTV service is running correctly and to view its recent logs.

```Shell
systemctl status isponsorblocktv.service
```

--------------------------------

### Docker Compose Service Configuration

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

This YAML defines the iSponsorBlockTV service for docker-compose. Ensure the volume path matches the one used in the configurator step.

```YAML
services:
    iSponsorBlockTV:
        image: ghcr.io/dmunozv04/isponsorblocktv
        container_name: iSponsorBlockTV
        restart: unless-stopped
        network_mode: host
        volumes:
        - /PATH_TO_YOUR_DATA_DIR:/app/data #enter the same pathway as you used for your configurator in step 1
```

--------------------------------

### Docker Compose Configuration for V2

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Migrate-from-V1-to-V2

This YAML configuration is for running iSponsorBlockTV V2 using Docker Compose. It specifies the image, container name, restart policy, and the volume mount for the data directory.

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

--------------------------------

### Reload systemd Daemon

Source: https://github.com/dmunozv04/isponsorblocktv/wiki/Installation

After creating or modifying a systemd service file, run this command to make systemd aware of the changes.

```Shell
systemctl daemon-reload
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.