asciiplayer

command module
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 1, 2025 License: GPL-3.0 Imports: 23 Imported by: 0

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
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.

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL