Skip to content

TeaM-TL/FotoKilof

Repository files navigation

FotoKilof - GUI for ImageMagick

GUI for the most used (by me) ImageMagick functionality for processing pictures. If ImageMagick or Wand are unavailable, Pillow is in use. There some limitation, but works in general.

Merry Christmas

Screenshots

Linux

Screenshot

Linux dark mode

Screenshot

Windows

Screenshot Windows

macOS compose

Screenshot Windows

Graphics conversion

  • scaling/resize,
  • crop,
  • text annotation, inside or outside of picture (mems generator),
  • border around picture,
  • rotation,
  • mirroring (vertical or horizontal),
  • black-white,
  • sepia - only with Wand and ImageMagick,
  • contrast increase/decrease or normalize or histogram stretching,
  • color auto-level or equalize,
  • vignette - only with Wand and ImageMagick,
  • adding logo image on picture,
  • compose two image in one picture,
  • file formats: JPG, PNG, TIFF, SVG,
  • format conversion into JPG, PNG, TIFF.

Functionality:

  • processing JPG, PNG, SVG and TIFF images,
  • processing picture in the fly, originals are safe,
  • processing single file or whole directory,
  • get picture from clipboard and use it as source picture,
  • after processing results is copied into clipboard,
  • display selected tools,
  • tools selection,
  • preview orignal and result,
  • predefined rotation: 90, 180 and 270 degree or custom,
  • crop selection via click on preview or coordinates,
  • crop coordinates:
    • two corners (upper left and lower right),
    • upper left corner and width plus height,
    • gravity, width plus height plus offset,
  • text: color, font and size selection, background, rotation,
  • text position:
    • outside: bottom, left/center/right
    • inside: by gravity or by position and rotate
  • customized sepia - only with Wand and ImageMagick,
  • equalize by channel,
  • contrast between -5 and +5,
  • customized contrast stretching,
  • vignette:
    • can be sharp or blured,
    • corners can be filled by selected color,
    • offset in both direction
  • logo position by gravity, size and offset,
  • compose:
    • add picture on right side
    • add picture on bottom
    • autoresize picture
    • fill color if no autoresize
  • fast file navigation: First, Prev, Next, Last or keys: Home, PgUp, PgDn, End,
  • command editor: possible to use ImageMagick commands for convert: eg. -gaussian-blur 10x10 or -monochrome, etc.
  • dark and light mode

Processing

Is possible to run one conversion or all selected conversion. Processing order for all selected conversion:

  • crop,
  • mirror,
  • black-white,
  • sepia - only with Wand and ImageMagick,
  • contrast,
  • color normalize,
  • vignette - only with Wand and ImageMagick,
  • rotate,
  • border,
  • resize,
  • text,
  • compose two image in one picture,
  • logo - only with Wand and ImageMagick.

Processed is always on clone of picture in memory. Originals are not touched.

User manual, a bit outdated

Available translations

Available: Bulgarian, English, German, Indonesian, Polish and Turkish.


Install and run

Requirements

  • Windows, Linux, MacOS X, BSD,
  • FullHD screen for comfort work,
  • ImageMagick, remember to add path into %PATH% environment variable, enable install libraries!
  • Python3.10+, remember to add path into %PATH% environment variable.

Install

Linux

Install requirements:

apt-get install python3-pip python3-tk python3-wand imagemagick xclip

Install as PyPi package by PIP:

python3 -m pip install fotokilof

Windows

Download and install requirements:

  • Python3.10+ - add path into %PATH% environment variable,
  • ImageMagick - add path into %PATH% environment variable, enable install libraries!
python -m pip install fotokilof

MacOS

Install requirements:

brew install imagemagick python@3.13 python-tk@3.13

For Apple Silicon (M1, M2, M3) based Macs, the default Homebrew install directory differs from that on Homebrew Intel installs. The following environment variable allows FotoKilof to correctly locate the Homebrew-installed ImageMagick on Apple Silicon Macs:

export MAGICK_HOME=/opt/homebrew

Install as PyPi package by PIP:

python3 -m pip install fotokilof

FreeBSD

FotoKilof is available via ports

pkg install py311-fotokilof

Upgrade

python3 -m pip install --upgrade fotokilof

Run

fotokilof

or

python -m fotokilof

Dark or Light mode

Press F2 to toggle from Light to Dark or opposite.


Thanks

  • Friends - some ideas and testing,
  • Max von Forell - German translation,
  • Bozhidar Kirev - Bulgarian translation,
  • Alexander Ignatov - Bulgarian translation,
  • Afif Hendrawan - Indonesian translation,
  • Sebastian Hiebl - python packaging,
  • Matt Sephton - ideas for packing gui,
  • emsspree - update german translation, jpeg,
  • Olm - testing on Windows,
  • Carbene Hu - idea to fix issue
  • Mert Cobanov - Turkish translation
  • Giancarlo Dessì - Italian translation, Slackware package
  • Danny (dchenz) - logging in proper way
  • Nicola Vitale - support with debug and find solution

Star History

Star History Chart


Powered by

Python powered Imagemagick Wand ttkbootstrap Pillow FindSystemFontsFilename pyperclipimg