sanalzio / PixCii

Free image to ASCII text converter software.

PixCii

Free image to ASCII text converter software. What is the free software?

                     PixCii X.X.X
    Simple "open-source" image to ASCII text converter.

    Usage: ./pixcii <*input_file_path> <arguments>
    Or you can simply drag and drop the files you want to cut into executable file.

    Arguments:

    --help or -h: show undetailed help menu.

    --deatiledhelp or -dh: show this menu.

    --out: set output file path.
    Usage: --out <output_file_path>

    --size: resize image to specified width and height.
    Usage: --size <width (pixels)> <height (pixels)>

    -r: reverse the ascii characters.

    -l: print the ascii text to the console.

    -i: disable write info to console.

    -w: removes the whitespaces.

    -s: disable the resizing performed to maintain the aspect ratio..

    +<JIMP_Function>: run specified JIMP function before converting to ascii.
    Example: +resize(90,24)

    --exec: execute the specified javascript code.
    Usage: --exec "<javascript code>"

    --onconed: execute the specified javascript code on converted.
    Example: --onconed "<javascript code>"

    --onsvd: execute the specified javascript code on saved.
    Example: --onsvd "<javascript code>"

    --onst: execute the specified javascript code on start.
    Example: --onst "<javascript code>"

    --befcon: execute the specified javascript code before converting.
    Example: --befcon "<javascript code>"

    --execcmd: execute the specified Shell code.
    Usage: --execcmd "<Shell code>"

• PixCii
  • Istallation
  • Build
  • Usage
    • Run like this:
    • Examples
  • Scripting
    • Using --exec Argument
    • Using runCmd Function
    • Using --execcmd Argument
  • License

Istallation

Download PixCii latest relase from here. Or you can build from source.

Build

git clone https://github.com/sanalzio/PixCii
cd PixCii
npm install
node index.js

Usage

Run like this:

pixcii <input_file_path> <arguments>

Tip

Or you can simply drag and drop the files you want to cut into executable file

Examples

pixcii image.png
pixcii image.png --size 100 50 -r --out output.txt
pixcii image.png --size 100 50 -riws
pixcii image.png --size 100 50 -rl
pixcii image.png --size 100 50 --exec "console.log(\"Done ✔\");"

Scripting

You can use scripting to execute JavaScript code or execute Shell code. For better information look Detailed Information.

Using --exec Argument

pixcii image.png --exec "console.log(\"Hello World! from --exec arg\");"

Output: Hello World! from --exec arg

Using runCmd Function

pixcii image.png --exec "runCmd(\"Hello World! from runCmd function\");"

Output: Hello World! from runCmd function

Using --execcmd Argument

pixcii image.png --execcmd "echo Hello World! from --execcmd arg"

Output: Hello World! from --execcmd arg

License

GPL-V3