Version 10.2 — 10 October 2026

A Vibe Coded, feature-rich, dark-themed desktop GUI for FFmpeg built with Python and CustomTkinter, for Windows and Linux. Designed for content creators who work with audio editors and video editors such as DaVinci Resolve — fix, convert, inspect and process video files without touching the command line.

Main Interface — v10.2 (Video Crop & Stretch)

• New tool: Video Crop & Stretch — removes black edges from old or badly converted video, in two modes:
  • Stretch Mode trims the edges and stretches the picture back to fill the frame, so the frame size stays the same (a 960×720 video stays 960×720).
  • Crop Mode trims the edges and the frame gets smaller (960×720 becomes 936×720).
  • Use the on-screen arrow keys or the keyboard's arrow keys: → / ← trim more or less off the sides, ↑ / ↓ off the top and bottom. The picture always stays centred.
  • A live preview in a pale-blue frame (so black edges stand out), with a time slider and a Before / After switch.
• Taller window — the app now opens at 1150×845 (smaller screens get a window that fits).

• Video Scaler: new Scale slider — with Custom size chosen, slide from the centre (×1, the source size) left to shrink down to ×0.3, or right to enlarge up to ×3. The width and height fill in for you, and follow when you pick another file. Typing a size or choosing a preset puts it back to ×1.
• Video Scaler layout — Codec and Quality now come first, with Resolution and the Scale slider together underneath.
• Linux: the taskbar shows FFmpeg Toolkit and its icon instead of "Tk".

• A new dark "dashboard" look, matching JJ's Battery Health Analyser: deep navy background, rounded card panels (Files, Options and so on), a card-style sidebar with a blue highlight on the selected tool, and rounded status badges for FFmpeg / FFprobe.
• Dark menu bar — File and Operations now open dark menus (Alt+F / Alt+O still work). The log's right-click menu is dark too.
• Clearer action buttons — Run (and Inspect, Convert Selected, Trim & SAVE, Save Settings) is bright blue. Abort stays grey while nothing is running and turns crimson during an operation, so it's obvious when it can be used.
• Progress bar only while working — it no longer shows a bar when the app is idle.
• Smarter output file names — a name you type yourself is kept when you click away or press Run. Changing an option (e.g. the LUFS target) brings back the auto-generated name, so its tag always matches your settings.
• Clip & Track Editor — the Trim & SAVE and Abort buttons can no longer be squeezed out of sight by the track list.
• The window icon is built into the EXE — the ff logo now shows in the title bar wherever you put the EXE.

See the Changelog for the details, including the 9.3 fixes.

🖱️ The sidebar scrolls vertically — if the window is smaller than the full tool list, a scrollbar appears so every item stays reachable.

When you pick an input file, the Output File box fills in a suggested name with a tag describing what was done (e.g. Movie (-23 LUFS).mkv, Movie_720p.mp4). You can type any name you like instead:

• Your name is kept when you click elsewhere or press Run.
• Changing an option (LUFS target, mode, codec, format, resolution…) brings back the suggested name, so the tag matches the new settings.
• Choosing a new input file always starts a fresh suggested name.

• Windows 10/11 or Linux (Mint, Ubuntu, Debian and relatives)
• FFmpeg & FFprobe
  • Windows: place ffmpeg.exe and ffprobe.exe in the same folder as the app (or have them on your PATH)
  • Linux: installed automatically by install.sh
• Python 3.10+ — only needed to run from source or build the Windows executable

Download FFmpeg for Windows from ffmpeg.org/download.html (e.g. the gyan.dev "essentials" build).

1. Go to Releases (right-hand side of this page) and download ffmpeg_toolkit_v10-2-W.exe from the Assets of the latest release.
2. Put copies of ffmpeg.exe and ffprobe.exe in the same folder.
3. Double-click the EXE — no installation needed.

In some cases a copy of FFmpeg already on your computer will be found and used.

1. Download this repository (Code → Download ZIP) and extract it.
2. Double-click build.bat and, when asked, enter the number shown next to ffmpeg_toolkit_v10-2-W.py.
3. The finished ffmpeg_toolkit_v10-2-W.exe appears in the new dist\ folder. Copy it, with ffmpeg.exe and ffprobe.exe, to any folder you like.

