3 unstable releases

0.2.0 Jan 23, 2023
0.1.1 Jun 25, 2022
0.1.0 Apr 1, 2021

#108 in Visualization

Download history 12/week @ 2024-02-21 16/week @ 2024-02-28 18/week @ 2024-03-27 35/week @ 2024-04-03

53 downloads per month


1.5K SLoC


img2text on Terminal


Image-to-text converter

    powered by:  ⠰⢿⣿⡇⠀⠀⢸⣿⣿⣿⡿⠿⠿⢿⣿⣿⣿⣦⠀⠀⢀⣸⣿⡿⠆

(The above image was generated by this program with an option `-s 25`.)

    img2text [OPTIONS] <FILE>

            The image to process

    -d, --dither
            Apply dithering to preserve the gray shades. Incompatible with `-i

    -h, --help
            Prints help information

    -V, --version
            Prints version information

    -w <cell-width>
            The width of output characters, only used when `-s` is given without
            `!` [default: 0.45]

        --dither-contrast <dither-contrast>
            Choose the contrast enhancing technique to use for dithering
            [default: median-quant] [possible values: none, median-quant,

        --canny-high-threshold <edge-canny-high-threshold>
            A parameter for the Canny edge detector (`-i edge-canny`).

            Edges with a strength higher than the high threshold will always
            appear as edges in the output image. [default: 20]

        --canny-low-threshold <edge-canny-low-threshold>
            A parameter for the Canny edge detector (`-i edge-canny`).

            Edges with a strength higher than the low threshold will appear in
            the output image if there are strong edges nearby. [default: 10]

    -i <input-ty>
            Specifies how to interpret the input image [default: auto] [possible
            values: auto, wob, bow, edge-canny]

    -s <out-size>
            The output size, measured in character cells or percents (e.g.,
            `80`, `80x40`, `80x40!`, `-80x40`, `100%`). [default: downscale to
            terminal size (if the output is a terminal) or 100% (otherwise)]

            - 80: Fit within 80x80 character cells

            - 80x40: Fit within 80x40 character cells, upscaling as necessary

            - -80x40: Fit within 80x40 character cells, only downscaling

            - 80x40!: Fit to 80x40 character cells, not maintaining the aspect

            - 150%: Scale by 150%. The actual output size depends on the glyph
            set being used; for example, `2x3` maps each 2x3 block to one

    -g <style>
            The glyph set to use [default: braille] [possible values: slc, 
            ms2x3, 1x1, 1x2, 2x2, 2x3, braille]


First, make sure rustup or Rust 1.49.0 or later is installed. Then run the following command:

cargo install img2text

This will compile and install img2text the CLI app to ~/.cargo/bin or somewhere else in your system.

Fairfax HD can display all characters (particularly Symbols for Legacy Computing) generated by this program.

img2text on Web

https://img2text.yvt.jp is a single-page static website.



cd web
python -m http.server

To continuously rebuild:

cd web/static
python -m http.server &
cd ..
cargo watch -s make -i static

img2text in Your App

Add the following to your app's Cargo.toml file:

img2text = { version = "0.1.0", default-features = false }


~141K SLoC