Skip to content

Ecasept/asciiplayer

Repository files navigation

asciiplayer

A video player for your terminal

🎉 Features

  • 🎬 Play most video formats (uses ffmpeg under the hood)
  • 🔊 Supports audio playback
  • 📐 Automatically resize to the terminals current size
  • 🔤 Different character sets
  • 🎨 ${{\large\textsf{{\color{Red}C}{\color{Orange}o}{\color{Yellow}l}{\color{Green}o}{\color{Aqua}r} {\color{Purple}s}{\color{Pink}u}{\color{Red}p}{\color{Orange}p}{\color{Yellow}o}{\color{Green}r}{\color{Aqua}t}}}}$

Demo

ASCII video

demo.mp4
(sorry for the stuttering and bad audio quality, my computer couldn't handle the recording)

Color support

An image from Big Buck Bunny renderd on a terminal

Usage

Play a video:

asciiplayer video.mp4
asciiplayer animated.gif # also supports gif
asciiplayer video.mkv # ... and many other formats
asciiplayer v1.mp4 v2.mp4 v3.mp4 # play multiple videos sequentially

More flags:

asciiplayer -c video.mp4 # enable color
asciiplayer -c -ch filled video.mp4 # use unicode full blocks (█) to render colored video
asciiplayer -fps 10 video.mp4 # play video at specific fps
asciiplayer -height 20 video.mp4 # play video at a specific resolution
asciiplayer -h # show help

Download

Get the binary from the releases tab.

You can also build the binary yourself:

git clone https://github.com/Ecasept/asciiplayer
cd asciiplayer
go build -o build/asciiplayer .
./build/asciiplayer -v # verify that it worked

Build

To build the project, you will need to have the ffmpeg development libraries installed:

# For Fedora:
# Check which version of ffmpeg you have installed:
dnf list --installed "ffmpeg*"
# If you have `ffmpeg-free` installed:
sudo dnf install ffmpeg-free-devel
# If you have `ffmpeg` installed:
sudo dnf install ffmpeg-devel

License

This project is licensed under the GNU General Public License v3.0 or later.

About

A video player for your terminal

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages