Metadata-Version: 1.1
Name: geotagger
Version: 0.0.1b0
Summary: Geotag photos with exiftool based on your Moves app history
Home-page: https://github.com/jkbrzt/geotagger
Author: Jakub Roztocil
Author-email: jakub@roztocil.co
License: MIT
Download-URL: https://github.com/jkbrzt/geotagger
Description: GeoTagger
        #########
        
        Geotag your photos using your smartphone location history.
        
        
        .. image:: https://github.com/jkbrzt/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.
        * GeTagger is able to retrospectively add 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 <https://en.wikipedia.org/wiki/GPS_Exchange_Format>`_ 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 <http://www.sno.phy.queensu.ca/~phil/exiftool/install.html>`_
           ``exiftool``, for example, with: ``$ brew install exiftool``
        2. Install ``geotagger`` from PyPi with: ``$ pip install geotagger``
        
        
        Usage
        =====
        
        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 the app:
           ``{"MOVES_ID": "<CLIENT_ID>", "MOVES_SECRET": "<CLIENT_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 ~/Desktop/photos
        
        You can also just generate a GPX log for the dates without applying it:
        
        .. code-block:: bash
        
            $ geotagger gpx ~/Desktop/photos
        
        The ``tag`` command also optionally accepts a path to a GPX log file
        
        .. code-block:: bash
        
            $ geotagger gpx ~/Desktop/photos > ~/Desktop/photos/log.gpx
            $ geotagger tag ~/Desktop/photos ~/Desktop/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
        
        
        Contact
        =======
        
        Jakub Roztocil
        
        * https://github.com/jkbrzt
        * https://twitter.com/jkbrzt
        
        
        Licence
        =======
        
        MIT. See `LICENCE <./LICENCE>`_.
        
Platform: UNKNOWN
