🎵 Ambient Sound Mixer

A modern and elegant ambient sound mixer for creating the perfect atmosphere. Mix multiple sounds with advanced effects for work, meditation, or relaxation.

✨ Features

🎚️ Core Features

• Mix up to 3 ambient sounds simultaneously
• Precise volume control (0-100%)
• Save and load your favorite mixes
• Clean, minimalist interface
• Smart volume auto-balancing

🌊 Sound Effects

• Breathing Effect

  • Simulates ocean waves through volume modulation
  • Adjustable intensity (±20%)
  • Customizable speed (3-8 seconds)

• Smart Panning

  • Smooth stereo transitions
  • Natural 80% pan limit
  • Target-based movement system
  • Full stereo field control

🚀 Getting Started

Prerequisites

• Windows 10/11
• Python 3.8+
• 4 GB RAM
• Stereo sound card

Installation

# Clone the repository
git clone https://github.com/Itssyy/ambient-sound-mixer.git
cd ambient-sound-mixer

# Create virtual environment
python -m venv venv
venv\Scripts\activate  # Windows
source venv/bin/activate  # Linux/Mac

# Install dependencies
pip install -r requirements.txt

Running the App

python src/main.py

🎧 Audio Support

• Formats: WAV (16/24/32 bit)
• Sample Rate: 44.1 kHz
• Channels: Stereo/Mono
• File Size: Up to 50 MB
• Duration: 1-5 minutes recommended

🛠️ Development

# Install dev tools
pip install -r requirements-dev.txt

# Run tests
pytest tests/

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest features
• Submit pull requests

📧 Contact

For support and questions, please open an issue on GitHub.