Pixxy

A really sweet image manipulation tool for creating aesthetic images on the command line.

you can apply any arbitrary set of colors to an image, in this case I used a theme file for the Kitty terminal. pixxy will automatically parse this file for any valid hex colors and apply them to the image. You can use any file (or string) that contains hex colors. This can be useful for creating themed wallpapers, you could pick any Gruvbox config file and the image will match those colors.

pixxy glitch \
    --gif \
    --verbose \
    --input ~/Pictures/cowgirl-thumbnail.jpg \
    --output output.gif \
    --seed sweet \
    --threshold 1.0 \
    --palette-file ~/.config/kitty/themes/ayanami-cold.conf \

output:

Input	Output

another example using the terminal text-editor, Helix, Gruvbox theme file:

Dither

examples

# simple dither
pix dither           \
  --input input.png  \
  --output out.png   \
  --dither floyd

# use dithering and ordered dither matrices (ie "dots" and manga like toning)
pix dither              \
  --input input.png     \
  --output out.png      \
  --dither floyd        \
  --ordered vertical5x3

# layer multiple dither filters
pix dither              \
  --input input.png     \
  --output out.png      \
  -d floyd -d atkinsons \
  -m vertical5x3        \
  --bayer

# random ordered matrix of 0.3 strength and using a color palette from a random file containing hex colors
pix dither \
  --input input.png \
  --output out.png \
  --palette-file ~/.config/kitty/themes/pretty-pink.conf \
  -t 0.3 \
  -m $(/pix dither --list-maps | shuf | head -n1) \
  --scale --scale-factor 5

Glitch

create a gif or still image that is glitched out

Ascii

convert a gif, video or image into an ascii representation.

Color

functions to create color palettes and modify the colors of an image

Filter

generic filters to apply to an image

Wallpaper-finder

find wallpaper sized images!

wallpaper-finder -e jpg -e jpeg -e png ~/Pictures ~/images | \
    fzf --preview='kitty icat --clear --transfer-mode=memory --stdin=no --place=${FZF_PREVIEW_COLUMNS}x${FZF_PREVIEW_LINES}@0x0 {}'

Usage:
  wallpaper-finder [OPTIONS]

Application Options:
  -e, --extension= an array of extensions to search for ie (-e png -e jpg)
  -d, --directory= an array of paths to search, can specify more than one
  -r, --ratio=     a ratio to search, in the format <widht>x<height> (16x9)
  -t, --tolerance= percentage of tolerance for the ratio [5%] (default: 5)
  -c, --color      print paths with color
  -f, --follow     follow symlinks
  -v, --verbose    print debugging information and verbose output

Help Options:
  -h, --help       Show this help message

Acknowledgements

The following people do not endorse or have liabilty for this project, they have graciously made their code available under permissive licenses which has been a great help to me as well as a learning experience. Thanks to:

darkliquid/glitch MIT license

the base glitch library I built off of

koyachi/go-atkinson MIT licensed

atkinsons dither function

fiwippi/go-ascii BSD-3-Clause

modified ascii converter pulled from here

peterhellberg/gfx MIT

learned about Vec2, Vec3 and affine matrix math from here

sweetbbak / pixxy