Docker Web Recorder

Docker image to record or stream a website with video and sound.

Building the image

docker build -t docker-web-recorder:latest .

Usage

Record a file

docker run --rm -v /absolute/path/to/your/recordings:/app/recordings -e OUTPUT=video.mp4 -e URL=https://example.com/video/123456 -e DURATION=25 -it docker-web-recorder:latest

Record and send to Google Cloud Storage (GCS)

docker run --rm -e OUTPUT=gs://somebucket/path/video.mp4 -e GOOGLE_APPLICATION_CREDENTIALS=your-json-key -e URL=https://example.com/video/123456 -e DURATION=25 -it docker-web-recorder:latest

The GOOGLE_APPLICATION_CREDENTIALS environment variable can be used if you prefer providing a JSON key instead of using Application Default Credentials.

Make a livestream

docker run --rm -e OUTPUT=rtmp://example.com/app/your_key_here -e URL=https://example.com/video/123456 -e RATE=1000 -e DURATION=120 -it docker-web-recorder:latest

For instance if you plan on streaming to Twitch, set the OUTPUT to something like rtmp://cdg10.contribute.live-video.net/app/live_blablabla. Depends on the best Twitch ingest server for you.

Variables

DISABLE_AUDIO optional. If set to true, the audio will be disabled. Defaults to false.
DURATION is the length of the recording. No value means infinite
FPS is the video capture frame rate passed to FFmpeg as -r. Defaults to 30.
GOOGLE_APPLICATION_CREDENTIALS optional. Can be used instead of Application Default Credentials when using GCS.
OUTPUT is the output file/stream. Can either start with rtmp://, gs:// or end with .mp4. Defaults to output.mp4
RATE is the constant bitrate (CBR) used for the video. Defaults to 6000
RESOLUTION is the resolution of the video. Defaults to 1280x720
TUNE is the FFmpeg libx264 tune setting. Defaults to zerolatency
URL is the webpage to record. Required.

Contributing

Feel free to open an issue if you have any question or suggestion.
PRs are welcome, especially for the following points :clap:

• RTMP(s) stream
• record to mp4
• upload the file
  • to GCS
  • to S3
• configuration
  • resolution
  • bitrate
  • framerate
  • audio
    • disable
  • video codec