Skip to content

Latest commit

 

History

History
159 lines (114 loc) · 4.52 KB

README.md

File metadata and controls

159 lines (114 loc) · 4.52 KB

Audio Interlace

中文 README

A sophisticated audio processing tool for timeline-based merging of stereo channels with intelligent segmentation.

Features

  • ⏱️ Timeline-sorted merging
  • 🎚️ Independent channel processing
  • 🔇 Adaptive silence detection
  • ✂️ Context-aware audio segmentation
  • 🎛️ Native WAV format preservation
  • ⏳ Processing progress visualization
  • 🧹 Automatic resource cleanup

Requirements

  • Python 3.8+
  • FFmpeg 4.3+
  • Storage: 3× input file size (for temporary processing)

Installation

  1. Clone repository:

    git clone https://github.com/Track07-cda/audio-interlace.git
cd audio-interlace

  2. Install dependencies:

    pip install -r requirements.txt

  3. Verify FFmpeg installation:

    ffmpeg -version

Basic Usage

Command Template

python audio_interlace.py -i INPUT.wav -o OUTPUT.wav [OPTIONS]

Example Execution

python audio_interlace.py \
  -i input_audio.wav \
  -o processed_output.wav \
  --fade 300 \
  --min-segment 0.8 \
  --min-silence 0.4

Format Support Notes

FLAC Output Considerations:

  • Automatic handling of floating-point format conversion (32-bit float → 32-bit integer)
  • Supports native integer formats (16/24/32-bit)
  • Requires FFmpeg 4.3+ with FLAC encoding support enabled

Verify FFmpeg Configuration:

ffmpeg -encoders | grep flac
# Should display: FLAC (flac)

Workflow Example

1. Channel Segmentation Results

Left Channel Segments

Segment Start End Duration Original Position
L1 00:00.0 00:12.5 12.5s 00:00-00:12.5
L2 00:15.0 00:25.8 10.8s 00:15-00:25.8
L3 00:28.0 00:38.2 10.2s 00:28-00:38.2

Right Channel Segments

Segment Start End Duration Original Position
R1 00:05.0 00:18.2 13.2s 00:05-00:18.2
R2 00:20.5 00:35.0 14.5s 00:20.5-00:35.0

2. Timeline-Merged Output Sequence

Order Channel Segment Time Span Global Timeline Position
1 Left L1 00:00-00:12.5 00:00.0-00:12.5
2 Right R1 00:05-00:18.2 00:12.5-00:25.7
3 Left L2 00:15-00:25.8 00:25.7-00:36.5
4 Right R2 00:20.5-00:35.0 00:36.5-00:51.0
5 Left L3 00:28-00:38.2 00:51.0-01:01.2

Key Characteristics:

  • Chronological merging preserves original temporal context
  • Automatic gap filling with crossfades
  • Total duration: 121.2s (Combined timeline length)
  • Smart overlap resolution using fade effects

Parameter Reference

Option Default Description
-i/--input Required Source WAV file path
-o/--output Required Target WAV output path
--fade 500 Crossfade duration (milliseconds)
--min-segment 1.0 Minimum valid segment length (seconds)
--min-silence 0.5 Silence detection threshold (seconds)
--noise-level -30 Noise floor for silence (dB)
--temp-dir temp Custom temporary directory
--keep-temp False Retain intermediate files

Processing Pipeline

  1. Channel Isolation

    • Split stereo input to discrete mono tracks
    • Preserve original PCM characteristics

  2. Adaptive Segmentation

    • Detect natural pause points
    • Generate timestamped segments

  3. Global Timeline Assembly

    graph TD
    A[Left Segments] --> C[Time-Ordered Pool]
    B[Right Segments] --> C
    C --> D{Sort by Start Time}
    D --> E[Create Merged Timeline]
    E --> F[Apply Crossfades]
    Loading

  4. Final Output Generation

    • Render timeline with original audio quality
    • Maintain WAV specifications

License

MIT License - See LICENSE for full text

Acknowledgments

This project was developed with the assistance of the DeepSeek-R1 large language model for technical solution design and code optimization.
DeepSeek Artificial Intelligence Research