[GH-ISSUE #343] Key bindings for `rec` and `play` commands #221

New issue

Closed

opened 2026-02-25 20:33:06 +03:00 by kerem · 0 comments

kerem commented

2026-02-25 20:33:06 +03:00

Owner

Originally created by @ku1ik on GitHub (Mar 30, 2019).
Original GitHub issue: https://github.com/asciinema/asciinema/issues/343

As mentioned in #340, #341, #324 the need for several key bindings emerged.

So far we only used space (pause/resume) and . (step 1 frame forward) for asciinema play.

#340 and #341 brough a need for key bindings for asciinema rec. At the moment toggling recording pause is hard-coded to ctrl+p ("p" for "pause capture"), and adding a breakpoint is hard-coded to ctrl+b ("b" for breakpoint).

It is very likely that the both ctrp-p and ctrl-b will conflict with many interactive applications (e.g. vim), so we should either find better, rarely used alternatives, or go with a prefix + key combo (like ctrl+a in screen, ctrl+b in tmux).

I don't believe we'll find a default that will work equally well for everyone, so there should be a way to customize the key bindings (for both asciinema play and asciinema rec) via configuration file.

Originally created by @ku1ik on GitHub (Mar 30, 2019). Original GitHub issue: https://github.com/asciinema/asciinema/issues/343 As mentioned in #340, #341, #324 the need for several key bindings emerged. So far we only used <kbd>space</kbd> (pause/resume) and <kbd>.</kbd> (step 1 frame forward) for `asciinema play`. #340 and #341 brough a need for key bindings for `asciinema rec`. At the moment toggling recording pause is hard-coded to ctrl+p ("p" for "pause capture"), and adding a breakpoint is hard-coded to ctrl+b ("b" for breakpoint). It is very likely that the both ctrp-p and ctrl-b will conflict with many interactive applications (e.g. vim), so we should either find better, rarely used alternatives, or go with a prefix + key combo (like ctrl+a <key> in screen, ctrl+b <key> in tmux). I don't believe we'll find a default that will work equally well for everyone, so there should be a way to customize the key bindings (for both `asciinema play` and `asciinema rec`) via configuration file.