Recording a terminal or command line session
A terminal session recording has specific readability problems that a standard screen recording of a GUI application doesn’t — small monospace text, fast-moving output, and color schemes that often compress badly — each of which is worth addressing before you start recording rather than discovering on playback.
Font size matters more for terminal recordings than most other content
The default font size in most terminals is optimized for a developer sitting at the keyboard, not for a viewer watching a recording on any size screen. Temporarily increasing the font size specifically for the recording session — a setting in every major terminal — is the single fastest improvement to terminal recording readability, as covered in the font-size principle from our spreadsheet recording guide applied here to a different dense-content problem.
Widen the terminal window before recording
Narrow terminal windows force long commands to wrap awkwardly mid-line — a viewer reading a wrapped command often can’t tell where one command ends and the next begins, which defeats the purpose of showing them clearly. Recording with the terminal window wide enough that commands and output don’t wrap removes this specific confusion.
Choose a high-contrast color scheme for recording
Default terminal color schemes (dark backgrounds with low-saturation colored text) look fine in person and compress horribly under video encoding — colors that seemed distinct become muddy and washed out in the final recording. High-contrast themes — darker backgrounds with brighter, more saturated output colors — survive video compression significantly better.
Slow down command execution when output matters
Auto-scrolling terminal output that flashes past faster than a viewer can read it is a common issue specifically in tutorial recordings — where the point is often the output itself, not just the commands. Deliberately pausing after key commands, or using less to page through output, gives a viewer time to actually read what they’re supposed to be learning from.
Consider dedicated terminal recording tools for complex sessions
For multi-pane or complex terminal sessions, dedicated tools like asciinema (which records terminal sessions as text, not video, making output perfectly readable at any resolution) are worth considering alongside traditional screen recorders — each captures a different thing, and the right choice depends on whether you need a standard video file or a searchable, scalable text-based replay.
Frequently asked questions
How do I make my terminal recording easier to read?
Increase the font size, widen the terminal window to prevent command wrapping, and switch to a high-contrast color scheme before starting — these three changes improve readability more than any post-production edit.
Why does my terminal recording look muddy even though it looked fine live?
Video compression particularly struggles with low-contrast, subtle color differences common in default terminal themes — a higher-contrast color scheme survives the compression step significantly better.
Related reading: Recording a spreadsheet walkthrough · What resolution should you actually record at · Screen recording keyboard shortcuts worth actually memorizing