Skip to main content

Nice gui for ImageMagick and Pillow

Project description

PyPI Python versions Test & publish

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 are small limitation, but works in general.

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.

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
  • CiteClimb - improved imagemagick error message output

Star History

Star History Chart


Powered by

Python powered Imagemagick Wand ttkbootstrap Pillow FindSystemFontsFilename pyperclipimg

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fotokilof-5.2.4.tar.gz (98.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fotokilof-5.2.4-py3-none-any.whl (92.6 kB view details)

Uploaded Python 3

File details

Details for the file fotokilof-5.2.4.tar.gz.

File metadata

  • Download URL: fotokilof-5.2.4.tar.gz
  • Upload date:
  • Size: 98.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fotokilof-5.2.4.tar.gz
Algorithm Hash digest
SHA256 174993a2c467851f1be4a2c1f60c54cf3daf9d70efd52624b6d1ec01728e0c47
MD5 933f68af7430136c5db985b25839e62f
BLAKE2b-256 5ee2b3ddcd5a9a5098cd013be6d3a0f30d3a85070f4f74dbc768930fdaa8b66f

See more details on using hashes here.

Provenance

The following attestation bundles were made for fotokilof-5.2.4.tar.gz:

Publisher: publish_to_pypi.yml on TeaM-TL/FotoKilof

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fotokilof-5.2.4-py3-none-any.whl.

File metadata

  • Download URL: fotokilof-5.2.4-py3-none-any.whl
  • Upload date:
  • Size: 92.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fotokilof-5.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 087d5d7de59589bf1fbc1866185f9ad81226617b092179ba8363c6968f795347
MD5 b3f8d801b593e75b41a5e55c7f60546a
BLAKE2b-256 42832d11ab4a63aa08814bfff5de3f2a921dc273e9a77b62ccfe5663665f569e

See more details on using hashes here.

Provenance

The following attestation bundles were made for fotokilof-5.2.4-py3-none-any.whl:

Publisher: publish_to_pypi.yml on TeaM-TL/FotoKilof

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page