# Install termrec with Homebrew, apk, apt, zypper

Record videos of terminal output. Version 0.19 via Homebrew; verified from local package data. Also installable with ubuntu: sudo apt install libtty-dev.

## Install

```sh
sudo av install brew:termrec
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install termrec
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add termrec
```

  Evidence: Alpine Linux edge package indexes: termrec from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz

- Ubuntu apt (92%):

```sh
sudo apt install termrec
```

  Evidence: Ubuntu 24.04 LTS package indexes: termrec from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz

- zypper (92%):

```sh
sudo zypper install termrec
```

  Evidence: openSUSE Tumbleweed package metadata: termrec from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## Package facts

- **Package key:** brew:termrec
- **Package manager:** Homebrew
- **Version:** 0.19
- **Source summary:** Record videos of terminal output
- **Homepage:** <https://angband.pl/termrec.html>
- **Repository:** <https://github.com/kilobyte/termrec>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- termcat (alias)
- termplay (alias)
- termrec (alias)
- termtime (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.19
## Project history and usage

termrec is a terminal-session recorder and player for making 'videos' of terminal output. Its official page places it in the same family as ttyrec, nh-recorder, and script/replay.

### Project history

The GitHub repository dates to April 2010, but the official project page presents termrec as part of the older ttyrec-style recording culture. Rather than capturing pixels, it records terminal output and timing so sessions can be replayed, converted, measured, or inspected.

Version 0.18 is documented as a substantial modernization point: the library API became stable, asciicast v1 and v2 support was added, zstd compression was added, CURL fetching appeared, proxyrec was dropped, and tty emulation gained improvements such as CJK width, combining characters, overstrike, 24-bit color, more ANSI codes, and window-title storage.

### Adoption history

termrec is a smaller, specialist package. This batch input lists apk, Homebrew, Ubuntu's libtty-dev, and zypper's libtty-devel, which suggests it is packaged both as command-line utilities and as a library/API dependency in some distributions.

### How it is used

The official page documents several tools: `termrec` records a shell or command, `termplay` replays recordings, `termtime` measures recording lengths, and `termcat` copies or converts ttyrec files. Older documentation also described `proxyrec`, a TELNET proxy used to capture network sessions.

The T2T proxy section shows a concrete historical niche: capturing MUD/TELNET play sessions for later export. That is a classic terminal-recording use case alongside demos, debugging, and sharing interactive command-line runs.

### Why package nerds care

termrec matters to package nerds because it connects old ttyrec artifacts with newer terminal-sharing formats such as asciicast, while preserving low-level terminal semantics. Its value is less broad popularity and more interoperability: conversion, playback, compression, and a stable library API for terminal recordings.

### Timeline

- 2010: Public GitHub repository created on April 20.
- Version 0.18: Stable library API and ABI declared.
- Version 0.18: asciicast v1/v2, zstd compression, CURL fetching, and improved tty emulation added.
- Version 0.18: proxyrec dropped from the current release line.

### Related projects

- The official page names ttyrec, nh-recorder, and Joey Hess' script/replay as related predecessors. With asciicast support, termrec is also adjacent to the asciinema ecosystem.

### Sources

- GitHub repository metadata: https://api.github.com/repos/kilobyte/termrec
- Input source_facts.package-manager
- Official project page: https://angband.pl/termrec.html


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Other Package-Manager Records

- Ubuntu apt - libtty-dev - 0.19-2.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libtty-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | terminal/ttyrec library -- development | https://angband.pl/termrec.html
- Ubuntu apt - libtty1t64 - 0.19-2.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libtty1t64 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | terminal/ttyrec library -- runtime | https://angband.pl/termrec.html
- Ubuntu apt - termrec - 0.19-2.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: termrec from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | terminal videos/scripts recorder and player | https://angband.pl/termrec.html
- apk - termrec - 0.19-r6: normalized package name match | Alpine Linux edge package indexes: termrec from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Program for recording videos of terminal output | https://angband.pl/termrec.html
- apk - termrec-dev - 0.19-r6: normalized package name match | Alpine Linux edge package indexes: termrec-dev from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Program for recording videos of terminal output (development files) | https://angband.pl/termrec.html
- apk - termrec-doc - 0.19-r6: normalized package name match | Alpine Linux edge package indexes: termrec-doc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Program for recording videos of terminal output (documentation) | https://angband.pl/termrec.html
- zypper - libtty-devel - 0.19-1.24: normalized package name match | openSUSE Tumbleweed package metadata: libtty-devel from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Library for Terminal Handling | http://angband.pl/termrec.html
- zypper - libtty1 - 0.19-1.24: normalized package name match | openSUSE Tumbleweed package metadata: libtty1 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Library for Terminal Handling | http://angband.pl/termrec.html
- zypper - termrec - 0.19-1.24: normalized package name match | openSUSE Tumbleweed package metadata: termrec from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Records Videos of Terminal Output | http://angband.pl/termrec.html


## Combined YAML source

View the package source record on GitHub. [combined/termrec.yml](https://github.com/mxcl/pkgdb/blob/main/combined/termrec.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
