Files
platform/seed/tools/convert-audio-to-mp3/TOOL.md
T

33 lines
1.2 KiB
Markdown

---
name: convert_audio_to_mp3
label: Convert Audio to MP3
description: Convert audio files to MP3 320kbps using ffmpeg, preserving metadata. Supports single file conversion with real-time percentage progress, and batch conversion of an entire artist directory with per-file progress. Use when the user wants to convert FLAC, WAV, OGG, or other audio formats to MP3.
version: 2
language: typescript
inputs:
mode:
type: enum
values: single,batch
description: "single: convert one file. batch: convert all audio files recursively in a directory"
path:
type: string
description: "single mode: absolute path to the audio file. batch mode: absolute path to the artist directory"
---
# Convert Audio to MP3
Converts audio to MP3 320kbps CBR via libmp3lame, preserving all metadata tags.
## Modes
### single
Converts one file. Reports ffmpeg percentage progress in real time. Deletes source on success.
### batch
Scans a directory recursively for all supported audio files. Reports per-file progress.
- All succeed → deletes all source files
- Any failure → deletes all successfully created MP3s for a clean retry
## Supported formats
flac, wav, ogg, wma, aac, m4a, opus, aiff, aif, ape, wv, alac, dsf, dff