gitwtfhub

wtf is tributary?

realmullens/tributary — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

TL;DR

A self hosted remote recording studio that records each guest locally at full quality, then merges and edits the synced tracks after the call.

Mindmap

mindmap
  root((repo))
    What it does
      Records each guest locally
      Merges synced tracks
      Text based editing
    Tech stack
      Node
      React
      TypeScript
      ffmpeg
    Use cases
      Record a podcast
      Record a remote interview
      Export social clips
    Audience
      Podcasters
      Video creators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Self host a remote recording studio to record podcast guests at full local quality.

REASON 2

Recover and finish uploads automatically if a guest's browser tab crashes mid recording.

REASON 3

Cut a recording by editing its transcript instead of scrubbing through the video.

REASON 4

Export a finished recording as vertical or square social media clips with captions.

What's in the stack?

NodeReactTypeScriptffmpegFastify

How it stacks up

realmullens/tributary0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardeasy
Complexity4/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Needs Node 20+, pnpm, and ffmpeg installed, plus HTTPS setup for recording with remote guests.

MIT license: use it, modify it, and share it freely, including commercially.

Wtf does this do

Tributary is a self hosted, open source remote recording studio for podcasts and video interviews, built in the style of the popular Riverside service. Guests join a live video call through a web browser, but instead of relying only on that call's video quality, each participant's camera and microphone are recorded locally on their own device at full quality. Those recordings are saved in small chunks and uploaded in the background as they go, so the host ends up with separate, synchronized, high quality tracks for every participant even if the live connection was choppy. Before recording starts, guests get a lobby screen to check their camera and microphone and pick a quality setting. During the session, hosts can mute guests, share their screen, use a synced teleprompter script, and set up an optional waiting room where guests wait to be let in. Recording is designed to survive crashes: every chunk is saved to the browser's local storage before it uploads, uploads retry automatically, and if a browser tab crashes mid recording, reopening the page finds and finishes the unfinished uploads. Once a session ends, an ffmpeg based pipeline assembles each guest's chunks into individual video and audio files, plus a combined mixed video and audio file with everyone properly aligned in time. The project also includes automatic transcription with speaker labels, and a built in editor that lets you cut a recording by selecting words in the transcript, since the video follows the text. Finished edits can be exported as social media clips in different aspect ratios, or as a project file for professional editing software like Premiere Pro or DaVinci Resolve. Tributary is built with Node, React, TypeScript, and ffmpeg, and also includes a command line tool that exposes its editing features so an AI coding agent can automate tasks like removing filler words or generating clips. It is released under the MIT license.

Yoink these prompts

Prompt 1
Help me self host Realmullens/tributary using pnpm and ffmpeg on my own server.
Prompt 2
Explain how Tributary keeps each guest's local recording synced with the others after the call.
Prompt 3
Show me how to use Tributary's AI-agent CLI to automate transcript-based clip creation.
Prompt 4
Walk me through setting up HTTPS and TURN so remote guests can join and record in Tributary.

Frequently asked questions

wtf is tributary?

A self hosted remote recording studio that records each guest locally at full quality, then merges and edits the synced tracks after the call.

What language is tributary written in?

Mainly TypeScript. The stack also includes Node, React, TypeScript.

What license does tributary use?

MIT license: use it, modify it, and share it freely, including commercially.

How hard is tributary to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is tributary for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.