• Home
  • Blog
  • Projects
  • Bookshelf
  • About
← Back to all posts

Podcasting By Hand

Published 📅: ....
Last modified 📝: ....

Share this post on BlueskySee discussion on Bluesky

A couple of my friends (Scott and Dillon) and I recently started a podcast called The Bikeshed Podcast. One of the things that we did differently from other podcasts (at least from what we can tell), is that we decided to manage all the infrastructure around recording and distributing the podcast ourselves instead of offloading to services that manage the recordings and also manage distribution.

We did all of this by effectively reverse engineering other podcasts we follow in the wild (shout out to runtime rundown and syntax.fm), digging into their rss.xml feeds, and also just generally messing around until we found something that worked.

Here's a brief overview of our current process (this may change in the future):

Currently we record the podcast in a Discord voice chat using Craig - we had originally started by recording manually with OBS, but found that it was a pain to edit the audio because everyone was in a single audio track instead of split up. Craig is insanely good - it just works and gives us a variety of formats/options to export the audio files. I'm honestly amazed that its still free!

From there, we (meaning primarily Scott) edit the audio in GarageBand. I don't have a complete understanding of the steps involved here - maybe I can convince Scott to write up his workflow on his own blog as well!

After we have the edited audio, we run it through MacWhisper to generate captions for the episode, and also to summarize the episode that we show in the details page on the website (we use a Google Gemini model to summarize the episodes based on the captions).

When we have the edited audio file (.mp3), and the captions file (.vtt), we upload both into a Cloudflare R2 bucket, and then are exposed to the public web under the assets.bikeshedpod.com domain - this is how we host the files for podcast apps / the website to access!

From here - it's worth taking a brief detour in how our website works (which also powers our rss.xml feed too)!

The bikeshedpod.com website is built using Waku (using Garbanzo) and deployed on Cloudflare Workers. We have a few standard pages (e.g. /about, /search, etc), and also some "episode detail pages" like this one.

The "episode detail pages" are built using MDX files for each episode, the MDX files have a bit of frontmatter for defining things like tags on each episode, who the hosts were, a short description, and also contain the links to the audio asset and captions asset.

During builds of the website, we extract all the frontmatter and use it along with the content to build up a generated file with the metadata in a JSON structure. We use this structure to power both the website - e.g. list of episode cards on the homepage or the all episodes page, and search, as well as the rss feed, which is a custom API route hosted at /rss.xml.

That about covers the current setup for the podcast at the moment, theres small aspects that feel a bit less than ideal at the moment - but all in all the workflow seems to fit us nicely at the moment.

Tags:

Web DevelopmentPodcastingThe Bikeshed Pod

Bluesky Post and Comments:

Matt Hamlin

Matt Hamlin

@matthamlin.me

Podcasting By Hand: matthamlin.me/blog/2025/ap...

A look behind the curtains in how we're making the @bikeshedpod.com at the moment!
Podcasting By Hand

Podcasting By Hand

A brief overview on how we launched The Bikeshed Podcast, including a deep dive in our recording and distribution workflows!

https://matthamlin.me/blog/2025/april/podcasting-by-hand
8 months agoView on bsky.app

Loading...

Related Posts

Web Development

Onboarding Your New AI Teammate

Published: ....

Are we reinventing the wheel when it comes to onboarding new AI agents to a codebase, when we already have primitives available for onboarding humans?

Quick Tip - Theme Aware Images

Published: ....

Have you ever found the need to change the image you render on a web page based on the current preferred color scheme of your theme?

Async Class Creation In JavaScript

Published: ....

Have you ever wanted to create a class in JavaScript or TypeScript but also have the initialization be async? Here's a quick tip on a pattern that I've used in the past!

0
3
1
0

Loading comments...

Website Redesign v10

Published: ....

I recently launched a rewrite and redesign of this personal website, I figured I'd talk a bit about the changes and new features that I added along the way!

Server Side Rendering Compatible CSS Theming

Published: ....

A quick tip to implementing CSS theming that's compatible with Server Side Rendered applications!

Quick Tip - Specific Local Module Declarations

Published: ....

A quick tip outlining how to provide specific TypeScript type definitions for a local module!

On File-System Routing Conventions

Published: ....

Some rough thoughts on building a file-system routing based web application

You're Building Software Wrong

Published: ....

Slicing software: why vertical is better than horizontal.

Single File Web Apps

Published: ....

What if you could author an entire web application in a single file?

Resetting Controlled Components in Forms

Published: ....

A quick way to handle resetting internal state in components when a parent form is submitted!

A Quick Look at Import Maps

Published: ....

A brief look at Import Maps and package.json#imports to support isomorphic JavaScript applications!

Recommended Tech Talks

Published: ....

A collection of tech talks that I regularly re-watch and also recommend to everyone!

Request for a (minimal) RSC Framework

Published: ....

Some features and functionality that I'd like within a React Server Component compatible framework.

Bluesky Tips and Tools

Published: ....

A (running) collection of Bluesky tips, tools, packages, and other misc things!

The Bookkeeping Pattern

Published: ....

A quick look at a small but powerful pattern I've been leveraging as of late!

TSLite

Published: ....

A proposal for a minimal variant of TypeScript!

Monorepo Tips and Tricks

Published: ....

Sharing a few core recommendations when working within monorepos to make your life easier!

Next.js with Deno v2

Published: ....

This is a quick post noting that Next.js should now work with Deno v2!

Don't Break the Implicit Prop Contract

Published: ....

React components have a fundamental contract that is often unstated in their implementation, and you should know about it!

A Better useSSR Implementation

Published: ....

Replace that old useState and useEffect combo for a new and better option!

My Current Dev Setup

Published: ....

A quick look at the applications and tools that I (generally) use day to day for web development!

There Is No Standard Markdown

Published: ....

There are a variety of different markdown "standards" out there, and sometimes they're not all that consistent

Abstract Your API

Published: ....

Proposing a solution for sharing core "business" logic across services!

Tip: Request and Response Headers

Published: ....

There's a common gotcha when creating Web Request and Response instances with Headers!

Using Feature Toggles to De-risk Refactors

Published: ....

Feature toggles are often underused by most software development teams, and yet offer so much value during not only feature development but also refactors

Hohoro

Published: ....

A quick introduction to my new side project, hohoro. An incremental JS/TS library build tool!

Custom Favicon Recipes

Published: ....

Two neat tricks for enhancing your site's favicon!

Corporate Sponsored OSS

Published: ....

The various risks and pitfalls of open source software run by corporations.

The Library-Docs Monorepo Template

Published: ....

A monorepo template for managing a library and documentation together.

Building Better Beacon

Published: ....

How we solved an almost show-stopping production bug, and how you can avoid it in your own projects.

Project Deep Dive: Tails

Published: ....

A(nother) deep dive into one of my recent side projects; tails - a plain and simple cocktail recipe app.

Churn Anxiety

Published: ....

When did semver major changes become so scary?

Service Monitors and Observability

Published: ....

Leveraging service monitors properly to improve service observability.

On Adopting CSS-in-JS

Published: ....

A brief recap of how Wayfair changed it's CSS approach not once but twice in the span of 5 years!

Project Deep Dive: Microfibre

Published: ....

A deep dive into one of my recent side projects; microfibre - a minimal text posting application

Pair Programming

Published: ....

Pair programming can be good sometimes - but not all the time

Suspense Plus GraphQL

Published: ....

A few thoughts on using Suspense with GraphQL to optimize application data loading

You've Launched, Now What?

Published: ....

A few thoughts on what to do after you launch a new project

Taking a Break

Published: ....

A few quick thoughts on burn out and taking a break

Managing Complex UI Component State

Published: ....

A few thoughts on managing complex UI component state within React

Understanding React 16.3 Updates

Published: ....

A quick overview of the new lifecycle methods introduced in React 16.3

CSS in JS

Published: ....

A few thoughts and patterns for using styled-jsx or other CSS-in-JS solutions

Redesign v6

Published: ....

A few thoughts on the redesign of my personal site, adopting Next.js and deploying via Now

JavaScript Weirdness

Published: ....

A few weird things about JavaScript

Calendar

Published: ....

Building a calendar web application