Skip to content

CLI

Build with cli and images

Terminal window
cargo run --bin artbox --features "cli images" -- image path/to/image.png --width 80

The artbox binary is gated behind both features.

Common flags

  • --width <n>: output width in characters
  • --h-scale <f>: horizontal scale factor
  • --v-scale <f>: vertical scale factor
  • --brightness <n>: -255 to 255
  • --contrast <f>: 0.0 to 3.0
  • --sharpness <f>: 0.0 to 3.0
  • --mode <full|block|shade|ascii>
  • --threshold <n>: threshold for full/block
  • --invert: invert brightness
  • --no-color: disable ANSI colors
  • --output <path>: write output to file