# FotoKilof - GUI for ImageMagick
GUI for the most used (by me) ImageMagick functionality for processing pictures.
## Screenshots
### Linux
![Screenshot](https://raw.githubusercontent.com/TeaM-TL/FotoKilof/master/screenshots/fotokilof_linux.png)
### Linux dark mode
![Screenshot](https://raw.githubusercontent.com/TeaM-TL/FotoKilof/master/screenshots/fotokilof_linux_dark.png)
### Windows
![Screenshot Windows](https://raw.githubusercontent.com/TeaM-TL/FotoKilof/master/screenshots/fotokilof_windows.png)
### macOS compose
![Screenshot Windows](https://raw.githubusercontent.com/TeaM-TL/FotoKilof/master/screenshots/fotokilof_compose.png)
## Graphics conversion
- scaling/resize,
- crop,
- text annotation, inside or outside of picture (mems generator),
- border around picture,
- rotation,
- mirroring (vertical or horizontal)
- black-white or sepia,
- contrast increase/decrease or normalize or histogram stretching,
- color auto-level or equalize,
- vignette
- 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,
- take screenshot (Linux) or get picture from clipboard (Windows and MacOS) and use it as source picture,
- after processing results is copied into clipboard (Windows),
- 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,
- 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,
- contrast,
- color normalize,
- vignette,
- rotate,
- border,
- resize,
- text,
- logo.
Processed is always on clone of picture in memory. Originals are not touched.
## User manual, a bit outdated
- [English](doc/en/fotokilof.md),
- [Polish](doc/pl/fotokilof.md).
## 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](https://imagemagick.org/), remember to add path into `%PATH%` environment variable, enable install libraries!
- [Python3.9+](https://www.python.org/), remember to add path into `%PATH%` environment variable.
### Install
#### Linux
Install requirements:
```bash
apt-get install python3-pip python3-tk python3-wand imagemagick
```
Install as PyPi package by PIP:
```bash
python3 -m pip install fotokilof
```
#### Windows
Download and install requirements:
- [Python3.9+](https://www.python.org/) - add path into `%PATH%` environment variable,
- [ImageMagick](https://imagemagick.org/script/download.php#windows) - add path into `%PATH%` environment variable, enable install libraries!
```bash
python -m pip install pywin32 fotokilof
```
#### MacOS
Install requirements:
```bash
brew install imagemagick python@3.11 python-tk@3.11
```
Install as PyPi package by PIP:
```bash
python3 -m pip install fotokilof
```
#### FreeBSD
FotoKilof is available via [ports](https://www.freshports.org/graphics/py-fotokilof/)
### Upgrade
```bash
python3 -m pip install --upgrade fotokilof
```
### Run
```bash
fotokilof
```
or
```bash
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
---
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=TeaM-TL/FotoKilof&type=Date)](https://star-history.com/#TeaM-TL/FotoKilof&Date)
---
## Powered by
![Python powered](python-powered.png)
[Imagemagick](https://github.com/ImageMagick/ImageMagick)
[Wand](https://github.com/emcconville/wand)
[ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap)
Raw data
{
"_id": null,
"home_page": "https://github.com/TeaM-TL/FotoKilof",
"name": "FotoKilof",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "GUI ImageMagick FotoKilof",
"author": "Tomasz \u0141uczak",
"author_email": "tlu@team-tl.pl",
"download_url": "https://files.pythonhosted.org/packages/5c/29/6d93fae5e2dace9a143c14d6ebd9119811e148ab6c5ac48343a67d7e57f3/FotoKilof-4.4.8.tar.gz",
"platform": null,
"description": "# FotoKilof - GUI for ImageMagick\n\nGUI for the most used (by me) ImageMagick functionality for processing pictures.\n\n## Screenshots\n\n### Linux\n\n![Screenshot](https://raw.githubusercontent.com/TeaM-TL/FotoKilof/master/screenshots/fotokilof_linux.png)\n\n### Linux dark mode\n\n![Screenshot](https://raw.githubusercontent.com/TeaM-TL/FotoKilof/master/screenshots/fotokilof_linux_dark.png)\n\n### Windows\n\n![Screenshot Windows](https://raw.githubusercontent.com/TeaM-TL/FotoKilof/master/screenshots/fotokilof_windows.png)\n\n### macOS compose\n\n![Screenshot Windows](https://raw.githubusercontent.com/TeaM-TL/FotoKilof/master/screenshots/fotokilof_compose.png)\n\n## Graphics conversion\n\n - scaling/resize,\n - crop,\n - text annotation, inside or outside of picture (mems generator),\n - border around picture,\n - rotation,\n - mirroring (vertical or horizontal)\n - black-white or sepia,\n - contrast increase/decrease or normalize or histogram stretching,\n - color auto-level or equalize,\n - vignette\n - adding logo image on picture,\n - compose two image in one picture\n - file formats: JPG, PNG, TIFF, SVG\n - format conversion into JPG, PNG, TIFF.\n\n## Functionality:\n\n - processing JPG, PNG, SVG and TIFF images,\n - processing picture in the fly, originals are safe,\n - processing single file or whole directory,\n - take screenshot (Linux) or get picture from clipboard (Windows and MacOS) and use it as source picture,\n - after processing results is copied into clipboard (Windows),\n - display selected tools,\n - tools selection,\n - preview orignal and result,\n - predefined rotation: 90, 180 and 270 degree or custom,\n - crop selection via click on preview or coordinates,\n - crop coordinates:\n - two corners (upper left and lower right),\n - upper left corner and width plus height,\n - gravity, width plus height plus offset,\n - text: color, font and size selection, background, rotation,\n - text position:\n - outside: bottom, left/center/right\n - inside: by gravity or by position and rotate\n - customized sepia,\n - equalize by channel,\n - contrast between -5 and +5,\n - customized contrast stretching,\n - vignette:\n - can be sharp or blured, \n - corners can be filled by selected color,\n - offset in both direction\n - logo position by gravity, size and offset,\n - compose:\n - add picture on right side\n - add picture on bottom\n - autoresize picture\n - fill color if no autoresize\n - fast file navigation: First, Prev, Next, Last or keys: Home, PgUp, PgDn, End,\n - command editor: possible to use ImageMagick commands for convert: eg. *-gaussian-blur 10x10* or *-monochrome*, etc.\n- dark and light mode\n\n---\n\n## Processing\n\nIs possible to run one conversion or all selected conversion.\nProcessing order for all selected conversion:\n\n- crop,\n- mirror,\n- black-white/sepia,\n- contrast,\n- color normalize,\n- vignette,\n- rotate,\n- border,\n- resize,\n- text,\n- logo.\n\nProcessed is always on clone of picture in memory. Originals are not touched.\n\n## User manual, a bit outdated\n\n- [English](doc/en/fotokilof.md),\n- [Polish](doc/pl/fotokilof.md).\n\n## Available translations\n\nAvailable: Bulgarian, English, German, Indonesian, Polish and Turkish.\n\n---\n\n## Install and run\n\n### Requirements\n\n- Windows, Linux, MacOS X, BSD,\n- FullHD screen for comfort work,\n- [ImageMagick](https://imagemagick.org/), remember to add path into `%PATH%` environment variable, enable install libraries!\n- [Python3.9+](https://www.python.org/), remember to add path into `%PATH%` environment variable.\n\n### Install\n\n#### Linux\n\nInstall requirements:\n```bash\napt-get install python3-pip python3-tk python3-wand imagemagick\n```\n\nInstall as PyPi package by PIP:\n```bash\npython3 -m pip install fotokilof\n```\n\n#### Windows\nDownload and install requirements:\n- [Python3.9+](https://www.python.org/) - add path into `%PATH%` environment variable,\n- [ImageMagick](https://imagemagick.org/script/download.php#windows) - add path into `%PATH%` environment variable, enable install libraries!\n\n```bash\npython -m pip install pywin32 fotokilof\n```\n\n#### MacOS\nInstall requirements:\n```bash\nbrew install imagemagick python@3.11 python-tk@3.11\n```\n\nInstall as PyPi package by PIP:\n```bash\npython3 -m pip install fotokilof\n```\n\n#### FreeBSD\n\nFotoKilof is available via [ports](https://www.freshports.org/graphics/py-fotokilof/)\n\n### Upgrade\n\n```bash\npython3 -m pip install --upgrade fotokilof\n```\n\n### Run\n\n```bash\nfotokilof\n```\nor\n```bash\npython -m fotokilof\n```\n\n### Dark or Light mode\n\nPress F2 to toggle from Light to Dark or opposite.\n\n---\n\n## Thanks\n\n - Friends - some ideas and testing,\n - Max von Forell - German translation,\n - Bozhidar Kirev - Bulgarian translation,\n - Alexander Ignatov - Bulgarian translation,\n - Afif Hendrawan - Indonesian translation,\n - Sebastian Hiebl - python packaging,\n - Matt Sephton - ideas for packing gui,\n - emsspree - update german translation, jpeg,\n - Olm - testing on Windows,\n - Carbene Hu - idea to fix issue\n - Mert Cobanov - Turkish translation\n - Giancarlo Dess\u00ec - Italian translation, Slackware package\n - Danny (dchenz) - logging in proper way\n\n---\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=TeaM-TL/FotoKilof&type=Date)](https://star-history.com/#TeaM-TL/FotoKilof&Date)\n\n---\n\n## Powered by\n\n![Python powered](python-powered.png) \n[Imagemagick](https://github.com/ImageMagick/ImageMagick) \n[Wand](https://github.com/emcconville/wand) \n[ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) \n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Nice gui for ImageMagick",
"version": "4.4.8",
"project_urls": {
"Homepage": "https://github.com/TeaM-TL/FotoKilof"
},
"split_keywords": [
"gui",
"imagemagick",
"fotokilof"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "78075d579811b35c7ab4d8d610182d296d25cfac6ebe47ee4d4a20ca5fb0f8ad",
"md5": "db4ea8f24b5b47e6a00aa9c1f96f984f",
"sha256": "a5d6b6d919a359852b8533a3094c7aa4fde04181b5245c4deec60d62afa2b061"
},
"downloads": -1,
"filename": "FotoKilof-4.4.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "db4ea8f24b5b47e6a00aa9c1f96f984f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 49417,
"upload_time": "2024-03-24T20:26:28",
"upload_time_iso_8601": "2024-03-24T20:26:28.878246Z",
"url": "https://files.pythonhosted.org/packages/78/07/5d579811b35c7ab4d8d610182d296d25cfac6ebe47ee4d4a20ca5fb0f8ad/FotoKilof-4.4.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5c296d93fae5e2dace9a143c14d6ebd9119811e148ab6c5ac48343a67d7e57f3",
"md5": "f20eb95080eb26c5bf9c9d532827d4c3",
"sha256": "05458ca867a231b7dccf0b856c7fb8c6dc3b165232c50597ff0795b20f6ca0b9"
},
"downloads": -1,
"filename": "FotoKilof-4.4.8.tar.gz",
"has_sig": false,
"md5_digest": "f20eb95080eb26c5bf9c9d532827d4c3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 47904,
"upload_time": "2024-03-24T20:26:30",
"upload_time_iso_8601": "2024-03-24T20:26:30.912644Z",
"url": "https://files.pythonhosted.org/packages/5c/29/6d93fae5e2dace9a143c14d6ebd9119811e148ab6c5ac48343a67d7e57f3/FotoKilof-4.4.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-24 20:26:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TeaM-TL",
"github_project": "FotoKilof",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "fotokilof"
}