{"id":27288390,"url":"https://github.com/danbatty/music-ai-software","last_synced_at":"2026-04-29T00:33:33.157Z","repository":{"id":285635968,"uuid":"958836748","full_name":"DanBatty/Music-AI-Software","owner":"DanBatty","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-09T15:57:30.000Z","size":66,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T16:52:10.090Z","etag":null,"topics":["ai","csharp","equalizer","music-player","software-engineering","windows-forms"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DanBatty.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-04-01T21:00:50.000Z","updated_at":"2025-04-09T15:57:33.000Z","dependencies_parsed_at":"2025-04-01T21:41:44.032Z","dependency_job_id":"4f96eefd-9e8a-4159-ac75-ed73636f2607","html_url":"https://github.com/DanBatty/Music-AI-Software","commit_stats":null,"previous_names":["danbatty/music-ai-software"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanBatty%2FMusic-AI-Software","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanBatty%2FMusic-AI-Software/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanBatty%2FMusic-AI-Software/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanBatty%2FMusic-AI-Software/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DanBatty","download_url":"https://codeload.github.com/DanBatty/Music-AI-Software/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248480362,"owners_count":21110935,"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":["ai","csharp","equalizer","music-player","software-engineering","windows-forms"],"created_at":"2025-04-11T20:46:18.518Z","updated_at":"2026-04-29T00:33:33.146Z","avatar_url":"https://github.com/DanBatty.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Music AI Software\n\nA dual-deck music player application with AI-assisted track recommendations using machine learning technology.\n\n## Overview\n\nMusic AI Software is a Windows Forms application that provides professional DJ-style dual audio playback with intelligent music recommendations. The application analyzes your music library to suggest similar tracks based on audio characteristics like BPM (beats per minute).\n\n## Features\n\n### Dual Audio Players\n- **Two independent audio players** for seamless track mixing and comparison\n- **Individual volume controls** for each player\n- **Play/pause controls** for precise playback management\n- **Real-time progress tracking** with time display and progress bars\n- **Drag and drop functionality** between playlist and players\n\n### AI-Powered Recommendations\n- **Machine learning analysis** of your music library\n- **BPM-based similarity detection** for finding compatible tracks\n- **Real-time suggestion updates** based on currently playing tracks\n\n### Supported Audio Formats\n- MP3\n- WAV\n- WMA\n- AAC\n- M4A\n\n## Getting Started\n\n### Prerequisites\n- Windows operating system\n- .NET Framework (compatible version)\n- Audio files in supported formats\n\n### Installation\n1. Download and extract the Music AI Software application\n2. Run the executable file\n3. The application will open with the main interface\n\n## How to Use\n\n### Loading Your Music Library\n1. **Menu Method**: Click on the track menu item in the application\n2. **File Dialog**: Select multiple audio files using the file browser\n3. **Analysis**: The application will automatically analyze your tracks for AI recommendations\n\n### Playing Music\n1. **Select a track** from the playlist on the left\n2. **Click Play button** for Player 1 or Player 2\n3. **Adjust volume** using the individual volume sliders\n4. **Monitor progress** via the time displays and progress bars\n\n### Using AI Recommendations\n1. **Play or select a track** in either player\n2. **Click the Refresh button** in the recommendations panel\n3. **View suggested tracks** based on musical similarity\n4. **Double-click any recommendation** to load it:\n   - Loads to Player 1 if it's not playing\n   - Loads to Player 2 if Player 1 is already playing\n   - Replaces Player 1 if both players are active\n\n### Drag and Drop Operation\n- **Drag tracks** from the playlist to either player panel\n- **Drop onto Player 1 or Player 2** to load and start playback\n- **Visual feedback** indicates valid drop zones\n\n## Technical Details\n\n### Machine Learning Engine\n- Uses **ML.NET framework** for recommendation processing\n- Analyzes **audio characteristics** including BPM detection\n- Creates **similarity models** based on track features\n- Provides **real-time predictions** for track compatibility\n\n### Audio Processing\n- **NAudio library** for high-quality audio playback\n- **Multi-format support** for various audio files\n\n### Architecture\n- **Interface-based design** for extensible audio player implementations\n- **Async/await patterns** for responsive UI during analysis\n- **Event-driven updates** for real-time progress and recommendations\n- **Proper resource management** with disposable patterns\n\n## User Interface\n\n### Main Window Layout\n- **Left Panel**: Music library playlist\n- **Center**: Dual audio player controls with progress indicators\n- **Right Panel**: AI-powered recommendations list\n- **Top**: Menu bar for file operations\n\n### Player Controls\n- **Play/Pause buttons** for each deck\n- **Volume sliders** (0-100 range)\n- **Time displays** showing current position and total duration\n- **Progress bars** with visual playback indication\n\n## Troubleshooting\n\n### Common Issues\n- **No recommendations appearing**: Ensure you have multiple tracks loaded and analyzed\n- **Audio not playing**: Check file format compatibility and audio device settings\n- **Analysis taking long**: Large libraries require more processing time - be patient during initial analysis\n- **Recommendation errors**: Try refreshing or reloading your music library","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanbatty%2Fmusic-ai-software","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanbatty%2Fmusic-ai-software","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanbatty%2Fmusic-ai-software/lists"}