@t2t2/pod-knight

Pod Knight

A quick podcast episode processor for simple edits and quick uploads

• Cuts episode into parts based on timestamps
• Processes parts into files for publishing
• Uploads files and raw sources to S3-compatible targets
• Reports status into discord webhooks so starting the process and then leaving the computer is a valid choice.
• Supports hardware acceleration (nvidia)

Requirements

• node.js v16 or newer
• ffmpeg
  • Must be available on path (can run ffmpeg -version on command line)

Installation

npm install -g @t2t2/pod-knight

Usage

First generate a preset which will store configuration per show:

pod-knight create:preset my-great-show

This generates file my-great-show.json5 which you should edit to configure settings relevant to processing this show.

Then to use it run:

pod-knight --preset <preset> <input-file> <output-base> <...cuts>

Additionally --start / -s <timestamp> and --end / -e <timestamp> can be used to cut beginning and end.

Example

pod-knight --preset ./my-great-show.json5 ./stream-recording.mp4 MGS001 -s 00:05:04 01:02:13 02:04:45 -e 03:11:23

This will cut into:

Part 1: 00:05:04.000 - 01:02:13.000 (duration: 00:57:09.000)  MGS001_pre
Part 2: 01:02:13.000 - 02:04:45.000 (duration: 01:02:32.000)  MGS001
Part 3: 02:04:45.000 - 03:11:23.000 (duration: 01:06:38.000)  MGS001_post

And then process into uploads:

MGS001/MGS001_pre.mp4 (video)
MGS001/MGS001_pre.mp3 (audio)
MGS001/MGS001.mp4 (video)
MGS001/MGS001.mp3 (audio)
MGS001/MGS001_post.mp4 (video)
MGS001/MGS001_post.mp3 (audio)

Skipping parts

If you've got something you don't want to cut out and publish at all (eg. there's a break between 2 parts) then you can:

• Use skip in between cut timestamps to not render between those two

  pod-knight --preset ./my-great-show.json5 ./stream-recording.mp4 MGS002 -s 01:00 02:00 skip 03:00 -e 04:00
  
  Part 1: 00:01:00.000 - 00:02:00.000 (duration: 00:01:00.000)  MGS002_pre
  Part 2: 00:03:00.000 - 00:04:00.000 (duration: 00:01:00.000)  MGS002
  

• Set the part to false in show preset:

  "parts": [
    {"suffix": "_episode"},
    false,
    {"suffix": "_bonus"},
  ],
  

  pod-knight --preset ./my-great-show.json5 ./stream-recording.mp4 MGS003 -s 01:00 02:00 03:00 -e 04:00
  
  Part 1: 00:01:00.000 - 00:02:00.000 (duration: 00:01:00.000)  TEST_local_episode
  Part 2: 00:03:00.000 - 00:04:00.000 (duration: 00:01:00.000)  TEST_local_bonus