Metadata-Version: 2.4
Name: b2ai_voice_trimkit
Version: 0.1.2
Summary: Audio trimming tool for acoustic researchers with Praat/parselmouth integration
Project-URL: Homepage, https://github.com/Shrramana-USF/b2ai_voice_trimkit
Project-URL: Repository, https://github.com/Shrramana-USF/b2ai_voice_trimkit
Author: Shrramana-USF
License-Expression: MIT
License-File: LICENSE
Keywords: acoustic,audio,b2ai,cough,parselmouth,praat,research,speech,trimming,voice
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Requires-Python: >=3.9
Requires-Dist: librosa>=0.9.0
Requires-Dist: numpy>=1.20.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: plotly>=5.0.0
Requires-Dist: praat-parselmouth>=0.4.0
Requires-Dist: pydub>=0.25.0
Requires-Dist: soundfile>=0.10.0
Requires-Dist: streamlit>=1.20.0
Description-Content-Type: text/markdown

# B2AI Voice Trimkit

A Streamlit-based audio trimming tool for acoustic researchers with Praat-Parselmouth integration.

## Features

- **Multiple Task Types:**
  - **Sustained Vowel** - Single segment extraction per file
  - **Cough** - Detect and isolate cough segments
  - **Speech** - Praat-based trimming to isolate voiced region
  - **Breathing** - Trim leading and trailing silence
  - **Everything Fused** - Multi-segment detection (cough, breathing, speech, vowel)
  - **General-manual** - Manual region selection and trimming

- **Supported Formats:** `.wav` and `.mp3` (auto-converted to WAV)
- **Interactive Waveform:** Visual selection with Plotly
- **Batch Processing:** Process multiple files via CSV upload


## Installation

```bash
pip install b2ai-voice-trimkit
```

## Usage

Launch the dashboard:

```bash
b2ai_voice_trimkit
```

### CSV Format

Upload a CSV file with a column named `audio_file_path`:

```csv
audio_file_path
/path/to/audio1.wav
/path/to/audio2.mp3
```

## Output Location

Trimmed files are saved in a `Final_trim` folder in the same directory as the original audio file.

## Quitting

- Click **Quit Application** in the sidebar or
- Press `Ctrl+C` in the terminal

## Dependencies

- numpy, pandas, streamlit
- praat-parselmouth
- plotly, soundfile, librosa, pydub

## License

MIT