sixelcrop

Crop sixel images in sixel-space!

sixelcrop is a Python library and command line tool to crop sixel images

Installation

pipx install sixelcrop
# OR
pip install sixelcrop

Usage

Command Line

usage: sixelcrop [--help] [-x int] [-y int] [-w int] [-h int] [--no-private-colors] Path

Crop a sixel image in sixel space

positional arguments:
  Path                  Path to sixel image file (use '-' to read data from standard input)

options:
  --help
  -x int, --left int    The offset of the left edge of the target region
  -y int, --top int     The offset of the top edge of the target region
  -w int, --width int   The width of the target region
  -h int, --height int  The height of the target region
  --no-private-colors   Do not use private colors for each graphic

Example:

curl https://www.python.org/static/img/python-logo@2x.png | img2sixel | sixelcrop -x 10 -y 15 -w 120 -h 125 -

Python API

import sys
from sixelcrop import sixelcrop

with open("snake.six") as f:
    data = f.read()

sys.stdout.write(sixelcrop(data, x=300, y=50, w=200, h=150))

License

sixelcrop is distributed under the terms of the MIT license.