https://github.com/sofianedjerbi/batimg

Fast image/video printing in your terminal
https://github.com/sofianedjerbi/batimg

ascii cli rust terminal unixporn

Last synced: about 2 months ago
JSON representation

Fast image/video printing in your terminal

• Host: GitHub
• URL: https://github.com/sofianedjerbi/batimg
• Owner: sofianedjerbi
• License: gpl-3.0
• Created: 2021-10-12T22:15:39.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2022-01-11T00:08:04.000Z (almost 3 years ago)
• Last Synced: 2024-10-12T03:44:21.190Z (2 months ago)
• Topics: ascii, cli, rust, terminal, unixporn
• Language: Rust
• Homepage:
• Size: 4.84 MB
• Stars: 30
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# batimg



  



`batimg` is a small program written in Rust, designed to be fast and compatible with every terminal.   

It can print images and play videos in almost [every format](https://ffmpeg.org/ffmpeg-formats.html) in your terminal.

## Build

Build bin and install dependencies: `cargo build --release`  

Bin location: `./target/release/adplay`

## Usage

```

USAGE:

    batimg [OPTIONS] 

ARGS:

        Path to the media

OPTIONS:

    -d, --debug         Print debug stats

    -a, --audio         Play video audio (unstable)

    -h, --help          Print help information

    -l, --loop          Loop the video 

    -s, --size     Canvas size

    -r, --resolution    Disable high resolution mode (half pixel character)

    -p, --prerender     Export frames first (unstable)

    -t, --timesync      Disable realtime synchronization

    -V, --version       Print version information

EXAMPLES: 

    batimg img.png

    batimg img.jpg -s 100

    batimg video.mp4 -a

    batimg animation.gif

```

## Goals

- [x] Show images

- [x] Play videos

- [x] Play audio

- [x] Improving the resolution

- [ ] Improving cleaning escape codes

- [ ] Getting rid of FFmpeg high CPU usage (Frame extraction)

## batimg vs catimg



	

	

	  

	    

	    batimg

	    catimg

	  

	

	

	  

	    creation date

	    2021

	    2013

	  

	  

	    language

	    rust

	    shell/c

	  

	  

	    format

	    

	        

	        almost all

		

	    

	    png/jpg/gif

	  

	  

	    dependencies

	    ffmpeg (videos)

	    imagemagick

	  

	  

	    resize algorithm

	    nearest neighbor

	    nearest color

	  

	  

	    resolution

	    ▀ / █

	    ▀ / ██

	  

	  

	    video support

	    yes

	    no

	  

	  

	    audio support

	    yes

	    no

	  

	  

	    CPU usage

	    medium (images) high (videos)

	    medium

	  

	  

	    prerendering

	    Disabled by default

	    Always enabled

	  

	  

	    time sync

	    Enabled by default

	    Seems enabled, but not on every gif

	  

	

	





  





Rendering comparison on pixel arts.