How It Works

Web Interface Workflow

The Streamlit-based web interface makes professional MOH creation accessible to anyone:

1. Launch the Application: Run locally with streamlit run moh_generator/web/app.py or deploy to Streamlit Cloud for team access
2. Upload Music Files: Drag and drop your background music tracks (WAV, MP3, OGG, FLAC, M4A, AAC)—upload multiple files for variety
3. Upload Message Files: Add your announcement audio files—the system will insert them at specified intervals
4. Configure Settings: Use intuitive sliders to adjust message intervals, volume levels, crossfade duration, and audio effects
5. Preview Your Track: Generate a 30-second preview to verify settings before creating the full track
6. View Waveform: See visual representation of your audio with interactive Plotly charts
7. Generate Full Track: Create the complete MOH file in your preferred format
8. Download Results: Save the finished track and deploy to your phone system
9. Save Configuration: Export your settings as a YAML preset for future use

Command-Line Workflow

For developers and automation enthusiasts, the CLI provides powerful scripting capabilities:

# Basic usage with default settings
moh-generator -m music/ -msg messages/ -o output.wav

# Professional quality with advanced processing
moh-generator \
  -m music/ \
  -msg messages/ \
  -o professional.mp3 \
  --format mp3 \
  --crossfade 3000 \
  --fade-in 2000 \
  --fade-out 2000 \
  --normalize \
  --interval 30

# Create 5-minute track with precise timing
moh-generator \
  -m music/ \
  -msg messages/ \
  -o timed.wav \
  --duration 300 \
  --interval 20 \
  --delay 10

# Generate preview before full production
moh-generator \
  -m music/ \
  -msg messages/ \
  -o preview.mp3 \
  --preview 30

# Use configuration preset
moh-generator --config corporate_preset.yaml -o output.wav

# Save current settings for reuse
moh-generator \
  -m music/ \
  -msg messages/ \
  -o output.wav \
  --interval 20 \
  --normalize \
  --crossfade 2000 \
  --save-config my_preset.yaml

Python API Workflow

Integrate MOH generation directly into your Python applications:

from moh_generator import MOHGenerator

# Create generator instance
generator = MOHGenerator()

# Load audio files
generator.load_music(["song1.mp3", "song2.mp3", "song3.mp3"])
generator.load_messages(["welcome.wav", "promo.wav"])

# Configure processing settings
generator.configure(
    message_interval=20,
    initial_delay=10,
    music_volume_reduction=-8,
    message_volume_increase=12,
    crossfade_ms=2000,
    fade_in_ms=1000,
    fade_out_ms=1000,
    normalize=True,
    target_duration=300
)

# Generate the track
output_path = generator.generate("output.mp3", format="mp3")
print(f"Generated: {output_path}")

# Or create a preview first
preview = generator.get_preview(durati
preview.export("preview.mp3", format="mp3")