Skip to content

pomu.app archives VTuber livestreams both automatically and on-demand

License

Notifications You must be signed in to change notification settings

mellowagain/pomu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pomu Rainpuff

pomu.app

pomu.app archives VTuber livestreams both automatically and on-demand.

API documentation / CDN documentation

Requirements

pomu.app can be built and ran either as standalone or within a Docker container.

Building

  • Standalone
    • Go 1.18+
    • node 19+
    • yarn
    • git
  • Docker
    • docker

Running

Only for standalone:

  • youtube-dl / yt-dlp
  • ffmpeg

For both standalone and within a Docker container:

  • PostgreSQL database
  • S3 object storage for finished files (we suggest Backblaze)
  • Google API key with YouTube v3 Data API access
  • Discord OAuth application

Optional for both standalone and Docker:

  • Sentry.io DSN for error reporting
  • Holodex API key

Building

Backend (standalone)

  • Windows: .\build.ps1
  • macOS and Linux: ./build.sh

Frontend (standalone)

yarn install && yarn build

Docker

docker build .

Running

First, rename the .env.example into .env and fill in your configuration options.

Standalone

Starting pomu.app is as simple as running pomu or pomu.exe, depending on your OS.

Docker

Warning
Do not change the BIND_ADDRESS value in .env when running pomu.app using Docker.

docker run <image> --name pomu -p 8080:8080 --env-file ".env"

You will receive a warning upon startup that the .env file was not found by pomu. Docker has expanded the file already for us, so this warning can be safely ignored.

FAQ

Q: I'd like to take down an archived livestream on pomu.app
A: Please contact mari@pomu.app or emily@pomu.app to initiate the take-down (DMCA) process.

Q: Why does this exist?
A: We love watching various Vtubers which occasionally do unarchived livestreams, such as karaoke. We wanted to archive them on a regular basis - thus pomu.app was born.

Q: What does pomu stand for?
A: Pomu Rainpuff is the strongest fairy in the world. It'd be only fitting to have her as the name for this service.

Q: How do you make money?
A: We don't. The hosted version of pomu.app is fully paid out of pocket by Mari and Emily. We don't intend to turn it commercial as it's not our content, and thus we have no right to profit off of livestreams produced by others.

Q: How much does it cost to run pomu.app per month?
A: The server, paid for by Emily, costs €5 per month. S3 storage, paid for by Mari, may reach up to €15 per month and are publicly displayed on the development instance.

Thank you

Instatus

Status page provided by Instatus