jasonyangee/archivedv repository overview

⁠(Un)Archived V

⁠Youtube Stream Download Service With Keyword Filtering.

⁠Main Purpose:

The purpose of this project is to save Vtuber singing streams where often are unarchived due to copyright issues.

⁠Service Feature:

1. Automatically checks subscribed channels for new live streams
2. Downloads matching videos based on specified keyword list
3. Sends notifications via Pushover.

⁠Screenshot

⁠Public Docker Image

jasonyangee/archivedv:latest

ghcr.io/jasonyang-ee/archivedv:latest

⁠Run Using Docker Compose

services:
  vtuber:
    image: jasonyangee/archivedv:latest
    container_name: archivedv
    restart: unless-stopped
    user: "1000:1000"
    ports:
      - "3000:3000"
    volumes:
      - ./vtuber/data:/app/data
      - ./vtuber/video:/app/download
    environment:
      TZ: America/Los_Angeles
      # PUSHOVER_APP_TOKEN: ${PUSHOVER_APP_TOKEN}
      # PUSHOVER_USER_TOKEN: ${PUSHOVER_USER_TOKEN}

⁠Web Interface

Access the web interface at http://<host_ip>:3000

⁠Data Persistence

Bind mounts to preserve data:

• Configurations: /app/data/db.json
• Downloaded Videos: /app/download/<channel_username>/<video_title>/

⁠Scheduling

A cron job runs every 10 minutes to check for new live streams.

⁠Notifications (Optional)

Pushover is used to send mobile/desktop notifications on each successful download.

⁠Folder Permissions

It is recommended to run the container with a non-root user. The default user ID is 1000.

Change to the user ID of your host system if necessary. You can do this by modifying the user field in the Docker Compose file.