{"id":27771403,"url":"https://github.com/ivan-ayub97/metromuse-audioeditor","last_synced_at":"2025-04-29T22:38:27.917Z","repository":{"id":290360447,"uuid":"974168537","full_name":"Ivan-Ayub97/MetroMuse-AudioEditor","owner":"Ivan-Ayub97","description":"A modern audio editor with multitrack capabilities, enhanced waveform visualization, and an intuitive, sleek interface.","archived":false,"fork":false,"pushed_at":"2025-04-28T11:42:45.000Z","size":2532,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-28T12:31:28.193Z","etag":null,"topics":["audio","audio-analysis","audio-player","audio-processing","audio-visualizer","audioediting","editor","editor-tool","ffmpeg","ffmpeg-gui","ffprobe","pyqt5","pyqt5-desktop-application","python","waveform"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ivan-Ayub97.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-28T11:06:24.000Z","updated_at":"2025-04-28T11:38:41.000Z","dependencies_parsed_at":"2025-04-28T12:31:42.794Z","dependency_job_id":"37f73c8f-da5a-4886-a997-914880023a6e","html_url":"https://github.com/Ivan-Ayub97/MetroMuse-AudioEditor","commit_stats":null,"previous_names":["ivan-ayub97/metromuse-audioeditor"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ivan-Ayub97%2FMetroMuse-AudioEditor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ivan-Ayub97%2FMetroMuse-AudioEditor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ivan-Ayub97%2FMetroMuse-AudioEditor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ivan-Ayub97%2FMetroMuse-AudioEditor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ivan-Ayub97","download_url":"https://codeload.github.com/Ivan-Ayub97/MetroMuse-AudioEditor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251596559,"owners_count":21615009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","audio-analysis","audio-player","audio-processing","audio-visualizer","audioediting","editor","editor-tool","ffmpeg","ffmpeg-gui","ffprobe","pyqt5","pyqt5-desktop-application","python","waveform"],"created_at":"2025-04-29T22:38:27.041Z","updated_at":"2025-04-29T22:38:27.904Z","avatar_url":"https://github.com/Ivan-Ayub97.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ![MetroMuse](Banner.png)\n## MetroMuse — Audio Editor\n**Version 0.10.0 (INCOMPLETE BETA)**\n\n\u003e ⚠️ **Disclaimer:** MetroMuse is currently in beta. Some features may be incomplete, unstable, or under development.\n\nA **modern, cross-platform audio editor** with multitrack capabilities, enhanced waveform visualization, and an intuitive, sleek interface.\n\n---\n\n## 📸 Preview\n\n![Capture](Capture.png)\n\n---\n## 🤝 Contributing\n\nMetroMuse is open source and welcomes contributors! You can help by:\n\n- Reporting issues\n- Improving existing features\n- Refactoring code\n- Designing UI components\n- Translating to other languages\n---\n\n## ✨ Features\n\n### 🎚️ Multitrack Support\n- Manage multiple audio tracks effortlessly\n- Solo, mute, and volume control per track\n- Individual color coding and track organization\n- Synchronized playback across all tracks\n- Easy track naming and management\n\n### 📊 Enhanced Waveform Visualization\n- Interactive, zoomable waveform display\n- Adaptive time grids and markers\n- Real-time amplitude monitoring\n- Smooth zoom, scroll, and scrubbing functionality\n\n### ✂️ Audio Editing Tools\n- Cut, copy, paste with precision\n- Selection-based and track-specific editing\n- Multiple undo/redo levels\n- Non-destructive editing workflow\n\n### 🎛️ Audio Effects\n- Volume gain adjustment\n- Fade-in and fade-out effects\n- Real-time effect preview\n- Per-track parameter control\n\n### ▶️ Advanced Playback\n- Synchronized multi-track playback\n- Real-time scrubbing and position tracking\n- Solo/mute functionality for detailed mixing\n\n### 🎨 Modern Interface\n- Dark theme with accent color highlights\n- Large, accessible UI elements (48x48px)\n- Collapsible panels and intuitive navigation\n- Enhanced visual feedback\n\n### 💾 File Format Support\n- Import and export: WAV, FLAC, MP3, AAC\n- Drag-and-drop audio importing\n- Recent files management\n- Display of file metadata and information\n\n### 🔧 Under-the-Hood Technical Features\n- Sample-accurate editing\n- High-quality multi-channel audio processing\n- Real-time waveform updates\n- Efficient rendering pipeline\n\n---\n\n## 🛠️ Development Status (v0.10.0)\n\n| Component        | Status        | Notes                                             |\n| ---------------- | ------------- | ------------------------------------------------- |\n| Waveform Display | 🟡 Functional | Includes scrubbing, time grid, and markers         |\n| Multitrack       | 🟡 Functional | Fully functional with controls and organization   |\n| Editing Tools    | 🟡 Functional | Basic editing tools with undo/redo support         |\n| Exporting        | 🟡 Functional | WAV, FLAC, MP3, AAC export supported               |\n| Playback         | 🟡 Functional | Synchronized, real-time multitrack playback        |\n| UI/UX            | 🟡 Functional | Dark-themed, responsive interface                  |\n\n---\n\n## 🗂️ Project Structure\n\n```\nMetroMuse/\n│\n├── src/\n│   ├── metro_muse.py        # Main application\n│   ├── track_manager.py     # Multitrack management\n│   ├── track_renderer.py    # Waveform rendering\n│   ├── styles.qss           # UI styling (QSS format)\n│   ├── icon.png             # App icon (PNG)\n│   └── icon.ico             # App icon (ICO for Windows)\n│\n├── resources/\n│   ├── ffmpeg.exe           # Audio processing binary\n│   ├── ffprobe.exe          # Media analysis binary\n│   └── ffplay.exe           # Audio playback binary\n│\n├── requirements.txt         # Python dependencies list\n└── README.md                 # Project documentation\n```\n\n---\n\n## 📦 Dependencies\n\n- **PyQt5** – GUI framework\n- **numpy** – Audio processing\n- **matplotlib** – Waveform visualization\n- **pydub** – Audio file handling\n- **librosa** – Audio analysis\n- **sounddevice** – Audio playback\n- **qtsvg** – SVG icon support\n- **python-qss** – Stylesheet management\n- **PyQt5-stubs** – Type hinting for PyQt5\n- **ffmpeg** (external) – Media processing (MP3, AAC, FLAC support)\n\n---\n\n## 🚀 Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/Ivan-Ayub97/MetroMuse-AudioEditor.git\n   cd MetroMuse\n   ```\n\n2. Install Python dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Install **ffmpeg**:\n   - **Windows**:\n     ```bash\n     winget install ffmpeg\n     ```\n     Or manually place `ffmpeg.exe`, `ffprobe.exe`, and `ffplay.exe` inside the `resources/` folder.\n   - **macOS**:\n     ```bash\n     brew install ffmpeg\n     ```\n   - **Linux**:\n     ```bash\n     sudo apt install ffmpeg\n     ```\n\n---\n\n## 🎮 Usage Guide\n\nRun MetroMuse:\n\n```bash\npython src/metro_muse.py\n```\n\n### Key Operations\n\n| Action            | Shortcut/Action                 |\n| ----------------- | ------------------------------- |\n| Add Track         | \"+ Add Track\" button             |\n| Import Audio      | \"Import Audio\" button / Drag-and-drop |\n| Delete Track      | Click \"✕\" on track header        |\n| Play/Pause        | Spacebar                        |\n| Stop Playback     | Esc                             |\n| Rewind            | Home key                        |\n| Fast Forward      | End key                         |\n| Scrub             | Click and drag on waveform       |\n| Zoom In/Out       | Mouse Wheel / Ctrl + Mouse Wheel |\n| Pan View          | Arrow keys                      |\n\n---\n\n## 🔥 Planned Features\n\n- Spectrum analysis view\n- Additional effects: echo, reverb, equalization\n- VST plugin support\n- Project saving and loading\n- Track automation features\n- Improved error handling\n- In-app user guides and onboarding dialogs\n\n---\n\n## ⚠️ Known Issues\n\n- Exporting may fail if **ffmpeg** is not correctly configured\n- Some audio effects (echo, reverb) are under active development\n- VST plugin support is pending implementation\n- Project saving/loading is not yet functional\n\n---\n\n## 💻 System Requirements\n\n- **Python**: 3.7 or higher\n- **External Tools**: ffmpeg (must be installed or included in `resources/`)\n- **All listed dependencies** (see [Dependencies](#-dependencies))\n\n---\n\n## 📄 License\n\nThis project is licensed under the **[MIT License](LICENSE)**.\n\n---\n\n## 👨‍💻 Author\n\n- **Developer**: [Iván Eduardo Chavez Ayub](https://github.com/Ivan-Ayub97)\n- **Contact**: \u003cnegroayub97@gmail.com\u003e\n- **Technologies**: Python 3, PyQt5, pydub, librosa\n\n---\n\n## 🌟 Why MetroMuse?\n\nBecause **sometimes you just need a simple, powerful editor that works**.\nMetroMuse is built to provide a **clean, accessible** environment for audio editing—**open-source, evolving**, and designed with a focus on **what matters most to creators**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivan-ayub97%2Fmetromuse-audioeditor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivan-ayub97%2Fmetromuse-audioeditor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivan-ayub97%2Fmetromuse-audioeditor/lists"}