📺 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.
🔗 links
🌍 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.