No commit activity in last 3 years
No release in over 3 years
Display images on the commandline using blocks of color with true color support
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.7
~> 10.0

Runtime

>= 2.15.3, ~> 2.15
>= 2.1.2, ~> 2.1
 Project Readme

The Ruby Blocky Image Viewer

tl;dr: terminal image displayer that’s a shameless re-write of icat for Ruby

tldr

Summary

So you want to see an image, but don’t wanna leave your precious command-line?

jp2a makes you sad...

jp2a

img2txt is just weird...

img2txt

There is a better way!

biv

biv

Features

  • True color support!
  • Higher definition output (2 pixels per character!)
  • Standard definition output (1 pixel per character!)
  • Width and height controls!

Installation

Add this line to your application's Gemfile:

gem 'ruby-blocky-image-viewer'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ruby-blocky-image-viewer

Usage

If you just wanna view an image checkout:

$ biv --help

Otherwise have a look at the source code, especially Biv::Viewer:

puts Biv::Viewer.new(“my-image.png”).to_s

Contributing

  1. Fork it ( https://github.com/bogwonch/ruby-blocky-image-viewer/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request