vadslice 1.0.0

Slices audio clips into chunks of a specific number of seconds at the closest moment of silence (decided by silero-vad). Uses onnx which avoids the pytorch dependency.

vadslice

Slices audio clips of speech into chunks of certain length in seconds at silence points so it doesn't cut in the middle of someone speaking. It uses VAD (voice activity detection from silero-vad) to determine these points of silence within the clip.

Uses ONNX runtime instead of PyTorch, avoiding the heavy PyTorch dependency while maintaining the same VAD accuracy.

It's extremely fast.

Installation

Requires Python 3.12+.

uv add vadslice

or pip:

pip install vadslice

Usage

CLI

vadslice <size> <input_file> <output_dir> [--format wav|mp3|ogg|m4a]

Example:

vadslice 30 audio.mp3 ./chunks --format mp3

Chunks are saved to output_dir/input_file_stem/chunk_XXXX_offset_XX.XXs.ext.

Python API

from vadslice import slicer

parts = slicer("audio.mp3", slice_length_s=30.0)
for i, part in enumerate(parts):
    print(f"Part {i}: Offset: {part.offset_s}s, Size: {len(part.part)} bytes")

The function slicer returns a list of AudioPart objects, each containing:

• part: WAV bytes (16 kHz mono) for that slice
• offset_s: Start time offset in seconds from the original audio

Supports any audio format that PyAV can decode (MP3, WAV, OGG, M4A, FLAC, etc.).