steam-clip-tui 0.1.1

TUI for browsing and exporting Steam game recording clips

Steam Clip TUI

A terminal application for browsing and exporting Steam game recording clips, built with Textual.

Features

• Browse clips — automatically scans your Steam userdata directory, organizes clips by game
• Preview — inline thumbnail preview in terminals that support image protocols (kitty, Sixel, iTerm2, WezTerm)
• Export to MP4 — join DASH segments into a single MP4 via ffmpeg, with real-time progress tracking
• Customizable output — choose video codec (copy/H.264/H.265/VideoToolbox), resolution (source/1080p/720p/480p), bitrate, and filename template
• Game name resolution — resolves Steam app IDs to human-readable names via appmanifest files and the Steam Store API, with a local disk cache

Requirements

• Python 3.11+
• ffmpeg (must be on PATH)
• Steam with game recording enabled (clips stored in userdata/)

Installation

# Run directly without installing (recommended)
uvx steam-clip-tui

# Or install globally with uv
uv tool install steam-clip-tui

# Or install with pipx
pipx install steam-clip-tui

# Or install with pip
pip install steam-clip-tui

Usage

steam-clip-tui

Keyboard shortcuts

Key	Action
j / ↓	Move down
k / ↑	Move up
g	Focus game list
Tab	Cycle focus between panes
Space	Toggle clip selection
e	Export selected clip
?	Show help
q	Quit

Configuration

On first run, a config file is created at your platform's config directory (e.g. ~/.config/steam-clip-tui/config.toml on Linux, ~/Library/Application Support/steam-clip-tui/config.toml on macOS). See config.default.toml for all available options.

Key settings:

[export]
output_dir = "~/Movies/SteamClips"
video_codec = "copy"        # copy | libx264 | libx265 | h264_videotoolbox | hevc_videotoolbox
resolution = "source"       # source | 1080p | 720p | 480p
filename_template = "{game}/{date}_{time}.{ext}"

[ui]
enable_images = true

License

WTFPL