README.md

Component	Status	Notes
Waveform Display	🟢 Enhanced	Scrubbing, markers, optimized rendering
Multitrack System	🟢 Enhanced	Full controls, async loading
Editing Tools	🟢 Enhanced	Undo/redo, improved interaction
Project Management	🟢 New	`.mmp` format, autosave, templates
Error Handling	🟢 New	Logging, dialogs, recovery
Performance Monitor	🟢 New	Realtime CPU/memory usage
Exporting	🟡 Functional	Supports WAV, MP3, AAC, FLAC
Playback	🟡 Enhanced	Real-time, multitrack improvements
UI/UX	🟢 Enhanced	Shortcuts, responsiveness, polish

📸 Interface Preview

🔹 New Icon

🔹 General UI

General UI

🔹 Effects Options

Effects Options

Quick Effects

🔹 Audio Effects Studio

Audio Effects Audio Effects 2 Audio Effects 3

🔹 File & Edit Menus

File Options Edit Options

View Options View Options 2 View Options 3

🔹 Shortcuts & About

Shortcuts About

📦 Dependencies

Core Libraries

PyQt5 (>=5.15.0)
numpy (>=1.21.0)
matplotlib (>=3.5.0)
pydub (>=0.25.0)
librosa (>=0.9.0)
sounddevice (>=0.4.0)
scipy (>=1.7.0)

Optional Enhancements

psutil (>=5.8.0) — system monitoring
PyQt5-stubs — for development with type hinting

External Tools

ffmpeg — for MP3, AAC, FLAC support
- Windows: binaries included in resources/
- Linux/macOS: install via package manager or ffmpeg.org

🚀 Installation

Clone the repository:

git clone https://github.com/Ivan-Ayub97/MetroMuse-AudioEditor.git
cd MetroMuse

Install required Python packages:

pip install -r requirements.txt

Install ffmpeg (Windows):

winget install ffmpeg

Then, copy ffmpeg.exe, ffprobe.exe, and ffplay.exe into the resources/ folder.

🎮 Usage

Launch the App

python src/metro_muse.py

🗂️ Project Shortcuts

Action	Shortcut
New Project	Ctrl+N
Open Project	Ctrl+Shift+O
Save Project	Ctrl+S
Save As	Ctrl+Shift+S

🎧 Audio Tasks

Action	Shortcut / Action
Import Audio	Ctrl+O / Drag-and-drop / "Import Audio"
Export Audio	Ctrl+E
Add Track	"+ Add Track"
Delete Track	Click "✕" in header

⏯ Playback Controls

Action	Shortcut
Play/Pause	Spacebar
Stop	Esc
Rewind	Home
Fast Forward	End
Scrub	Click + Drag Waveform

✂️ Edit Commands

Action	Shortcut
Cut	Ctrl+X
Copy	Ctrl+C
Paste	Ctrl+V
Undo	Ctrl+Z
Redo	Ctrl+Y

Action	Shortcut
Zoom In	Ctrl++ / Wheel Up
Zoom Out	Ctrl+- / Wheel Down
Pan Left	← Arrow
Pan Right	→ Arrow

🔥 Recent Enhancements (v0.12.0)

✅ .mmp project format with full save/load
✅ Auto-save with tracking
✅ Detailed error logging
✅ Real-time performance monitor
✅ Async audio file handling
✅ Memory-optimized waveform renderer
✅ Shortcut improvements

🚧 Upcoming Features

Spectrum analyzer
VST plugin support
Track automation
MIDI input
Recording interface
Effect chain manager
Export profiles/settings
In-app guides/tutorials
Full theme customization

⚠️ Known Issues

Exporting fails if ffmpeg isn’t properly set up
Echo/reverb effect modules still in progress
No VST support yet
Performance dips with large files (>500MB)
Preview lag possible on low-spec hardware

💻 System Requirements

Python: 3.7+
FFmpeg: Installed or placed in resources/
See Dependencies section above

🗂️ Project Structure

MetroMuse/
├── Captures/                      # Screenshots of the interface
│   └── ...                       
│
├── src/                           # Main source code
│   ├── metro_muse.py             # Main entry point
│   ├── audio_effects.py          # Audio processing effects
│   ├── error_handler.py          # Error handling utilities
│   ├── performance_monitor.py    # Performance tracking
│   ├── project_manager.py        # Project loading/saving logic
│   ├── track_manager.py          # Handles audio tracks
│   ├── track_renderer.py         # Track visualization or rendering
│   ├── ui_manager.py             # GUI management
│   ├── styles.qss                # Qt Style Sheet
│   ├── icon.png                  # App icon (PNG)
│   └── icon.ico                  # App icon (ICO)
│
├── resources/                    # Bundled third-party binaries
│   ├── ffmpeg.exe
│   ├── ffplay.exe
│   └── ffprobe.exe
│
├── requirements.txt              # Python dependencies
├── README.md                     # Project overview
├── CHANGELOG.md                  # Version history
├── LICENSE                       # License information
├── CODE_OF_CONDUCT.md           # Contributor behavior guidelines
├── CONTRIBUTING.md              # Guidelines for contributing
└── SECURITY.md                  # Security policies and contact

---

🤝 Contributions

We welcome your help to improve MetroMuse!

Fork the repo
Create a new branch for your feature or fix
Submit a pull request with a clear description

💬 Bug reports, ideas, or questions? 📧 Contact: negroayub97@gmail.com

👤 Author

Iván Eduardo Chavez Ayub 🔗 GitHub 📧 negroayub97@gmail.com 🛠️ Python, PyQt5, pydub, librosa

🌟 Why MetroMuse?

Because sometimes you just need a simple, powerful editor that works. MetroMuse is built with focus, clarity, and creativity in mind — open-source, evolving, and creator-driven.