GhostTune Converter Ghostyware

converter multimedia pyqt6 python youtube-downloader

Use this command to install GhostTune Converter:

winget install --id=Ghostshadowplays.GhostTuneConverter -e

A professional, high-performance media conversion utility built with Python and PyQt6. Supports downloading and converting YouTube content or local media files into various audio and video formats like MP3, WAV, MP4, and MKV. Requires FFmpeg for media processing. Features: - YouTube Integration (yt-dlp) - Local Media Conversion (moviepy) - Multiple Format Support (Audio & Video) - Modern "Midnight" Dark Theme - Progress Tracking & Cancellation

GhostTune Converter

GhostTune Converter is a professional, high-performance media conversion utility built with Python and PyQt6. It allows users to download and convert YouTube content or local media files into various audio and video formats with ease.

Features

YouTube Integration: Download and convert YouTube videos directly to your preferred format.
Local Conversion: Convert existing media files on your machine.
Audio & Video Support: Supports a wide range of formats (MP3, WAV, AAC, MP4, MKV, etc.).
Professional UI: Modern "Midnight" dark theme with a clean, intuitive interface.
Real-time Feedback: Progress bars and status updates for all operations.
Process Cancellation: Safely stop ongoing conversions at any time.
HighDPI Support: Scales correctly on high-resolution displays.

Supported Formats

Audio: mp3, wav, aac, ogg, flac, m4a, opus, aiff, wma, mka
Video: mp4, mkv, mov, avi, webm, flv

Prerequisites

Python 3.8+
FFmpeg: Required for media processing. The app will attempt to find a system installation or use imageio-ffmpeg.

Installation

Clone the repository:

git clone https://github.com/Ghostshadowplays/GhostTune-Converter.git
cd GhostTune-Converter

Create and activate a virtual environment:

python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux/macOS
source .venv/bin/activate

Install dependencies:
```
pip install -r requirements.txt
```

Usage

Run the application using Python:

python "GhostTune Converter.py"

Building the Executable (Windows)

To create a standalone .exe file, you can use the provided build script:

python build_exe.py

This will use PyInstaller to bundle the application into a single file in the dist folder. The script ensures all necessary metadata for moviepy and imageio is correctly included to prevent runtime errors.

Select Mode: Choose between Audio or Video mode.
Input:
- For YouTube: Paste the URL in the input field.
- For Local: Click "Convert Local File" to browse.
Format: Select your desired output format from the dropdown.
Convert: Click the conversion button and select your output destination.

Security & Disclaimer

This tool is designed for personal use only. Downloading or converting copyrighted content without permission may violate terms of service and copyright laws. The developer is not responsible for any misuse of this tool.

License

This project is licensed under the MIT License - see the LICENSE file for details.