pip install -r requirements.txt
python ffmpeg_toolkit_v10-2-W.py

Everything for Linux is in the LINUX PACKAGE folder.

1. Copy the LINUX PACKAGE folder to your home folder.
2. Open a terminal in that folder and run:

   bash install.sh

   It installs FFmpeg and Python's window toolkit (asks for your password), creates a private Python environment with CustomTkinter and Pillow, and adds FFmpeg Toolkit to the applications menu and the desktop.
3. Start the app from the applications menu, the desktop icon, or:

   ./run.sh

Updating an existing Linux install: copy the new ffmpeg_toolkit_v10-3-L.py into the folder — no reinstall needed. run.sh always starts the highest-numbered version, and the title bar shows which one is running (e.g. 10.3-L).

See LINUX PACKAGE/README.txt for troubleshooting, uninstalling and building an optional stand-alone Linux program.

FFmpeg-Toolkit/
├── ffmpeg_toolkit_v10-2-W.py    # The app (Windows)
├── build.bat                    # Builds the Windows EXE with PyInstaller
├── generate_ico.py              # Regenerates app_icon.ico during the build
├── icon_source.jpg              # Artwork for the icon
├── app_icon.ico                 # Window / EXE icon (also bundled inside the EXE)
├── Ffffreddy.mp4                # Easter egg (double-click the title icon)
├── requirements.txt             # Python packages
├── LICENSE
├── README.md
├── assets/                      # Source artwork for icons embedded in the code
├── screenshots/                 # Images used in this README
└── LINUX PACKAGE/
    ├── ffmpeg_toolkit_v10-3-L.py # The app (Linux)
    ├── install.sh               # One-time installer
    ├── run.sh                   # Launcher (always runs the newest version)
    ├── app_icon.png             # Menu / desktop icon
    ├── Ffffreddy.mp4            # Easter egg
    └── README.txt               # Linux instructions

• Python
• CustomTkinter — modern dark-themed UI
• Pillow — image handling
• FFmpeg & FFprobe — the multimedia engine underneath

MIT License — free to use, modify and distribute. See LICENSE.

FFmpeg itself is not included in this repository and is covered by its own licence.

Developed by Adrian Newington — JELLY-JAZZ SOFTWARE | Coding by Emergent.ai GitHub: github.com/SunflowerGUY

Built to solve real-world DaVinci Resolve audio tracking and timeline sync headaches — optimized for editors who are hard of hearing.

v10.2 (Windows) / v10.3-L (Linux) — 10 October 2026

• New tool: Video Crop & Stretch (under Video Scaler). Trims black edges, then either stretches the picture back to the original frame size, keeping the original pixel shape (Stretch Mode), or leaves the frame smaller (Crop Mode). On-screen arrow keys (a 90×90 key pad) and the keyboard's arrow keys stretch in 2-pixel steps per side; hold a key to repeat. Live preview in a pale-blue frame with a time slider, Before / After and Reset, plus a short "How it works" panel next to Run / Abort.
• Window opens at 1150×845, capped to the screen height.

v10.1 (Windows) / v10.2-L (Linux) — 10 October 2026

• Video Scaler: new Scale slider for custom sizes — ×1 in the centre, down to ×0.3 or up to ×3, in steps of 0.05. It fills in the width and height from the source's size and re-applies when you choose another file. It's greyed out unless Resolution is Custom size, and goes back to ×1 when you type a size or pick a preset.
• Video Scaler: the Codec / Quality row now sits above Resolution.
• The Linux taskbar fix from 10.1-L is in both versions.

v10.1-L — 9 October 2026 (Linux only)

• The taskbar now shows FFmpeg Toolkit and its icon instead of "Tk". Re-run bash install.sh once to update the menu entry as well.

v10.0 — 29 September 2026

