cmdplay-pp

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 67 Open GitHub ↗

Next generation CmdPlay; Realtime CLI for Colour ASCII playback

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# cmdplay-pp
# What is this?
This is the next, improved version of CmdPlay (https://github.com/mariiaan/CmdPlay).
It's an improved version of the original project.

# Features
Plays videos back in command line in ascii-art.
- Colour support: play videos in colour!
- Dithering support: dithers grayscale and colours!
- Dynamic resizing: you can resize your console window while playing to obtain a higher/lower resolution!

# Screenshots
Demonstration of standard resolution; grayscale; dithering:
![Screenshot](https://marian.aomoridev.com/projects/cmdplaypp/screenshot1.png)
(Video: Bad Apple!)

Demonstration of high resolution; colours; dithering:
![Screenshot](https://marian.aomoridev.com/projects/cmdplaypp/screenshot2.png)
(Video: [Alexandros] - Dracula La)

Demonstration of true-colour; full-pixel:
![Screenshot](https://marian.aomoridev.com/projects/cmdplaypp/screenshot3.png)
(Video: haruka-chan e.1)

# What got better (in comparison to the original project)
- now uses multi-threading for decoding videos!
- way faster
- doesn't need to precompute all frames before playing them back, does it while playing!
- colours as mentioned earlier

# Usage
Run cmdplay, enter the file path (most terminal emulators also support drag and drop) and press enter!
You can also pass the file name of the video as the first parameter, it will play the video automatically.

# Performance tips
- You should use windows terminal instead of the original windows conhost (known as cmd.exe). This will improve performance significantely due to optimizations in windows terminal.
- Colours enabled will drop performance significantely due to the terminal not being optimized for that use, so use low resolutions while colours being enabled
- Dithering in any way (colours and text dithering) will also reduce performance because it circumvents windows terminal optimizations, so again, use low resolutions

Using windows terminal with colours disabled should allow you to use pretty high resolutions!

# Controls
SPACE - play/pause

C - toggle colours

D - toggle colour dithering

T - toggle text / grayscale dithering

Q - quit

A - accurate colours (true-colour)

B - full pixel

# Libraries, this project depends on
- FFmpeg (https://www.ffmpeg.org/)

# License
The code of this project (cmdplaypp/src) is licensed under the MIT license. TLDR: You can do whatever you want with the code as long as you include the license and the original copyright message. (LICENSE file)
The project also uses FFmpeg (https://ffmpeg.org/) which is licensed under LGPL 2.1+.

Pull-requests will be reviewed and accepted, please keep your code simple, short and understandable!
thank you for all your support

cmdplay-pp

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README