https://github.com/rmuraix/fmex

A terminal UI to extract precise frames from video with Sixel preview.
https://github.com/rmuraix/fmex

frame-extraction sixel textual tui video-processing

Last synced: 3 months ago
JSON representation

A terminal UI to extract precise frames from video with Sixel preview.

• Host: GitHub
• URL: https://github.com/rmuraix/fmex
• Owner: rmuraix
• License: mit
• Created: 2026-02-14T17:35:23.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-02-15T15:48:43.000Z (4 months ago)
• Last Synced: 2026-02-15T17:07:08.664Z (4 months ago)
• Topics: frame-extraction, sixel, textual, tui, video-processing
• Language: Python
• Homepage: https://pypi.org/project/fmex/
• Size: 1000 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# fmex

[![PyPI - Version](https://img.shields.io/pypi/v/fmex)](https://pypi.org/project/fmex/)

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fmex)](https://pypi.org/project/fmex/)

[![GitHub License](https://img.shields.io/github/license/rmuraix/fmex)](https://github.com/rmuraix/fmex/blob/main/LICENSE)

[![Check](https://github.com/rmuraix/fmex/actions/workflows/check.yaml/badge.svg)](https://github.com/rmuraix/fmex/actions/workflows/check.yaml)

[![codecov](https://codecov.io/gh/rmuraix/fmex/graph/badge.svg?token=z6XwE8PkrK)](https://codecov.io/gh/rmuraix/fmex)

Terminal-based frame extractor for video files.

## About

`fmex` opens a local video, lets you move frame-by-frame in a TUI, previews the selected frame, and saves the current frame as PNG.

![fmex](https://github.com/rmuraix/fmex/raw/main/assets/ui.png)

## Usage

```bash

# Save to current directory

uvx fmex /path/to/video.mp4

# Save to custom output directory (auto-created if missing)

uvx fmex /path/to/video.mp4 --outdir ./exports

```

Keyboard controls:

- `Left` / `h`: Prev

- `Right` / `l`: Next

- `Shift` + `Left`/`Right`: ±10

- `Ctrl` + `Left`/`Right`: ±100

- `j`: Jump to time (seconds)

- `s`: Save PNG

- `q`: Quit

## Contributing

Your contribution is always welcome. Please read [Contributing Guide](https://github.com/rmuraix/.github/blob/main/.github/CONTRIBUTING.md).