ParkerBot

ParkerBot is a Matrix bot that monitors a channel for YouTube links and generates weekly playlists from them. It also sends YouTube link titles to the channel it's in.

Running locally

1. Clone the repo
2. Install the dependencies, preferably in a venv:

   uv venv --python 3.14 --seed
   source .venv/bin/activate
   uv pip install -r requirements.txt
   

3. Copy example.env to .env, customize it.
4. Source .env:

   source .env
   

5. Execute the app:

   ./main.py
   

Running as a container

1. Customize the compose.yml if necessary, you might want to change the data volume's path or make it a named volume.
2. Copy example.env to .env and customize it.
3. Run locally as described above at least once on a machine with a web browser. This is needed to get a valid token.pickle for YouTube. Copy it to the data directory where you want to run the container.
4. Run the container, this is an example with podman-compose:

   podman-compose up -d