| Name | Photini JSON |
| Version |
2024.11.0
JSON |
| download |
| home_page | None |
| Summary | Simple photo metadata editor |
| upload_time | 2024-11-05 12:27:49 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.6 |
| license | GPLv3+ |
| keywords |
exif
iptc
xmp
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
Photini
=======
A free, easy to use, digital photograph metadata (Exif, IPTC, XMP) editing application for Linux, Windows and MacOS.
"Metadata" is said to mean "data about data".
In the context of digital photographs this means information that isn't essential in order to display the image, but tells you something about it.
For example a title and description of the scene or the date & time and the GPS coordinates of the camera's position when the picture was taken.
"[Photini] doesn't try to be an all-singing, all-dancing image management powerhouse - it just lets you add information to photos, quickly and easily."
-- `Linux Format`_ magazine, January 2013
Why is it called Photini?
Read my `blog post`_ on how I chose a name.
.. contents::
:backlinks: top
Features
--------
.. image:: https://raw.githubusercontent.com/jim-easterbrook/Photini/refs/heads/main/src/doc/images/screenshot_027.png
:alt: Text editing screenshot
* Easy to use graphical interface.
* Set photo title, description, keywords, copyright and creator fields.
* Some support for video files.
* Spell checking of some fields (optional).
* Can set metadata for multiple images simultaneously.
* Can adjust picture date & time and time zone (of multiple images simultaneously).
* Reads Exif, IPTC and XMP metadata, writes all three to maximise compatibility with other software.
* Writes metadata to image files or to XMP "sidecar" files.
* Can import photographs from many digital cameras.
* Upload to Flickr_ or `Google Photos`_ or Ipernity_ or Pixelfed_ with reuse of metadata.
.. image:: https://raw.githubusercontent.com/jim-easterbrook/Photini/refs/heads/main/src/doc/images/screenshot_224.png
:alt: Geotagging screenshot
* Geotagging - search map to find named places.
* Choice of map providers - instantly switch to compare details.
* Drag and drop images on to map to set GPS location.
* Or set GPS location using data exported by a tracker app.
* Edit coordinates if required, or clear to unset GPS data.
* Convert GPS coordinates to street address.
* Suggestions for further development welcome.
Dependencies
------------
Photini requires at least the following:
* Python3: http://python.org/
* PyQt5, PyQt6, PySide2, or PySide6: http://www.riverbankcomputing.co.uk/software/pyqt/ or https://doc.qt.io/qtforpython/
* python-exiv2: https://pypi.org/project/exiv2/
For a full list of dependencies, please see the `installation documentation`_.
Documentation
-------------
.. warning::
This program, like all software, may have bugs.
Before using it be sure to back up all your photographs (you do this anyway, right?) as I can't guarantee you won't accidentally damage them.
Photini's documentation is at http://photini.readthedocs.io/.
It includes detailed installation instructions and a full user manual.
.. _readme-getting_help:
Getting help
------------
If you encounter any problems installing or running Photini, please email jim@jim-easterbrook.me.uk and I'll respond as soon as I can.
There is also an email list or forum for discussions about Photini at https://groups.google.com/forum/#!forum/photini.
If you discover a bug and have a GitHub account then please file a bug report on the GitHub `"issues" page`_.
If you find a problem with a particular image file then it would be useful for me to have a copy of its metadata.
You can use the exiv2_ command line program to extract the raw metadata so you don't need to send me the entire image file.
For example, the command ``exiv2 ex problem_file.jpg`` can reduce a 3 MByte image file to a 20 kByte file called ``problem_file.exv``.
I promise not to publish or redistribute any file you send me.
Localisation
------------
Work has begun on providing Photini in multiple languages.
I rely on users to do the translation, as I am not fluent in any language other than English.
The project uses an online translation service called Weblate_.
If you'd like to help translate Photini, please join the `Photini team on Hosted Weblate`_.
For more details, see the `localisation documentation`_.
.. _readme-legalese:
Licence
-------
| Photini - a simple photo metadata editor.
| http://github.com/jim-easterbrook/Photini
| Copyright (C) 2012-24 Jim Easterbrook jim@jim-easterbrook.me.uk
| Catalan translation by Joan Juvanteny
| Czech translation by Pavel Fric
| French translation by Nathan, J. Lavoie, Thibault Chevrin
| German translation by Jan Rimmek, J. Lavoie, Ettore Atalan
| Italian translation by "albanobattistella"
| Korean translation by Soohyeon Park
| Norwegian Bokmål translation by Allan Nordhøy
| Polish translation by Dawid Głaz, Eryk Michalak
| Spanish translation by Esteban Martinena, Cristos Ruiz, Kamborio, gallegonovato
This program is free software: you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see http://www.gnu.org/licenses/.
Service terms and conditions
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Use of the Google map tab is subject to the `Google Maps Terms of Use`_ and `Google Privacy Policy`_.
Use of the Azure map tab is subject to the `Microsoft Product Terms For Online Services`_ and `Microsoft Privacy & Security Terms`_.
Use of the Bing map tab is subject to the `Microsoft Bing Maps Terms of Use`_ and `Microsoft Privacy Statement`_.
Use of the Mapbox map tab is subject to the `Mapbox terms of service`_ and `Mapbox privacy policy`_.
The Flickr upload tab uses the Flickr API but is not endorsed or certified by Flickr.
Privacy statement
^^^^^^^^^^^^^^^^^
Photini does not directly gather any information from its users, but the online services it can use (maps and uploaders) may do so.
You should read these services' privacy policies before using them.
Photini stores user preferences in a text file on the user's computer.
The default location of this file is ``$HOME/.config/photini/`` (Linux), ``$HOME/Library/Preferences/photini`` (MacOS), or ``%USERPROFILE%\AppData\Local\photini\`` (Windows).
OAuth_ access tokens for the uploader tabs are securely stored on the user's computer using `Python keyring`_.
Documentation licence
^^^^^^^^^^^^^^^^^^^^^
Permission is granted to copy, distribute and/or modify the Photini documentation under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the documentation section entitled "GNU Free Documentation License".
.. _blog post:
https://www.jim-easterbrook.me.uk/2012/10/photini-whats-in-a-name/
.. _exiv2: https://exiv2.org/manpage.html
.. _Flickr: http://www.flickr.com/
.. _Google Photos: https://photos.google.com/
.. _Google Maps Terms of Use:
http://www.google.com/help/terms_maps.html
.. _Google Privacy Policy:
http://www.google.com/policies/privacy/
.. _installation documentation:
http://photini.readthedocs.io/en/latest/other/installation.html
.. _Ipernity: http://www.ipernity.com/
.. _"issues" page: https://github.com/jim-easterbrook/Photini/issues
.. _Linux Format: http://www.linuxformat.com/archives?issue=166
.. _localisation documentation:
http://photini.readthedocs.io/en/latest/other/localisation.html
.. _Mapbox terms of service:
https://www.mapbox.com/tos/
.. _Mapbox privacy policy:
https://www.mapbox.com/privacy/
.. _Microsoft Bing Maps Terms of Use:
http://www.microsoft.com/maps/assets/docs/terms.aspx
.. _Microsoft Privacy & Security Terms:
https://www.microsoft.com/licensing/terms/product/PrivacyandSecurityTerms/all
.. _Microsoft Privacy Statement:
http://www.microsoft.com/en-us/privacystatement/
.. _Microsoft Product Terms For Online Services:
https://www.microsoft.com/licensing/terms/product/ForOnlineServices/all
.. _OAuth: http://oauth.net/
.. _OpenStreetMap licence:
http://www.openstreetmap.org/copyright
.. _Photini team on Hosted Weblate:
https://hosted.weblate.org/projects/photini/
.. _Pixelfed: https://pixelfed.org/
.. _Python keyring:
https://pypi.python.org/pypi/keyring#what-is-python-keyring-lib
.. _Weblate: https://hosted.weblate.org
Raw data
{
"_id": null,
"home_page": null,
"name": "Photini",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "Exif, IPTC, XMP",
"author": null,
"author_email": "Jim Easterbrook <jim@jim-easterbrook.me.uk>",
"download_url": "https://files.pythonhosted.org/packages/8e/69/0b76bbfc3611be42d4a42e95dc73eabe9dbd0c10ebbfd3b83347489d4974/photini-2024.11.0.tar.gz",
"platform": null,
"description": "Photini\n=======\n\nA free, easy to use, digital photograph metadata (Exif, IPTC, XMP) editing application for Linux, Windows and MacOS.\n\n\"Metadata\" is said to mean \"data about data\".\nIn the context of digital photographs this means information that isn't essential in order to display the image, but tells you something about it.\nFor example a title and description of the scene or the date & time and the GPS coordinates of the camera's position when the picture was taken.\n\n \"[Photini] doesn't try to be an all-singing, all-dancing image management powerhouse - it just lets you add information to photos, quickly and easily.\"\n \n -- `Linux Format`_ magazine, January 2013\n\nWhy is it called Photini?\nRead my `blog post`_ on how I chose a name.\n\n.. contents::\n :backlinks: top\n\nFeatures\n--------\n\n.. image:: https://raw.githubusercontent.com/jim-easterbrook/Photini/refs/heads/main/src/doc/images/screenshot_027.png\n :alt: Text editing screenshot\n\n* Easy to use graphical interface.\n* Set photo title, description, keywords, copyright and creator fields.\n* Some support for video files.\n* Spell checking of some fields (optional).\n* Can set metadata for multiple images simultaneously.\n* Can adjust picture date & time and time zone (of multiple images simultaneously).\n* Reads Exif, IPTC and XMP metadata, writes all three to maximise compatibility with other software.\n* Writes metadata to image files or to XMP \"sidecar\" files.\n* Can import photographs from many digital cameras.\n* Upload to Flickr_ or `Google Photos`_ or Ipernity_ or Pixelfed_ with reuse of metadata.\n\n.. image:: https://raw.githubusercontent.com/jim-easterbrook/Photini/refs/heads/main/src/doc/images/screenshot_224.png\n :alt: Geotagging screenshot\n\n* Geotagging - search map to find named places.\n* Choice of map providers - instantly switch to compare details.\n* Drag and drop images on to map to set GPS location.\n* Or set GPS location using data exported by a tracker app.\n* Edit coordinates if required, or clear to unset GPS data.\n* Convert GPS coordinates to street address.\n* Suggestions for further development welcome.\n\nDependencies\n------------\n\nPhotini requires at least the following:\n\n* Python3: http://python.org/\n* PyQt5, PyQt6, PySide2, or PySide6: http://www.riverbankcomputing.co.uk/software/pyqt/ or https://doc.qt.io/qtforpython/\n* python-exiv2: https://pypi.org/project/exiv2/\n\nFor a full list of dependencies, please see the `installation documentation`_.\n\nDocumentation\n-------------\n\n.. warning::\n This program, like all software, may have bugs.\n Before using it be sure to back up all your photographs (you do this anyway, right?) as I can't guarantee you won't accidentally damage them.\n\nPhotini's documentation is at http://photini.readthedocs.io/.\nIt includes detailed installation instructions and a full user manual.\n\n.. _readme-getting_help:\n\nGetting help\n------------\n\nIf you encounter any problems installing or running Photini, please email jim@jim-easterbrook.me.uk and I'll respond as soon as I can.\nThere is also an email list or forum for discussions about Photini at https://groups.google.com/forum/#!forum/photini.\nIf you discover a bug and have a GitHub account then please file a bug report on the GitHub `\"issues\" page`_.\n\nIf you find a problem with a particular image file then it would be useful for me to have a copy of its metadata.\nYou can use the exiv2_ command line program to extract the raw metadata so you don't need to send me the entire image file.\nFor example, the command ``exiv2 ex problem_file.jpg`` can reduce a 3\u00a0MByte image file to a 20\u00a0kByte file called ``problem_file.exv``.\nI promise not to publish or redistribute any file you send me.\n\nLocalisation\n------------\n\nWork has begun on providing Photini in multiple languages.\nI rely on users to do the translation, as I am not fluent in any language other than English.\nThe project uses an online translation service called Weblate_.\nIf you'd like to help translate Photini, please join the `Photini team on Hosted Weblate`_.\nFor more details, see the `localisation documentation`_.\n\n.. _readme-legalese:\n\nLicence\n-------\n\n| Photini - a simple photo metadata editor.\n| http://github.com/jim-easterbrook/Photini\n| Copyright (C) 2012-24 Jim Easterbrook jim@jim-easterbrook.me.uk\n\n| Catalan translation by Joan Juvanteny\n| Czech translation by Pavel Fric\n| French translation by Nathan, J. Lavoie, Thibault Chevrin\n| German translation by Jan Rimmek, J. Lavoie, Ettore Atalan\n| Italian translation by \"albanobattistella\"\n| Korean translation by Soohyeon Park\n| Norwegian Bokm\u00e5l translation by Allan Nordh\u00f8y\n| Polish translation by Dawid G\u0142az, Eryk Michalak\n| Spanish translation by Esteban Martinena, Cristos Ruiz, Kamborio, gallegonovato\n\nThis program is free software: you can redistribute it and/or\nmodify it under the terms of the GNU General Public License as\npublished by the Free Software Foundation, either version 3 of the\nLicense, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\nGeneral Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program. If not, see http://www.gnu.org/licenses/.\n\nService terms and conditions\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nUse of the Google map tab is subject to the `Google Maps Terms of Use`_ and `Google Privacy Policy`_.\n\nUse of the Azure map tab is subject to the `Microsoft Product Terms For Online Services`_ and `Microsoft Privacy & Security Terms`_.\n\nUse of the Bing map tab is subject to the `Microsoft Bing Maps Terms of Use`_ and `Microsoft Privacy Statement`_.\n\nUse of the Mapbox map tab is subject to the `Mapbox terms of service`_ and `Mapbox privacy policy`_.\n\nThe Flickr upload tab uses the Flickr API but is not endorsed or certified by Flickr.\n\nPrivacy statement\n^^^^^^^^^^^^^^^^^\n\nPhotini does not directly gather any information from its users, but the online services it can use (maps and uploaders) may do so.\nYou should read these services' privacy policies before using them.\n\nPhotini stores user preferences in a text file on the user's computer.\nThe default location of this file is ``$HOME/.config/photini/`` (Linux), ``$HOME/Library/Preferences/photini`` (MacOS), or ``%USERPROFILE%\\AppData\\Local\\photini\\`` (Windows).\nOAuth_ access tokens for the uploader tabs are securely stored on the user's computer using `Python keyring`_.\n\n\nDocumentation licence\n^^^^^^^^^^^^^^^^^^^^^\n\nPermission is granted to copy, distribute and/or modify the Photini documentation under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.\nA copy of the license is included in the documentation section entitled \"GNU Free Documentation License\".\n\n.. _blog post:\n https://www.jim-easterbrook.me.uk/2012/10/photini-whats-in-a-name/\n.. _exiv2: https://exiv2.org/manpage.html\n.. _Flickr: http://www.flickr.com/\n.. _Google Photos: https://photos.google.com/\n.. _Google Maps Terms of Use:\n http://www.google.com/help/terms_maps.html\n.. _Google Privacy Policy:\n http://www.google.com/policies/privacy/\n.. _installation documentation:\n http://photini.readthedocs.io/en/latest/other/installation.html\n.. _Ipernity: http://www.ipernity.com/\n.. _\"issues\" page: https://github.com/jim-easterbrook/Photini/issues\n.. _Linux Format: http://www.linuxformat.com/archives?issue=166\n.. _localisation documentation:\n http://photini.readthedocs.io/en/latest/other/localisation.html\n.. _Mapbox terms of service:\n https://www.mapbox.com/tos/\n.. _Mapbox privacy policy:\n https://www.mapbox.com/privacy/\n.. _Microsoft Bing Maps Terms of Use:\n http://www.microsoft.com/maps/assets/docs/terms.aspx\n.. _Microsoft Privacy & Security Terms:\n https://www.microsoft.com/licensing/terms/product/PrivacyandSecurityTerms/all\n.. _Microsoft Privacy Statement:\n http://www.microsoft.com/en-us/privacystatement/\n.. _Microsoft Product Terms For Online Services:\n https://www.microsoft.com/licensing/terms/product/ForOnlineServices/all\n.. _OAuth: http://oauth.net/\n.. _OpenStreetMap licence:\n http://www.openstreetmap.org/copyright\n.. _Photini team on Hosted Weblate:\n https://hosted.weblate.org/projects/photini/\n.. _Pixelfed: https://pixelfed.org/\n.. _Python keyring:\n https://pypi.python.org/pypi/keyring#what-is-python-keyring-lib\n.. _Weblate: https://hosted.weblate.org\n",
"bugtrack_url": null,
"license": "GPLv3+",
"summary": "Simple photo metadata editor",
"version": "2024.11.0",
"project_urls": {
"Changelog": "https://github.com/jim-easterbrook/Photini/blob/main/CHANGELOG.txt",
"Documentation": "https://photini.readthedocs.io/",
"Homepage": "https://github.com/jim-easterbrook/Photini",
"Repository": "https://github.com/jim-easterbrook/Photini"
},
"split_keywords": [
"exif",
" iptc",
" xmp"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1509cf20e1d585f6f025437ecab3f534d11a4bd08ef915296d11f64e07ed1346",
"md5": "7ce80eb105e7da0c18de23e73478d9de",
"sha256": "b6ff88b1906434619fc1dfa1ee1c361c42bd9d24c769a5339f43b7ffc257f7f1"
},
"downloads": -1,
"filename": "Photini-2024.11.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7ce80eb105e7da0c18de23e73478d9de",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 736336,
"upload_time": "2024-11-05T12:27:41",
"upload_time_iso_8601": "2024-11-05T12:27:41.834654Z",
"url": "https://files.pythonhosted.org/packages/15/09/cf20e1d585f6f025437ecab3f534d11a4bd08ef915296d11f64e07ed1346/Photini-2024.11.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8e690b76bbfc3611be42d4a42e95dc73eabe9dbd0c10ebbfd3b83347489d4974",
"md5": "7a4eee1f57b4cef0321f3939dd9091d1",
"sha256": "c46f3845701f5630b7b7974d09dcbdf5df9d0e62db5ea27b4d99e4f0fdb74d2c"
},
"downloads": -1,
"filename": "photini-2024.11.0.tar.gz",
"has_sig": false,
"md5_digest": "7a4eee1f57b4cef0321f3939dd9091d1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 699429,
"upload_time": "2024-11-05T12:27:49",
"upload_time_iso_8601": "2024-11-05T12:27:49.997571Z",
"url": "https://files.pythonhosted.org/packages/8e/69/0b76bbfc3611be42d4a42e95dc73eabe9dbd0c10ebbfd3b83347489d4974/photini-2024.11.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-05 12:27:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jim-easterbrook",
"github_project": "Photini",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "photini"
}
