StreamDVR

About

StreamDVR records your favorite live streamers while you are away. No need to miss a broadcast!

Time shifting is not a crime:
https://en.wikipedia.org/wiki/Sony_Corp._of_America_v._Universal_City_Studios,_Inc.

• Use either ffmpeg or streamlink to record to ts-containers

• Automatically convert recordings to mp4 or mkv

• Run custom post-process scripts after conversion to…

  • upload to cloud storage
  • generate thumbnail previews
  • do anything you want

• Supported sites out of the box: Twitch, Youtube, Pixiv, Picarto

• See Adding new plugins to use StreamDVR with other sites that are supported by yt-dlp or streamlink.

• Docker available at https://ghcr.io/purrsevere/streamdvr

Setup

• Dependencies: bash, node.js >= 14.0.0, npm, git, and ffmpeg
  • StreamDVR does not work in a windows command prompt. Use WSL to run StreamDVR in Windows.

• Optional Dependencies: streamlink, yt-dlp

  • streamlink is used to fetch m3u8 URLs for Pixiv and Picarto by default
  • yt-dlp is used to fetch m3u8 URLs for Twitch and Youtube by default

• Install StreamDVR

  On GitHub, click Clone or download, Download ZIP.
  Or run git clone https://github.com/jrudess/streamdvr.git

• Run npm install to locally install all dependencies in package.json

Instructions

• config files are loaded from the following paths (listed in precedence order):

  • $XDG_CONFIG_HOME/streamdvr/
  • $HOME/.config/streamdvr/
  • $cwd/config/

• To run: streamdvr

• Filename formatting:

  • %s Site Name
  • %n Streamer Name
  • %d Date and Time

• TUI navigation:

  • 1 to focus the streamer list, Esc to unfocus
  • 2 to focus the site list, Esc to unfocus
  • enter to focus the input bar for CLI
  • Up/Down/PgUp/PgDn to scroll the active focus

• CLI:

    add     [site] [streamer] <alias>
    addtemp [site] [streamer]
    pause   [site] <streamer> <time in seconds>
    remove  [site] [streamer]
    reload
    help

• Streamer aliases

Some websites, such as youtube, will have channel names that are random characters. For example, the URL to capture NBC News live streams is https://www.youtube.com/channel/UCeY0bbntWzzVIaj2z3QigXg. An alias can be specified when adding the channel to give it a better name.

    add youtube UCeY0bbntWzzVIaj2z3QigXg nbc_news
`

• Custom Post Processing is enabled in config.yml with postprocess: /path/to/script

    #!/bin/bash
    #arg0 is path, arg1 is filename
    args=("$@")
    notify-send "streamdvr" "Done recording ${args[1]}"

• Adding new plugins

Every site that is supported by either streamlink or yt-dlp will work with StreamDVR. All that is necessary is to create a new configuration file with the site’s details. Refer to any existing yml file in the config directory for an example.

If you have created a .yml for StreamDVR and would like to share it, please submit a pull request to include the new yml files in the repo.

All support for streaming sites is handled by 3rd party programs. The site configuration yml files specify the m3u8 lookup and record scripts to use. Adding support for new programs requires adding new wrapper scripts and using those scripts in the yml configuration file.

If you would like StreamDVR to support a new program and have written your own wrapper scripts, pull requests are welcome. If you’re just aware of other programs similar to yt-dlp or streamlink, please open an issue and provide the program’s name/info. If the program looks promising (e.g. works for at least one of the existing sites), then I’ll probably add support for it.

• Configuration Options for config.yml

  • enable
    • daemon
      Suppresses standard out messages
  • recording
    • autoConvertType
      mp4, mkv, ts (no conversion)
    • captureDirectory
      Temporary storage area while recording
    • completeDirectory
      Final area to store recordings
    • postprocess
      Script to use to convert ts to mp4/mkv
    • dateFormat
      Used for log output and filenames
    • includeSiteInDir
      This option only applies if streamerSubdir is set.
      Recordings are placed in completeDir/streamer_site.
      If siteSubdir is set then completeDir/site/streamer_site.
    • streamerSubdir
      Recordings are placed in completeDir/streamer/
      If includeSiteInDir is set then completeDir/streamer_site/.
      If siteSubdir is set then completeDir/site/{streamer, streamer_site}.
    • siteSubdir
      Recordings are placed in completeDir/site/.
      If streamerSubdir is set then completeDir/site/streamer/.
    • keepTsFile
      This option leaves the ts file in captureDir after an
      mp4/mkv is converted. This is mostly a ‘debug’ option.
    • minSize
      Minimum size in megabytes for a recording.
      Recordings smaller than this size are automatically deleted.
    • maxSize
      Maximum size in megabytes for a recording.
      Recordings that are larger than this size are halted and
      converted, then restarted.
  • postprocess
    Path to custom post-processing script that is run after
    a recording has been converted to its final file format.
    Arguments to script: arg0=path arg1=filename
  • log
    • enable
      Store log output to streamdvr.log
    • append
      Append new output to the file when true.
      Overwrite new output to the file when false.
  • tui
    • enable
      Allow interactive control of streamdvr with a text interface
    • allowUnicode
      Disable use of any fancy unicode characters in TUI output
  • colors
    Allows customization of various colors used in logs or TUI
  • proxy
    • enable
      Turns on socks5 proxy forwarding for m3u8_streamlink.sh and record_streamlink.sh
    • server
      socks5://127.0.0.1:9999
  • debug
    • log
      Enables debug messages to print in the normal log
    • recorder
      Store the ffmpeg/streamlink logs to a file when recording
    • errortrace
      Include a stack-trace for each error message

TUI Screenshot