Claggio - Ambient Arpeggio Generator 🎹

A terminal-based ambient music generator that creates warm, evolving soundscapes with real-time procedural arpeggio generation and beautiful gradient visualizations.

Features

• 🎵 Real-time Arpeggio Generation: Creates beautiful ambient arpeggios across 4 channels
• 🌈 Gradient Visualization: Flowing pastel colors that respond to the music
• 🎛️ Live Control: Adjust tempo, key, mode, and patterns in real-time
• 🎨 Multiple Color Palettes: Ambient, Dawn, Dusk, Ocean, Forest themes
• 💾 Preset System: Save and load your favorite configurations
• 🔄 Pattern Evolution: Organic, evolving patterns that change over time
• 🎹 Musical Scales: Major, Minor, Dorian, Phrygian, Lydian, and more

Installation

# Clone the repository
git clone https://github.com/yourusername/claggio.git
cd claggio

# Install dependencies
npm install

# Run the application
npm start

Usage

Controls

Playback

• SPACE - Play/Pause
• ENTER - Regenerate patterns

Tempo

• ↑/↓ - Adjust tempo by ±5 BPM
• Shift+↑/↓ - Adjust tempo by ±10 BPM

Musical Parameters

• ←/→ - Transpose key
• M - Cycle through modes (Major, Minor, Dorian, etc.)
• R - Cycle arpeggio range (4-12 notes)
• L - Cycle loop length (4, 8, 16, 32 beats)

Channels

• 1-4 - Mute/unmute channels
• Shift+1-4 - Solo channels

Other

• E - Toggle pattern evolution
• C - Cycle color palettes
• +/- - Adjust master volume
• S - Save preset
• O - Load preset
• Q - Quit

Channels

The application features 4 distinct channels:

1. Lead Melody - High, ascending patterns with medium density
2. Harmony Layer - Mid-range pendulum patterns for harmonic support
3. Bass Foundation - Low, sparse patterns emphasizing root notes
4. Sparkle Layer - High, dense random walk patterns for texture

Requirements

• Node.js >= 16.0.0
• Audio output device (speakers/headphones)
• Terminal with Unicode support

Architecture

• Audio Engine: Real-time synthesis using the Speaker library
• Arpeggio System: Procedural pattern generation with multiple styles
• TUI Interface: Built with blessed for rich terminal interactions
• Preset Manager: JSON-based preset storage system

License

ISC

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

Acknowledgments

Built with love for ambient music and creative coding.