ttystudio
A terminal-to-GIF/APNG recorder with no external dependencies, capable of recording over SSH.
What is ttystudio?
ttystudio is a Node.js-based terminal recorder that captures terminal sessions and compiles them into animated GIFs or APNGs. It solves the problem of creating terminal screencasts without relying on external dependencies like ImageMagick, GUI recording tools, or complex bash scripts. The tool works entirely in JavaScript (with a small C++ binding for terminal spawning) and can even record over SSH since it doesn't require a GUI.
Developers, technical writers, and educators who need to create high-quality terminal screencasts for tutorials, documentation, or demonstrations. It's particularly useful for those working in headless environments or over SSH.
ttystudio stands out by offering a completely self-contained recording and compilation pipeline, eliminating glitches from GUI playback or gif concatenation. Its ability to record without a GUI and its built-in font rendering make it uniquely reliable for remote terminal recording.
Overview
A terminal-to-gif recorder minus the headaches.
Use Cases
Best For
- Creating terminal tutorials for documentation or blog posts
- Recording CLI tool demonstrations without GUI dependencies
- Generating animated examples for open-source project READMEs
- Capturing terminal sessions over SSH for remote debugging
- Producing high-quality GIFs/APNGs for conference presentations
- Taking multiple screenshots during terminal sessions with custom hotkeys
Not Ideal For
- Projects requiring real-time video with audio or interactive overlays
- Teams needing extensive post-production editing or integration with video editing software
- Users who require anti-aliased fonts or easy font switching without manual conversion
Pros & Cons
Pros
Eliminates need for external tools like ImageMagick by including built-in GIF and APNG writers, streamlining the recording process as stated in the README's key features.
Uses font-based rendering to record over SSH without a GUI, making it ideal for remote terminal sessions, a standout feature highlighted in the README.
Automatically compiles frames into one GIF or APNG, avoiding the hassle of concatenating hundreds of individual files, as emphasized in the usage examples.
Includes built-in frame offset optimization for efficient animations, reducing file size without manual tweaking, mentioned in the README's difference section.
Cons
Requires fonts in BDF format with manual JSON conversion via a make step, and the README's Todo list notes lack of anti-aliased font support, limiting typographic flexibility.
Can face memory overflows with global palettes for APNGs (requiring --rgba flag to avoid), and the README mentions input lag on OSX due to pty.js, affecting reliability.
Offers basic range selection and borders but lacks advanced editing features like cropping, overlays, or audio synchronization, making it less versatile for polished productions.
Frequently Asked Questions
Related Projects
asciinemaTerminal session recorder, streamer and player 📹
gifsicleCreate, manipulate, and optimize GIF images and animations
ttygifConvert terminal recordings to animated gifs
GifgenSimple high quality GIF encoding
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.