CLI reference

Everything the studio does is available from the terminal. The one command you need most:

podcli process episode.mp4

That transcribes, picks the best moments, crops to the face, burns captions in, and writes upload-ready clips. Nothing leaves your machine.

Common flags#

Use an existing transcript instead of transcribing, and cap the clip count:

podcli process episode.mp4 --transcript transcript.txt --top 5

Set caption style, crop mode, and output format:

podcli process episode.mp4 --caption-style karaoke --crop face --format horizontal

Force thumbnails on or off:

podcli process episode.mp4 --thumbnails
podcli process episode.mp4 --no-thumbnails

Logo, intro, and outro all accept a registered asset name (see Assets) or a direct file path. Leave them off to use whatever you've marked as the default asset.

Presets#

Save a set of render settings once and reuse it:

podcli presets save my-show
podcli process episode.mp4 --preset my-show

Assets#

Register logos, outros, intros, and music once, then reference them by name anywhere. The same library backs the studio Assets page and the manage_assets MCP tool.

podcli assets add my-logo ~/branding/logo.png       # register a file by name
podcli assets add-url outro https://example.com/outro.mp4   # download and register
podcli assets default my-logo                        # make it the default logo
podcli assets list                                   # show everything, defaults marked
podcli assets export my-logo ~/Desktop/logo.png      # copy a registered asset out

Then use a name instead of a path:

podcli process episode.mp4 --logo my-logo --intro show-intro --outro outro

Other actions: podcli assets rename <old> <new>, podcli assets undefault <name>, and podcli assets remove <name>.

Other commands#

podcli opens the interactive menu with Open Web UI. podcli ui opens the studio directly at localhost:3847.

podcli
podcli ui

podcli uninstall removes all managed data by default. Run it with --dry-run first to preview exactly what will be removed.

podcli uninstall --dry-run