Skip to content

A CLI application to convert a video or gif into ASCII and play it in a terminal.

Notifications You must be signed in to change notification settings

zachspang/vidToAscii

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

vidToAscii

A CLI application to convert a video or gif into ASCII and play it in a terminal.

Example

As seen in the bottom right, the video will scale to whatever size the terminal is at the time the command is run.

example.mp4

Options

vidToAscii [flags]

Flag Description
-h --help help for vidToAscii
-i filepath --input filepath file path of input video
-b --background use background colors instead of ascii characters. This makes the video look like pixel art
-s --save save the converted data as a txt that can be loaded with --load
-l --load load saved data created by --save. Must use -i to specify filepath of save

Setup

  1. Install ffmpeg, ffprobe, and go

  2. Download or clone repository

  3. Navigate to the vidToAscii folder within the repository

  4. Intstall the application. This will create an executable. On Windows it will also add the executable to the PATH variable.

go install
  1. Run application
vidToAscii -i input.mp4
  1. List all options
vidToAscii --help

About

A CLI application to convert a video or gif into ASCII and play it in a terminal.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages