{"id":19204482,"url":"https://github.com/codecliff/photoglimmer","last_synced_at":"2025-10-16T11:10:00.680Z","repository":{"id":202864987,"uuid":"687320855","full_name":"codecliff/PhotoGlimmer","owner":"codecliff","description":"An AI powered image editing tool for Linux desktops to enhance lighting on people in photographs.   ","archived":false,"fork":false,"pushed_at":"2025-01-18T19:15:11.000Z","size":4075,"stargazers_count":32,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-20T14:42:51.537Z","etag":null,"topics":["ai","appimage","beeware","debian","gui-application","image-manipulation","image-processing","linux","linux-desktop","mediapipe","opencv","opencv-python","photography","pyside","pyside2","python","qt","qt5","ubuntu"],"latest_commit_sha":null,"homepage":"https://github.com/codecliff/PhotoGlimmer","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codecliff.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-09-05T05:51:22.000Z","updated_at":"2025-04-13T21:06:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"11bac612-504a-4aa7-9d61-3bbbf78e5cdb","html_url":"https://github.com/codecliff/PhotoGlimmer","commit_stats":null,"previous_names":["codecliff/photoglimmer"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecliff%2FPhotoGlimmer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecliff%2FPhotoGlimmer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecliff%2FPhotoGlimmer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecliff%2FPhotoGlimmer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codecliff","download_url":"https://codeload.github.com/codecliff/PhotoGlimmer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253773023,"owners_count":21962186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","appimage","beeware","debian","gui-application","image-manipulation","image-processing","linux","linux-desktop","mediapipe","opencv","opencv-python","photography","pyside","pyside2","python","qt","qt5","ubuntu"],"created_at":"2024-11-09T13:08:18.106Z","updated_at":"2025-10-16T11:10:00.674Z","avatar_url":"https://github.com/codecliff.png","language":"Python","readme":"# PhotoGlimmer - Illuminating  People In Photos  \n\n#### ✨✨ The photo editor that makes you look as sharp as the landscape behind you (or the vice versa) ✨✨\n\n\n\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n#### \u003ccenter\u003e ✨✨  Help Website  : [Home](https://codecliff.github.io/photoglimmer/)  | [User Manual](https://codecliff.github.io/photoglimmer/photoglimmer_help.html) | [Interactive](https://codecliff.github.io/photoglimmer/photoglimmer_guide.html) | [FAQs](https://codecliff.github.io/photoglimmer/photoglimmer_help.html#faq)   ✨✨ \u003c/center\u003e\n\n\n\n## ✨✨ :rocket: V 0.5  (September 2025) is here!  :rocket: ✨✨\n        * Multiple enhancements under the hood       \n        * Code Upgrade to Qt6 and Pyside6           \n        * Improvements made to installers  \n        * Flatpak Installer added (Experimental) \n        Along with all  the features added in 0.4 , like:\n        * Mouse drawn selection to aid or restrict AI human detection          \n        * Preference Dialog \n        * Choice of start directory\n        * Image Preview in File Open dialog \n        * Gimp like Curves for brightness tweaking (Experimental / optional :: see preferences )\n        * No-restart preference switching\n        * Help Menu\n        * Online help page with FAQ\n        * Online interactive graphical help page     \n\n\n\u003e  ⚡⚡ New contributor :   [Stephan Schielke](https://github.com/stephanschielke/) ⚡⚡\n\n\n\u003cbr/\u003e\n\n\n\n## ✨✨💻 💻  Download Latest  Version  Binaries 💻 💻 ✨✨         \n\n\n\n\u003e - 💻 **Ubuntu  22.04 .deb Installer**: Download and install using apt or gdebi \n    * [Deb for Ubuntu 22.04 ](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.5.0_U2204/photoglimmer_0.5.0-1.ubuntu-jammy_amd64.deb)\n\u003e - 💻 **Ubuntu  24.04 .deb Installer**: Download and install using apt or gdebi \n    * [Deb for Ubuntu 24.04 ](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.5.0_U2404/photoglimmer_0.5.0-1.ubuntu-noble_amd64.deb)  \n\u003e - 💻 **Windows Installer:** Download and install, tested on Windows11 \n    * [Msi Installer](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.5.0_Win/PhotoGlimmer-0.5.0.msi)\n\u003e - 💻 **Linux Flatpak Installer (Experimental):** Download and install \n    * [Flatpak for All Linux flavors](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.5.0_Flatpak/PhotoGlimmer-0.5.0-x86_64.flatpak) \n\n\u003cbr/\u003e\n\nFor checksums, refer to [release pages](https://github.com/codecliff/PhotoGlimmer/releases)  with tags starting with V0.5.0_ \n\n\u003cbr/\u003e\n\n  All releases can also be found onthe [release page](https://github.com/codecliff/PhotoGlimmer/releases) ( expand the **Asset** sections ) \n\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n\n\n# About PhotoGlimmer\n\nPhotoGlimmer is an image editing application that leverages Artificial Intelligence tools to separate people in the image from the background, and allows you to tweak the two separately. \n\nTherefore, you can brighten all the people in an image while darkening or softening the background, or vice versa.\n\n\nIt can handle large images and does not require a GPU. It's a totally local and offline graphical  application, primarily for Linux Desktops. \n\nIt has evolved from something I had originally written to improve a number of photographs in my own collection. As an avid photographer I had countless  photos of family , travels,landscapes  and even  indoor parties where the background was stunning but the people in foreground were underlit and looked dim in comparison. I could see that a better illumination of faces would do a world of good to the photo, yet was not too keen on painstakingly selecting shapes on GIMP. This app uses Mediapipe and Opencv and improves lighting on people with a couple of gentle nudges to 2-3 sliders. \n\nIn short, if you are an AI enthusiast photographer, it is the user-friendly segmentation tool you have been thinking of developing yourself for last few years :-) Though it's perfectly useful for an everyday common user like me. \n\nBeware- Unlike a phone app, PhotoGlimmer gives you full control of the segmentation and illumination process and it's easy to go overboard. But as you will see, it does the work in more than 95% of cases. The only caveat is that the image should not be too cluttered to segregate foreground(people) form the background.\n\n\n# Screenshot\n\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"80%\" height=\"auto\" src=\"screenshot_photoglimmer_03.png\", alt= \"Screenshot of PhotoGlimmer image editor\"/\u003e\n  \u003cbr\u003e Photo Credit: \u003ca href=\"https://www.flickr.com/photos/portishead520/16524721706/#\"\u003eFlickr cc \u003c/a\u003e \n\u003c/p\u003e\n\n# Samples\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"80%\" height=\"auto\" src=\"photoglimmer_collage_smaller.jpg\", alt= \"Sample results for PhotoGlimmer image editor\"/\u003e\n  \u003cbr\u003e Photo Credit: \u003ca href=\"https://www.flickr.com/photos/portishead520/16524721706/#\"\u003eFlickr cc \u003c/a\u003e \n\u003c/p\u003e\n\n\n\n# Features\n- **Smart people identification:** PhotoGlimmer's intelligent algorithms demarks people and background in an image\n\n- **No need of manual masking** \n\n- ** Foreground/People/Face Lighting**: \n\n- ** Background Illumination/Darkening  **\n\n- ** Background Defocus (Blur)  ** \n\n- **Seamless toggle between background and foreground **\n\n\n- **Background Preservation**: Say goodbye to painstaking masking and cropping. A few nudges at the sliders ensure that your enhanced foreground blend seamlessly with the original background.\n\n- **Lean and Intuitive Interface - just some sliders **:  \n\n- **GPU Not Required**:  \n\n- **Large Image Sizes**:  PhotoGlimmer can handle large image dimensions like 6000x4000 megapixels (10-15 MBs) \n\n- **Local Processing**: Resides completely on your computer.\n\n- **Self contained**: Installation does not mess with system's python setup. \n\n- **Privacy**: Local processing.Therefore no data is sent to any servers.\n\n- **Retains Exif Data**\n\n\n# Requirements\n\n## Packaged/Installable  version: \n\nThe packaged/Installable  version of PhotoGlimmer includes all its dependencies and **the user does NOT need to install anything** other than Python 3.8+ \n\nSo, if you are using the .deb or .AppImage version, you need to have only **Python version 3.8 or above**\n\n\n## Requirements For Running From Source Code  \n\n- create a virtual environment , preferably wiht python 3.10 to 3.12  and  install requirements from requiremtns.txt\n- see instructions for execution below  \n\n## Tested On:\n- Ubuntu 22.04 , 24.04  \n- Fedora Linux 35 (VM, 4 GB RAM) (v 0.3.0 tested)\n- Windows11\n\n\n\n# Installation and Running: \n\n\u003e [!NOTE]\n\u003e Latest binary installers are at the top of this Readme\n\u003e Previous Version binaries at the bottom \n\u003e [All Binary Release Assets](https://github.com/codecliff/PhotoGlimmer/releases/). \n\n\n## Method 1. Appimage (Any Linux):\n\n- Just download the Appimage file and execute. \n- You don't need to install anything, appimages have everything and the kitchen sink bundled in.\n- You might need to set the Appimage file as executable \n\n## Method 2. Install .deb (Ubuntu) : \n\n- This method gives you the better integration with OS. You can just right-click on images and open them in PhotoGlimmer\n- All requirements are bundled in the installer itself. You don't need to install any requirements\n- Installing through this .deb file does not pollute your system environment.  Photoglimmer and all its required software is contained in its own bundle and do not interfere with versions of stuff already installed on the system \n\n\n## Method 3. Executing from source code (All OSs including Windows) :\n\nFollow these steps to install dependencies and run PhotoGlimmer :\n\n\n1. Create a python environment , preferably with python 3.10 to 3.12 \n2.  Activate this environment \n3. Install requirements from requirements.txt\n4. Then- \n    * `git clone https://github.com/codecliff/PhotoGlimmer.git`\n    * `cd PhotoGlimmer` \n    * `python photoglimmer/` **OR** `python photoglimmer/photoglimmer_ui.py `\n\n\n\n\n# Using the software (User Guide) : \n\n## Some Basics: \n\n- All editing is done with the help of 3 or 4  sliders\n- Hover over each element to know what that element does\n- Result image is previewed on the right, while the current selection mask appears as a small black and white image on left. \n\n\n\n- **Main Sliders:**\n    +  Brightness and saturation  of selected area can be tweaked with the relevant slider\n    +  **Selection can be grown or shrunk  by using the ``Threshold`` slider**\n    +  **The ``Edge Blur`` slider blends the edited portion smoothly with background\n\n    \n## Process for editing an image: \n- Open an image in PhotoGlimmer\n- Slide the brightness slider a bit. Apart form showing your edited image, now the application will also show the current section mask \n- You might need to grow or shrink the selection with ``Threshold`` slider\n- If the edits start looking patchy , increase the ``Edge Blur`` . This will make the edited portion blend seamlessly with its background\n- Press mouse button on the image to compare edit with original image\n- When satisfied , Save the edited Image. \n- Note- on  ``save``, the processing might take significantly longer than previous edits.This is because previous edits were being made on a scaled-down version of the image. \n\n\n\n## Known Issues/Limitations: \n\n- Pleas add any issues here:  [Issues](https://github.com/codecliff/photoglimmer/issues)\n\n\u003chr \u003e\n\n\n#### ✨✨Previous Version (v0.4) Binaries  ✨✨ \n\n  [Appimage for All Linux flavors](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.4.0_linux/PhotoGlimmer-0.4.0-x86_64.AppImage) |\n  [Deb for Ubuntu](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.4.0_linux/photoglimmer_0.4.0-1.ubuntu-jammy_amd64.deb) |\n  [Msi Installer](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.4.0_win/PhotoGlimmer-0.4.0.msi) \n\n\u003cbr/\u003e\n\n#### ✨✨ Previous Version (v0.3) Binaries ✨✨    \n\n   [Appimage for All Linux flavors](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.3.0_u22.04py3.10/PhotoGlimmer-0.3.0-x86_64.AppImage) | \n   [Python 3.8/Ubuntu 20.04 .Deb](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.3.0_linux/photoglimmer_0.3.0-1.ubuntu-focal_amd64.deb) | \n   [Python 3.10/Ubuntu 22.04 .Deb](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.3.0_u22.04py3.10/photoglimmer_0.3.0-1.ubuntu-jammy_amd64.deb) |\n   [Windows Msi Installer](https://github.com/codecliff/PhotoGlimmer/releases/download/v0.3.0/PhotoGlimmer-0.3.0.msi)\n\n\u003chr/\u003e\n\n\n## Acknowledgments:\n- [Mediapipe](https://developers.google.com/mediapipe)\n- [Opencv](https://opencv.org/)\n- [PyQtDarkTheme](https://github.com/5yutan5/PyQtDarkTheme)\n- [PyExif](https://pypi.org/user/edleafe/)\n- [Beeware](https://beeware.org/project/briefcase/)\n- StackOverflow contributors (links in source code)\n\n\n\n\n## License\nThis Software is released under the [LGPL-2.1  License](https://opensource.org/license/lgpl-2-1/#)\n\n\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\n\u0026copy; Rahul Singh\n\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\u0026#9617;\n\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodecliff%2Fphotoglimmer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodecliff%2Fphotoglimmer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodecliff%2Fphotoglimmer/lists"}