{"id":29698670,"url":"https://github.com/itskavin/audio-converter","last_synced_at":"2025-07-23T10:11:09.457Z","repository":{"id":305710685,"uuid":"1023090977","full_name":"itskavin/Audio-Converter","owner":"itskavin","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-20T14:15:53.000Z","size":6,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-21T17:16:36.410Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/itskavin.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,"zenodo":null}},"created_at":"2025-07-20T14:04:28.000Z","updated_at":"2025-07-20T14:15:56.000Z","dependencies_parsed_at":"2025-07-21T17:16:47.035Z","dependency_job_id":"bc6b3f8a-da5b-47a5-9983-f62031ad601c","html_url":"https://github.com/itskavin/Audio-Converter","commit_stats":null,"previous_names":["itskavin/audio-converter"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/itskavin/Audio-Converter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itskavin%2FAudio-Converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itskavin%2FAudio-Converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itskavin%2FAudio-Converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itskavin%2FAudio-Converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itskavin","download_url":"https://codeload.github.com/itskavin/Audio-Converter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itskavin%2FAudio-Converter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266658812,"owners_count":23963758,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-07-23T10:10:58.696Z","updated_at":"2025-07-23T10:11:09.444Z","avatar_url":"https://github.com/itskavin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AAC Batch Audio Converter\n\nA simple and efficient web-based audio converter that converts AAC files to various audio formats including WAV, FLAC, and MP3. Built with Flask and powered by FFmpeg for high-quality audio conversion.\n\n## ✨ Features\n\n- **Batch Conversion**: Upload and convert multiple AAC files at once\n- **Multiple Output Formats**: Convert to WAV (24-bit), FLAC, or MP3 (320 kbps)\n- **Drag \u0026 Drop Interface**: Easy-to-use web interface with drag-and-drop support\n- **Automatic Downloads**: Single files download directly, multiple files are zipped\n- **Dark Mode**: Toggle between light and dark themes\n- **Progress Tracking**: Visual progress indicator during conversion\n- **Local Processing**: All conversions happen locally on your machine\n\n## 📋 Requirements\n\nBefore running this application, make sure you have the following installed:\n\n### System Requirements\n- **Python 3.7+**\n- **FFmpeg** (for audio conversion)\n\n### Python Dependencies\n- Flask\n- Werkzeug\n\n## 🚀 Installation \u0026 Setup\n\n### 1. Install FFmpeg\n\n#### Windows\nDownload FFmpeg from [https://ffmpeg.org/download.html](https://ffmpeg.org/download.html) and add it to your system PATH.\n\n#### macOS\n```bash\nbrew install ffmpeg\n```\n\n#### Linux (Ubuntu/Debian)\n```bash\nsudo apt update\nsudo apt install ffmpeg\n```\n\n### 2. Clone or Download the Project\n```bash\ngit clone \u003crepository-url\u003e\ncd Audio-Converter\n```\n\n### 3. Install Python Dependencies\n```bash\npip install flask werkzeug\n```\n\n### 4. Run the Application\n```bash\npython run_app.py\n```\n\nThe application will start on `http://localhost:5000`\n\n## 💻 Usage\n\n1. **Open your web browser** and navigate to `http://localhost:5000`\n2. **Select output format** from the dropdown (WAV, FLAC, or MP3)\n3. **Upload AAC files** by either:\n   - Dragging and dropping files onto the upload area\n   - Clicking \"Browse\" to select files\n4. **Click \"Convert \u0026 Download ZIP\"** to start the conversion\n5. **Download** will start automatically:\n   - Single file: Downloads directly\n   - Multiple files: Downloads as a ZIP archive\n\n## 📁 Project Structure\n\n```\nAudio-Converter/\n├── app.py              # Main Flask application\n├── run_app.py          # Application runner\n├── templates/\n│   └── index.html      # Web interface template\n├── static/\n│   ├── style.css       # Styling and theme support\n│   └── script.js       # Frontend JavaScript logic\n├── uploads/            # Temporary storage for uploaded files\n├── outputs/            # Temporary storage for converted files\n└── README.md           # This file\n```\n\n## 🎵 Supported Formats\n\n### Input\n- **AAC** (.aac files)\n\n### Output\n- **WAV**: 24-bit PCM, 48kHz, Stereo\n- **FLAC**: Lossless compression, 48kHz, Stereo  \n- **MP3**: 320 kbps, 48kHz, Stereo\n\n## ⚙️ Configuration\n\n### Audio Quality Settings\nThe application uses high-quality settings by default:\n- **Sample Rate**: 48kHz\n- **Channels**: Stereo (2 channels)\n- **WAV**: 24-bit PCM\n- **MP3**: 320 kbps bitrate\n- **FLAC**: Lossless compression\n\n### Modifying Settings\nYou can modify audio quality settings in `app.py`:\n\n```python\nFORMAT_OPTIONS = {\n    \"wav\": (\"pcm_s24le\", \"wav\"),    # 24-bit WAV\n    \"flac\": (\"flac\", \"flac\"),       # FLAC lossless\n    \"mp3\": (\"libmp3lame\", \"mp3\")    # MP3 with libmp3lame\n}\n```\n\nFFmpeg conversion parameters can be adjusted in the `cmd` array:\n```python\ncmd = [\n    \"ffmpeg\", \"-y\",\n    \"-i\", input_path,\n    \"-acodec\", codec,\n    \"-ar\", \"48000\",     # Sample rate\n    \"-ac\", \"2\",         # Channels (stereo)\n    output_path\n]\n```\n\n## 🛠️ Troubleshooting\n\n### Common Issues\n\n**\"FFmpeg not found\"**\n- Ensure FFmpeg is installed and added to your system PATH\n- Test by running `ffmpeg -version` in your terminal\n\n**\"No valid .aac files uploaded\"**\n- Make sure you're uploading files with .aac extension\n- Check that the files are not corrupted\n\n**\"Port 5000 already in use\"**\n- Stop any other applications using port 5000\n- Or modify the port in `run_app.py`:\n```python\napp.run(debug=True, port=5001)\n```\n\n**Conversion fails silently**\n- Check that FFmpeg supports the input file format\n- Ensure the AAC files are not corrupted or DRM-protected\n\n## 🔧 Development\n\n### Running in Development Mode\nThe application runs in debug mode by default, which provides:\n- Auto-reload on code changes\n- Detailed error messages\n- Debug toolbar\n\n### File Management\n- Uploaded files are stored in `uploads/` directory\n- Converted files are stored in `outputs/` directory\n- Files are automatically managed (overwritten on new uploads)\n\n## 📝 Notes\n\n- This application is designed for **local use only**\n- Files are processed locally on your machine\n- No data is sent to external servers\n- Temporary files are stored in local directories\n- The application uses a simple secret key (change for production use)\n\n## 🎯 Future Enhancements\n\nPotential improvements for the application:\n- Support for more input formats (MP3, M4A, etc.)\n- Customizable audio quality settings via UI\n- File format validation and error handling\n- Progress tracking for individual files\n- Batch rename options\n- File preview and metadata display\n\n## 📄 License\n\nThis project is open source and available under the [MIT License](LICENSE).\n\n---\n\n**Happy Converting! 🎵**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitskavin%2Faudio-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitskavin%2Faudio-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitskavin%2Faudio-converter/lists"}