Files
mkv_tool_gui/README.md
2025-08-19 08:11:43 +02:00

53 lines
2.2 KiB
Markdown

# MKV Tool GUI — Extract & Pack
A simple, intuitive graphical user interface for extracting streams from and packing streams into Matroska (MKV) files. This tool is designed to be a lightweight and user-friendly alternative to more complex applications, focusing on the most common extraction and packing tasks.
## Key Features
This tool offers a streamlined and intuitive experience for common MKV tasks:
* **Focused Interface:** The UI is split into two simple tabs: "Extract" and "Pack", with no complex menus or obscure options to navigate.
* **Simplified Workflow:**
* **Extraction:** Open an MKV file, and all its streams are listed with sensible default output filenames. Uncheck the ones you don't want and click "Extract".
* **Packing:** Add your video, audio, subtitle, and font files, and click "Pack". The tool handles the rest.
* **Drag-and-Drop:** Easily add files by dragging them onto the application window. The tool automatically detects the file type and adds it to the correct list.
* **Smart Defaults:** The tool suggests logical filenames for extracted streams, saving you time and effort.
## Requirements
* **Python 3**
* **Required Command-Line Tools:** The following tools must be installed and available in your system's PATH:
* `ffmpeg`
* `ffprobe`
* `mkvextract`
## Setup and Running
1. **Clone the repository or download the files.**
2. **Install the required Python packages:**
```sh
pip install -r requirements.txt
```
3. **Run the application:**
```sh
python3 mkv_tool_gui.py
```
## Features
### Extract Tab
* Open an MKV file to see all its video, audio, subtitle, and attachment (e.g., fonts) streams.
* Each stream is listed with its type, codec, and language.
* Editable output filenames are suggested automatically.
* Select the streams you want to extract and choose an output folder.
* Drag and drop an MKV file onto the window to open it.
### Pack Tab
* Add video, audio, subtitle, typeface, and chapter files.
* Streams are packed into a new MKV container without re-encoding.
* Drag and drop your source files onto the window to add them to the packing list.