[GH-ISSUE #133] terminal playback controls #717

Closed
opened 2026-03-15 09:59:25 +03:00 by kerem · 10 comments
Owner

Originally created by @omaraboumrad on GitHub (Dec 10, 2015).
Original GitHub issue: https://github.com/asciinema/asciinema/issues/133

Hello,

It would be nice if asciinema play <file> supported some playback controls through intercepting keyboard commands, example but not limited to:

Ctrl+P Toggle pause/play at current play step.
Ctrl+H Move one step backwards
Ctrl+L Move one step forward

Given the local player blends in perfectly in the terminal, there's no need to show any information about these controls during the playback.

Use Case

If I'm running a presentation or a demo, I'd like to be able to control the playback instead of anticipating it during the recording time.

Thank you!

Originally created by @omaraboumrad on GitHub (Dec 10, 2015). Original GitHub issue: https://github.com/asciinema/asciinema/issues/133 Hello, It would be nice if `asciinema play <file>` supported some playback controls through intercepting keyboard commands, example but not limited to: `Ctrl+P` Toggle pause/play at current play step. `Ctrl+H` Move one step backwards `Ctrl+L` Move one step forward Given the local player blends in perfectly in the terminal, there's no need to show any information about these controls during the playback. **Use Case** If I'm running a presentation or a demo, I'd like to be able to control the playback instead of anticipating it during the recording time. Thank you!
kerem 2026-03-15 09:59:25 +03:00
Author
Owner

@omaraboumrad commented on GitHub (Dec 11, 2015):

Related: #97

<!-- gh-comment-id:163872922 --> @omaraboumrad commented on GitHub (Dec 11, 2015): Related: #97
Author
Owner

@renatomefi commented on GitHub (Mar 11, 2016):

I would also like to see this feature! :)

<!-- gh-comment-id:195381860 --> @renatomefi commented on GitHub (Mar 11, 2016): I would also like to see this feature! :)
Author
Owner

@cypa commented on GitHub (Jan 28, 2017):

this feature is much needed for security audit purposes also

<!-- gh-comment-id:275846181 --> @cypa commented on GitHub (Jan 28, 2017): this feature is much needed for security audit purposes also
Author
Owner

@robertpeteuil commented on GitHub (May 6, 2017):

It's been a year, so I thought I'd surface this request again.

While I'm interested in the original request, I'm especially interested in the "play/pause" feature. This would allow me to use asciinema in live presentations (where pausing is necessary for discussion or answering questions).

Feature Request Enhancements:

  • For the "live demo" scenario - mapping the "play/pause" action to a mouse button would be ideal

    • Most users are accustomed to using mouse-clicks to play/pause videos
    • Many presenters use use wireless mice for live presentations
  • Instead of "Move one step backward", I'd prefer "jump 5 back seconds"

    • Essentially like "instant replay" on a DVR
    • This is useful for anyone wanting to re-watch an event that just occurred in a recording
<!-- gh-comment-id:299658922 --> @robertpeteuil commented on GitHub (May 6, 2017): It's been a year, so I thought I'd surface this request again. While I'm interested in the original request, I'm especially interested in the "play/pause" feature. This would allow me to use asciinema in live presentations (where pausing is necessary for discussion or answering questions). Feature Request Enhancements: - For the "live demo" scenario - mapping the "play/pause" action to a mouse button would be ideal - Most users are accustomed to using mouse-clicks to play/pause videos - Many presenters use use wireless mice for live presentations - Instead of "Move one step backward", I'd prefer "jump 5 back seconds" - Essentially like "instant replay" on a DVR - This is useful for anyone wanting to re-watch an event that just occurred in a recording
Author
Owner

@kostaz commented on GitHub (Jul 19, 2017):

Actually, the lack of play controls in terminal (pause, play, fast-forward, fast-backward)
in the only feature that prevents this app from becoming mainstream.
👍

<!-- gh-comment-id:316343549 --> @kostaz commented on GitHub (Jul 19, 2017): Actually, the lack of play controls in terminal (pause, play, fast-forward, fast-backward) in the only feature that prevents this app from becoming mainstream. :+1:
Author
Owner

@ku1ik commented on GitHub (Jul 19, 2017):

Pause, play and fast-forward would be easy to add.

Rewinding on the other hand is impossible with the current (simple) implementation of asciinema play. This page nicely describes this problem and how IPBT solves it: https://www.chiark.greenend.org.uk/~sgtatham/ipbt/ (when reading replace ttyrec with asciinema and you'll get the picture).

<!-- gh-comment-id:316385321 --> @ku1ik commented on GitHub (Jul 19, 2017): Pause, play and fast-forward would be easy to add. Rewinding on the other hand is impossible with the current (simple) implementation of `asciinema play`. This page nicely describes this problem and how IPBT solves it: https://www.chiark.greenend.org.uk/~sgtatham/ipbt/ (when reading replace `ttyrec` with `asciinema` and you'll get the picture).
Author
Owner

@robertpeteuil commented on GitHub (Jul 19, 2017):

Thanks for sharing this info. It makes the challenges of rewind very clear.

Simply adding play/pause would be a huge leap forward in usefulness.

<!-- gh-comment-id:316427503 --> @robertpeteuil commented on GitHub (Jul 19, 2017): Thanks for sharing this info. It makes the challenges of rewind very clear. Simply adding play/pause would be a huge leap forward in usefulness.
Author
Owner

@ku1ik commented on GitHub (Nov 25, 2017):

Toggling pause with space + stepping a frame at a time with period just landed in develop branch and will be released in 2.0 🙂

<!-- gh-comment-id:346973814 --> @ku1ik commented on GitHub (Nov 25, 2017): Toggling pause with space + stepping a frame at a time with period just landed in develop branch and will be released in 2.0 🙂
Author
Owner

@robertpeteuil commented on GitHub (Nov 26, 2017):

Awesome. Thanks all!

<!-- gh-comment-id:346975521 --> @robertpeteuil commented on GitHub (Nov 26, 2017): Awesome. Thanks all!
Author
Owner

@omaraboumrad commented on GitHub (Nov 26, 2017):

Brilliant!

<!-- gh-comment-id:346976073 --> @omaraboumrad commented on GitHub (Nov 26, 2017): Brilliant!
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/asciinema#717
No description provided.