ffram
ffram — Fast FFmpeg Renderer for Audio and Moving-pictures
It is a highly interactive, beautifully styled Terminal User Interface (TUI) for executing complex media operations on Windows, macOS, and Linux.
It simplifies media processing with an intuitive menu system, native file picker dialogs, and real-time progress bars with ETAs and FPS—completely abstracting away complex FFmpeg command-line syntax.
Features
- 102 High-Performance Media Operations across 18 Specialized Categories.
- Interactive TUI built with
InquirerPyandrich. - Fuzzy Search to instantly find operations by name or description.
- Native File Picker Dialogs (just press Enter to browse visually).
- GPU Hardware Acceleration Auto-Detection (NVIDIA NVENC, Intel QSV, AMD AMF).
- Smart Quality Suggestions (CRF, bitrates) directly in the UI.
- Batch Processing capability.
Installation
pip install ffram
Requires Python 3.9+ and FFmpeg installed on your system PATH.
Quick Start
Simply run the tool from any terminal:
ffram
Categories Overview
- Video to Audio Extraction (7 ops)
- Audio Track Management (9 ops)
- Format & Container Conversion (8 ops)
- Video Compression & Bitrate Control (5 ops)
- Resolution & Upscale/Downscale (6 ops)
- Cut, Split & Trim Operations (5 ops)
- Stream & Track Removal (5 ops)
- Audio Filters & Volume Normalization (6 ops)
- Visual Effects & Filters (6 ops)
- Playback Speed & Frame Rate (6 ops)
- Frame Extraction & Animated GIFs (6 ops)
- Concatenation & Video Merging (4 ops)
- Watermarks & Text Overlays (5 ops)
- Aspect Ratio & Padding (5 ops)
- Subtitle Embedding & Extraction (6 ops)
- Metadata Inspection & Tagging (4 ops)
- Multi-File Batch Workflows (5 ops)
- Smart Multi-Step Pipelines (4 ops)
Contributing
We welcome contributions! Please see CONTRIBUTING.md for a 3-step guide on how to add your own FFmpeg operations to the toolkit.
License
MIT License. See LICENSE for details.
1 maintainer
Release files for ffram 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ffram-1.0.0.tar.gz | 33.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ffram-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 86.2 kB
Release files / ffram-1.0.0.tar.gz
| Download URL | ffram-1.0.0.tar.gz |
|---|---|
| Size | 33.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e2a8c73fcd95cee356879fe6248d49ee069a3de748bd9893eb326bb6a1c1a717
|
|
BLAKE2b-256 checksum How to use checksums |
c7c65f551c3e405a1d37ff7df6fb1e0b6edfc8ca8ad2818f11857d12efe7d242
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency logRelease files / ffram-1.0.0-py3-none-any.whl
| Download URL | ffram-1.0.0-py3-none-any.whl |
|---|---|
| Size | 52.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c5e814d46b76c2225d94c2c4449d4c75fb32e528f4cb419939c6a4ca4f64d8ce
|
|
BLAKE2b-256 checksum How to use checksums |
6d7fc2b4284045953e624eefd34f87f28e4d371074246fcf07be121c5e40bcad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency log
