Skip to main content

A terminal UI for FFmpeg built with Python and ncurses.

Project description

ncmpeg

ncmpeg is a terminal-based UI for FFmpeg, built with Python and ncurses.
It removes the need to memorize long command-line flags and gives you a fast, minimal way to handle common media tasks directly from your terminal.

Features

Video

  • Convert formats
  • Cut by start and end time
  • Merge multiple video files
  • Resize, crop, rotate or flip
  • Burn hardcoded .srt subtitles
  • Extract frames to PNG
  • Generate GIFs
  • Change playback speed (with audio)
  • Overlay an image or watermark
  • Strip metadata
  • Display video info using ffprobe

Audio

  • Extract audio from video
  • Adjust volume
  • Normalize loudness
  • Change audio playback speed
  • Strip metadata
  • Display audio info using ffprobe

Installation

Install via pip:

pip install ncmpeg

Then run the app:

ncmpeg

To install from source:

git clone https://github.com/bearenbey/ncmpeg.git
cd ncmpeg
pip install .
ncmpeg

Dependencies:

  • Python 3.8 or higher
  • FFmpeg and ffprobe installed and available on your system

Usage

  • Use ↑ ↓ to navigate through operations or files
  • Use Tab to switch between the operations panel and the file panel
  • Press Enter to select or confirm
  • Press Esc to cancel input
  • Press q to quit the app

The file panel shows the current working directory. You can refer to it while filling in filenames or parameters on the left.

License

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/.

© 2025 Eren Öğrül termapp@pm.me

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ncmpeg-0.1.8.tar.gz (6.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ncmpeg-0.1.8-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file ncmpeg-0.1.8.tar.gz.

File metadata

  • Download URL: ncmpeg-0.1.8.tar.gz
  • Upload date:
  • Size: 6.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for ncmpeg-0.1.8.tar.gz
Algorithm Hash digest
SHA256 57c6792f6b8e8f59fef4a52b376c2952f663e5868ac9f08ed137340bbde10f68
MD5 5ca4bba59513fc903cb9c50869d474ea
BLAKE2b-256 a311f5eb108c976dee893f97f0b8eafee6d0cd2bd9e585e610030fbb9e935d26

See more details on using hashes here.

File details

Details for the file ncmpeg-0.1.8-py3-none-any.whl.

File metadata

  • Download URL: ncmpeg-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 6.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for ncmpeg-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 153bb7a6dde12f439f71491017db62ddb2dae73c8aeb207be0f2ac1c001fdb2f
MD5 8d954b61e8f77c60e88c9f4f7369ea44
BLAKE2b-256 b39c4ac76f7d5e74300503838d8a771bc0ceccd7903e5fb68e750e3f695c474d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page