Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hasauino/terimg
In-terminal ASCII image viewer
https://github.com/hasauino/terimg
ascii-art
Last synced: about 2 months ago
JSON representation
In-terminal ASCII image viewer
- Host: GitHub
- URL: https://github.com/hasauino/terimg
- Owner: hasauino
- Created: 2022-10-14T15:15:28.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2022-10-19T20:20:35.000Z (about 2 years ago)
- Last Synced: 2023-05-07T07:05:02.306Z (over 1 year ago)
- Topics: ascii-art
- Language: C++
- Homepage:
- Size: 739 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Terimg
In-terminal ASCII image viewer.
It can show an image if a path is given, otherwise show video device stream.
## Install
- Download `.deb` compatible with your distro from [releases](https://github.com/hasauino/terimg/releases).
- Install it:
```bash
sudo apt update && sudo apt install ./terimg_ubuntu__x64.deb
```
- Run it:
```bash
terimg # read from webcam
terimg -p
```
- Other options:
```bash
terimg -h
```
## Usage
```
Usage: terimg [-h] [--width VAR] [--brightness VAR] [--contrast VAR] [--text VAR] [--path VAR] [--video VAR]
Optional arguments:
-h, --help shows help message and exits
-v, --version prints version information and exits
-w, --width number of chars in a row of the output string [default: 100]
-b, --brightness Number between 0-255 by which pixel intensities are incremented [default: 0]
-c, --contrast Float number defining contrast. 1.0 is no change in contrast, 0.5 decrease 50%, and 1.5 increase by 150% [default: 1]
-t, --text characters used in rendering the images. Ordered from darkest to brightest [default: " .,:;i80@"]
-p, --path Image input path. If not given, it will read from the video device [default: ""]
-i, --video Index of video device (used in video device mode when image path is not given [default: 0]
```
## From source
- You need to install OpenCV first:
```bash
sudo apt install libopencv-dev
```
- Then:
```bash
make
```
- then run the binary:
```bash
./build/bin/terimg
```