• New look: dark "dashboard" theme matching JJ's Battery Health Analyser — navy background, rounded card panels, card-style sidebar with a highlighted current tool, status badges, and the Segoe UI font (DejaVu Sans on Linux).
• Dark menu bar replacing the light Windows one: File and Operations open dark menus (Alt+F / Alt+O); the log's right-click menu is dark too.
• Buttons: Run-type buttons are blue; Abort is grey until an operation is running, then crimson. Disabled buttons look disabled.
• Progress bar is hidden while idle and only appears when a job is running.
• Every tool restyled, including the Clip & Track Editor player, Batch ProRes / Batch Audio file lists, Inspect, Custom Command, Settings, the folder browser, tooltips and the welcome screen.
• Output names: changing an option now brings back the auto-generated name (with the new tag, e.g. a different LUFS value); a typed name is still kept when you click away or press Run.
• Clip & Track Editor: fixed the Trim & SAVE and Abort buttons being squeezed out of view by the track list.
• File > Exit now closes the app the same way as the window's ✕ button (stops any preview playback).
• Windows EXE: the icon is bundled inside the EXE, so the title bar shows the ff logo instead of the default "C" icon.

v9.3 — 29 September 2026

• Output file name: a name you type into the Output File box is no longer replaced by the auto-generated name when the Input box loses focus or you press Run.
• Abort (Linux): fixed the app crashing when Abort was pressed — log updates from the background are now handed to the window safely, and the "Aborting…" popup always closes.
• Audio Accessibility — subtitle check: MP4 can't hold picture subtitles (DVD/Blu-ray), and MOV only takes its own text format. Instead of FFmpeg failing, you're now warned before the run and can switch to MKV, continue without subtitles, or cancel. The conversion report notes whether subtitles were kept.

v9.2 — 27 September 2026

• New: Subtitles Extractor — save one or all subtitle tracks as standalone files, keeping the original format or converting text subtitles to SRT, WebVTT or ASS. Picture subtitles (PGS / VobSub / DVB) are saved as .sup / .mks.
• New SUBTITLES section in the sidebar.
• Smaller, lighter version and build date next to the app title.
• About screen now shows JELLY-JAZZ SOFTWARE.

v7.0.2 — 23 September 2026

• Audio Accessibility - Output Format Selector:
  • Added a container picker (MKV, MOV, MP4) so converted files aren't locked to the source container's extension.
  • The output filename's extension now updates live as the format is changed, and MP4 output automatically remuxes subtitles to mov_text.
  • Added a compatibility guardrail: selecting PCM audio with an MP4 container now prompts a confirmation warning, since MP4 doesn't reliably support PCM audio.
• Audio Accessibility - Conversion Report:
  • Every successful run now writes an FF-Toolkit Conversion Report.txt into the output folder, listing full input/output stream specs (container, codecs, resolution, channels, sample rate) and a summary of the settings applied.
• Audio Accessibility - Layout Cleanup:
  • Reworked the panel's row alignment so every label/control column lines up consistently, and moved Run/Abort next to the Audio Track row.

v4.4 — 11 September 2026

• Audio Accessibility Redesign:
  • Added a new Output Codec Toggle to quickly swap between lossless editing formats (PCM) and server storage profiles (AAC).
  • Implemented the Stereo Downmix (2.0) feature to compress surround tracks and pull centre-channel dialogue forward for the hard of hearing.
  • Added a custom -20 LUFS target loudness preset to balance speech enhancement with cinematic dynamic range preservation.
• DaVinci Resolve Optimization Overhaul:
  • Upgraded Stubborn Fix to transcode audio into uncompressed 16-bit PCM inside a .mov container, fixing missing-audio timeline errors.
  • Rewrote the Trim Clip and Still Frame Export algorithms to use precise output seeking, preventing frozen or black first frames.
  • Optimized Proxy Creator and ProRes Export with precise Rec.709 colour tags, ending the washed-out gamma shift bug in Resolve.
• Architecture & System Reliability:
  • Replaced ffmpeg -i inspect logs with a lightweight FFprobe query to display clean stream data.
  • Fortified the Batch Audio Convert file scanner with case-insensitive deduplication and live output streaming to prevent interface freezing.
• Added -hide_banner to every tool to keep logs clear.