Categorygithub.com/Ecasept/asciiplayer
repositorypackage
0.1.1
Repository: https://github.com/ecasept/asciiplayer.git
Documentation: pkg.go.dev

# README

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

(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

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

License

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