whatisgithub

What is transcript-tiler?

adamgordonbell/transcript-tiler — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A tool that cleans up sloppy speech to text word timestamps and finds filler words like um and uh that are safe to cut out.

Mindmap

mindmap
  root((transcript-tiler))
    What it does
      Fixes sloppy word timestamps
      Labels word silence noise
      Flags cuttable filler words
    Tech stack
      Python
      Whisper input
      silero VAD
      ffmpeg cutting
    Use cases
      Podcast editing
      Filler word removal
      Transcript cleanup
    Audience
      Podcast producers
      Audio developers
    Outputs
      Native JSON
      TextGrid
      Audacity labels

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

What do people build with it?

USE CASE 1

Clean up rough word timestamps from Whisper or WhisperX transcripts.

USE CASE 2

Automatically find filler words like um and uh that can be safely removed from a recording.

USE CASE 3

Cut filler words out of an audio file cleanly using the included ffmpeg based script.

USE CASE 4

Export word timing data for review in tools like Praat, ELAN, or Audacity.

What is it built with?

PythonWhispersilero VADffmpeg

How does it compare?

adamgordonbell/transcript-tiler0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Voice activity detection pulls in the torch library, so the first install downloads a large dependency, not yet on PyPI.

Open source, check the repository's LICENSE file for exact terms.

So what is it?

This is a tool for cleaning up audio transcripts, still an early work in progress. When speech to text software like Whisper turns audio into text, it gives you a rough guess of when each word starts and stops. Those guesses are often sloppy. This project fixes them, turning them into a precise, gap free labeling where every moment of the audio is marked as either a word, silence, or background noise. Unlike some competing tools that re-align the whole transcript against an acoustic model, this one just corrects the timestamps you already have, using simpler signals: how loud the audio is, a voice activity detector called silero VAD, and a measure of how noise-like versus tone-like a sound is. It does not re-transcribe anything or use a heavy acoustic model. In the author's own testing on one set of podcast recordings, this approach placed word boundaries more accurately than raw speech to text output or other alignment tools, though this has not been checked against a public benchmark. Beyond just marking boundaries, each word gets information about how confidently free its edges are, meaning how close the signal drops to silence right before and after it. That lets other tools decide which words are safe to cut out entirely, for example filler words like um and uh. The project includes a command line tool that can list out those safely cuttable filler words, and a sample script that uses ffmpeg to actually remove them from the audio file, with small fades added to avoid clicks at the cut points. It accepts transcripts from Whisper, WhisperX, or a simple generic word list format, and can export its results in formats compatible with linguistics tools like Praat and ELAN, or as an Audacity label track for manual review. It is built to handle multi hour recordings efficiently and caches results so re-running on the same file is instant. The project grew out of a larger toolchain the author built for editing podcasts.

Copy-paste prompts

Prompt 1
Show me how to run transcript-tiler on a Whisper transcript to fix the word timestamps.
Prompt 2
Help me use transcript-tiler to find and list filler words like um and uh in my podcast audio.
Prompt 3
Walk me through cutting filler words out of my audio file using transcript-tiler's ffmpeg script.
Prompt 4
Explain what the startDb and endDb values in transcript-tiler's output mean.
Prompt 5
How do I export a transcript-tiler labeling as an Audacity label track for manual review?

Frequently asked questions

What is transcript-tiler?

A tool that cleans up sloppy speech to text word timestamps and finds filler words like um and uh that are safe to cut out.

What language is transcript-tiler written in?

Mainly Python. The stack also includes Python, Whisper, silero VAD.

What license does transcript-tiler use?

Open source, check the repository's LICENSE file for exact terms.

How hard is transcript-tiler to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is transcript-tiler for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.