Simple Media Converter

A user-friendly desktop application for converting, joining, and processing audio and video files. Built with Python, this tool provides a clean graphical interface (GUI) to the powerful FFmpeg library, making complex media tasks simple and accessible for everyone.

---

Motivation

This application was born from a simple need: a straightforward, offline audio converter that respects user privacy.

What began as a small personal project quickly transformed into an experiment in AI-assisted development. I was curious to see how far I could push AI, evolving a basic script into a complete, feature-rich program. The result is an application where over 95% of the code was generated by AI, turning a simple idea into a powerful tool.

I believe this app can help others who need to convert audio or video files in a simple and completely offline manner.

---

Features

Simple Media Converter is more than just a basic converter. It's packed with features to streamline your media workflow:

• Versatile Conversion:
  • Audio Mode: Convert video or audio files to a wide range of audio formats (mp3, wav, aac, flac, etc.).
  • Video Mode: Convert videos between popular formats (mp4, mkv, mov, webm, etc.), with options to change codecs, resolution, and FPS.
  • Extract Audio: Easily pull the audio track from any video file and save it in your desired audio format.
• Join Multiple Files: Combine several audio or video files into a single output file. The order can be easily rearranged using drag-and-drop.
• Intuitive Interface:
  • Clean, modern, and themeable interface (Light, Dark, and Black themes).
  • Full drag-and-drop support for adding and reordering files.
• Advanced Processing:
  • Hardware Acceleration: Automatically detects and utilizes GPU acceleration (NVIDIA, AMD, Intel) for significantly faster video encoding.
  • Audio Normalization: Adjusts the volume of all output audio to a standard level (LUFS), perfect for creating playlists with consistent volume.
  • Metadata Control: Choose to preserve or discard metadata (like title, artist, album) during conversion.
• File Management:
  • Preview media files directly within the app using FFplay.
  • View detailed technical information and metadata for any file.

---

Prerequisites

Regardless of the installation method, this application requires FFmpeg to function.

1. FFmpeg: The core of the application requires FFmpeg to function.

• You can download FFmpeg from the official website: https://ffmpeg.org/download.html
• After running the application, click the "FFmpeg Library" button to set the paths to the ffmpeg, ffprobe, and ffplay executables.

2. Python: If running from source, you will need Python 3.13 or higher.

---

Getting Started

Option 1: Download the Application (Recommended)

For most users, the easiest way to get started is to download the latest pre-built application. Currently, pre-built applications are available for Windows.

1. Go to the Releases Page.
2. Download the Simple-Media-Converter.exe file from the latest release.
3. No installation is needed. Just run the file to start the application.

Option 2: Run from Source (For Developers)

If you want to run the project from the source code, follow these steps:

1. Clone the repository:

   git clone [https://github.com/pyrus-code/simple-media-converter.git](https://github.com/pyrus-code/simple-media-converter.git)
   cd simple-media-converter

2. Install the required Python packages:

   pip install -r requirements.txt

3. Run the application:

   python main.py

---

License

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