Skip to main content

📺 tvmux

Per-project/window tmux recorder using asciinema; records the current pane and follows the user around the current window.

Requires Python 3.13 or newer and tmux.

🎥 Usage

Install tvmux from pip or uv, or run standalone from uvx, like so:

$ uvx tvmux

The above will open a textual user interface, where you can view ongoing recordings, start + stop them etc.

You can start recording from the command line too:

# Start recording the current window
tvmux rec
# list ongoing recordings
tvmux rec ls
# stop them all
tvmux rec stop
# or pick them off like Docker containers
tvmux rec stop $(tvmux rec ls -q)

There's also a background server you can manage, and a CLI generated straight from its REST API if you want to poke at it:

tvmux server start|stop|status
tvmux api --help

By default, it'll save to ~/Videos/tmux/YYYY-MM/. See all configuration options:

# Show default config (TOML format)
tvmux config defaults

# Show available environment variables
tvmux config defaults --format=env

# Show your current config
tvmux config show

To customize, create ~/.tvmux.conf or use environment variables like TVMUX_OUTPUT_DIRECTORY.

🌍 See also

📺 asciinema The terminal recorder
🪟 textual TUI library for Python
🗔 bittty My terminal
🎬 sh2mp4 Convert this to MP4 files

Metadata

Release files for tvmux 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tvmux 0.7.0
File Size Uploaded Provenance Actions
tvmux-0.7.0.tar.gz 38.1 kB Without provenance Details for tvmux-0.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tvmux 0.7.0
File Interpreter ABI Platform Actions
tvmux-0.7.0-py3-none-any.whl Python 3 none any Details for tvmux-0.7.0-py3-none-any.whl

Total release size: 88.5 kB

Release files / tvmux-0.7.0.tar.gz

Download URL tvmux-0.7.0.tar.gz
Size 38.1 kB
Tags Source
SHA-256 checksum
How to use checksums
929119f59af942fea11ad13521c0e390ad1e0f17b1d95d0045506cf418b0edf0
BLAKE2b-256 checksum
How to use checksums
9117c19de2b6233ef5937fb20d542699223a48de357e3ec591fda9d0f8595037
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / tvmux-0.7.0-py3-none-any.whl

Download URL tvmux-0.7.0-py3-none-any.whl
Size 50.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a8ffe5ff0103f77fc4c503b27338996b09ae860fb3d369b1b44d9e51b4c69ed3
BLAKE2b-256 checksum
How to use checksums
74637e8aa7ec987574891cc9fa45bb2c780e5dc8d26a758f42060a9c2c43fa5d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for tvmux 0.7.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page