The shuffle command line interface (CLI) tool brings dynamic ASCII art to life, featuring an engaging shuffle effect that transforms static images into captivating displays. This utility allows users to shuffle through text files, including those containing Unicode characters, providing a versatile solution for visual representation of data and creativity in the terminal.

Features

• ASCII Art Shuffle: Print ASCII art with a cool shuffle effect that captures attention.
• Text File Support: Shuffle through any text files, accommodating Unicode characters, ensuring a broad range of applications.

Usage

The tool can be executed with the following command structure:

shuffle SOURCE -s speed -c color

• -s speed: Defines the shuffle speed, where 1 indicates a fast shuffle, and values greater than 500 represent a much slower pace. Setting -1 triggers an immediate shuffle.
• -c color: Accepts color in the format "r;g;b" for RGB values or standard colors including: red, green, yellow, blue, magenta, cyan, orange, white, black, grey, or even random.

Example Commands

• To print an ASCII file in bright green:

  shuffle file.ascii -s 10 -c "50;255;50"
  

• For shuffling with standard orange color:

  shuffle file.ascii -s 50 -c orange
  

Building and Installation

Meson: To build with Meson, execute the following commands:

mkdir builddir && meson setup builddir --buildtype=release --prefix=/usr/bin && meson compile -C builddir

Make: Alternatively, you can build using Make:

make

**Installation commands for Meson and Make: ** For installation, you can use:

• Meson:

  sudo meson install -C builddir
  

• Make:

  sudo make install
  

For Arch Linux users, the utility is available in the AUR as 'shuffle-ascii'.

Visual Representations

Visit the GutHub project page for some visual representations.