AudioTools

A simple PyQt6-based GUI application for downloading audio/video from YouTube and separating audio tracks using AI.

Features

• YouTube Audio/Video Downloader: Download audio or video from YouTube using yt-dlp

  • Download as MP3, WAV, or video formats
  • Support for playlists
  • Custom quality selection
  • Automatic metadata tagging

• Audio Separator: Separate audio tracks using Demucs AI

  • Extract vocals, drums, bass, and other instruments
  • Multiple Demucs models supported
  • Batch processing

Requirements

• Python 3.8+
• PyQt6
• yt-dlp (included as executable)
• Demucs (for audio separation)

Installation

1. Clone this repository:

git clone https://github.com/big-chris/AudioTools.git
cd AudioTools

2. Install Python dependencies:

pip install PyQt6
pip install demucs

3. Run the application:

python AudioTools.py

Or use the batch file:

AudioTools.bat

Usage

YouTube Downloader Tab

1. Paste a YouTube URL
2. Select output format (MP3, WAV, or Video)
3. Choose download location
4. Click "Download"

Audio Separator Tab

1. Select an audio file
2. Choose Demucs model
3. Select output directory
4. Click "Separate Audio"

File Structure

AudioTools/
├── AudioTools.py          # Main application
├── AudioTools.bat         # Windows launcher
├── demucs_wrapper.py      # Demucs integration
├── create_icon.py         # Icon generator
├── yt-dlp.exe            # YouTube downloader executable
├── media/                # Downloaded media files (not in git)
├── audiotools_icon.ico   # Application icon
└── readme.txt            # CLI examples

Configuration

Settings are automatically saved to audiotools_settings.json (not tracked in git).

Dependencies

• yt-dlp - YouTube downloader
• Demucs - AI audio separator
• PyQt6 - GUI framework

License

This project uses yt-dlp which is licensed under the Unlicense.

Notes

• Media files in the media/ folder are excluded from version control
• Log files and settings are excluded from git
• The yt-dlp-master/ folder contains the upstream yt-dlp source code for reference