https://github.com/jkbrzt/geotagger
📸 🗺 Geotag your photos from GPS-less cameras with your phone's location history data
https://github.com/jkbrzt/geotagger
exif geolocation gpx jakubroztocil location moves movesapp photography photos
Last synced: 6 months ago
JSON representation
📸 🗺 Geotag your photos from GPS-less cameras with your phone's location history data
- Host: GitHub
- URL: https://github.com/jkbrzt/geotagger
- Owner: jkbrzt
- License: mit
- Created: 2016-08-14T01:59:15.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2019-10-22T23:50:22.000Z (almost 6 years ago)
- Last Synced: 2025-03-28T21:02:52.684Z (7 months ago)
- Topics: exif, geolocation, gpx, jakubroztocil, location, moves, movesapp, photography, photos
- Language: Python
- Homepage: https://twitter.com/jakubroztocil
- Size: 282 KB
- Stars: 39
- Watchers: 4
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.rst
Awesome Lists containing this project
README
GeoTagger
#########
Geotag your photos from GPS-less cameras with your phone's location
history data.
.. image:: https://github.com/jakubroztocil/geotagger/raw/master/geotagger.png
:alt: GeoTagger
:align: center
Is it for me?
=============
* Do you take photos with a camera without a GPS tracking feature?
* Do you have https://moves-app.com/ installed on your phone?
* Do you want to have your photos geotagged?
…if your answer is 3x yes, then this tool is for you.
How does it work?
=================
* You already walk around with your location-aware phone and Moves
records your location.
* You snap photos with your GPS-less camera.
* GeoTagger uses the creation timestamps from photos
to find your location at the time of taking them in your Moves log.
* GeoTagger is able to retrospectively add GEO tags to even old photos,
as long as your location for the period is logged with Moves.
How is it implemented?
======================
When you ask GeoTagger to tag your photos, this process takes places:
1. Unique creation dates are extracted from the photo files.
2. Your Moves history for those days is fetched from the Moves API.
3. A `GPX `_ file is
generated from the data.
4. ``exiftool -geotag`` is used behind to scene to apply that location
log to your photos.
Status
======
Beta quality.
Installation
============
1. `Install `_
``exiftool``, for example, with: ``$ brew install exiftool``
2. Install ``geotagger`` from PyPi with: ``$ pip install geotagger``
Usage
=====
See ``$ geotagger --help`` and ``$ geotagger sub-command --help``.
Moves authentication
--------------------
1. Create a new app under your Moves account: https://dev.moves-app.com/apps/new
2. Specify ``http://127.0.0.1:7777/redirect`` as ``Redirect URI``.
3. Create ``~/.geotagger.json`` with credentials for your app:
``{"MOVES_ID": "", "MOVES_SECRET": ""}``
4. Run ``geotagger auth`` and follow the instruction to authenticate the app.
Geotagging
----------
Geotag all images in a folder:
.. code-block:: bash
$ geotagger tag ./photos
You can also just generate a GPX log for the dates without applying it:
.. code-block:: bash
$ geotagger gpx ./photos > log.gpx
The ``tag`` sub-command also optionally accepts a path to a GPX log file:
.. code-block:: bash
$ geotagger tag ./photos log.gpx
TODO
====
* Improve UX: simplify installation and setup
* Make the external metadata updates play well with photos already imported to Lightroom
* Add Geosync support http://www.sno.phy.queensu.ca/~phil/exiftool/geotag.html#geosync
* Consider Electron-based GUI app
* Consider additional GPS log sources than Moves
Changelog
=========
0.0.3 (2017-09-09)
------------------
* Fixed ``missing configuration: MOVES__ID`` #1
Contact
=======
Jakub Roztocil
* https://github.com/jakubroztocil
* https://twitter.com/jakubroztocil
* https://roztocil.co
Contribute
==========
* https://github.com/jakubroztocil/geotagger
Licence
=======
MIT. See `LICENCE <./LICENCE>`_.