(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 check subscribed channels for new live streams.
2. Download matching videos based on a specified keyword list.
3. Send notifications via Pushover.
4. Manage channels and keywords via the web interface.

Screenshot

Public Tracking Service

This service is tracking all EN and ID branch. Video will be periodically deleted to free up space.

https://archivedv.jasony.org

Public Docker Image

Docker Hub

jasonyangee/archivedv:latest

GitHub Container Registry

ghcr.io/jasonyang-ee/archivedv:latest

Supported Platforms

• Linux AMD64
• Linux ARM64
• Linux ARMv7

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.

Potential Issues

Folder permissions may cause issues. Please manually chown the volume bind folders to the user ID specified in the Docker Compose file.

Example Command

sudo chown -R 1000:1000 ./vtuber