Description
TerminalImage is a library to show images on terminals. Currently, this library supports iTerm2 and terminals with libsixel installed.
TerminalImage alternatives and similar gems
Based on the "CLI Utilities" category.
Alternatively, view TerminalImage alternatives based on common mentions on social networks and blogs.
-
colorls
A Ruby gem that beautifies the terminal's ls command, with color and font-awesome icons. :tada: -
Ruby/Progressbar
Ruby/ProgressBar is a text progress bar library for Ruby. -
Terminal Table
Ruby ASCII Table Generator, simple and feature rich. -
tty-prompt
A beautiful and powerful interactive command line prompt -
colorize
Ruby string class extension. It add some methods to set color, background color and text effect on console easier using ANSI escape sequences. -
Terjira
Terjira is a very interactive and easy to use CLI tool for Jira. -
tty-spinner
A terminal spinner for tasks that have non-deterministic time frame. -
tty-command
Execute shell commands with pretty output logging and capture stdout, stderr and exit status. -
tty-progressbar
Display a single or multiple progress bars in the terminal. -
Tabulo
Plain text table generator for Ruby, with a DRY, column-based API -
tty-screen
Terminal screen detection - cross platform, major ruby interpreters -
tty-cursor
Terminal cursor movement and manipulation of cursor properties such as visibility -
circleci-cli
:cyclone: CLI client / command line tool for CircleCI -
tty-pager
Terminal output paging - cross-platform, major ruby interpreters -
XDG
Provides an implementation of the XDG Base Directory Specification. -
Sapristi
Elegant way to organize your windows in a linux multi monitor environment
Build time-series-based applications quickly and at scale.
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of TerminalImage or a related project?
README
TerminalImage
TerminalImage is a library to show images on terminals. Currently, this library supports iTerm2 and terminals with libsixel installed.
[](./images/example.png)
Installation
Add this line to your application's Gemfile:
gem 'terminal_image'
Terminals other than iTerm2:
Please install libsixel
's img2sixel
command following https://github.com/saitoha/libsixel#install
Usage
# Print image by File object
TerminalImage.show(File.open('your-image-path.png'))
# Print image from URL
TerminalImage.show_url('https://raw.githubusercontent.com/unhappychoice/terminal_image/master/images/sample.png')
# Get encoded string ready to be displayed
string = TerminalImage.encode(File.open('your-image-path.png'))
# Get encoded string ready to be displayed from URL
string = TerminalImage.encode_url('https://raw.githubusercontent.com/unhappychoice/terminal_image/master/images/sample.png')
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/unhappychoice/terminal_image. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
License
The gem is available as open source under the terms of the MIT License.
Code of Conduct
Everyone interacting in the TerminalImage project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.
*Note that all licence references and agreements mentioned in the TerminalImage README section above
are relevant to that project's source code only.