Skip to content

Commit 4494ff8

Browse files
authored
Update readme to reflect use of exiftool for reverse geolocation and deprecation of MapQuest (#519)
#506
1 parent 9b071db commit 4494ff8

File tree

1 file changed

+8
-16
lines changed

1 file changed

+8
-16
lines changed

Readme.md

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,11 @@ Getting started takes just a few minutes.
1313

1414
Elodie relies on the great [ExifTool library by Phil Harvey](http://www.sno.phy.queensu.ca/~phil/exiftool/). You'll need to install it for your platform.
1515

16-
Some features for video files will only work with newer versions of ExifTool and have been tested on version 10.20 or higher. Support for HEIC files requires version 11.50 or higher. Check your version by typing `exiftool -ver` and see the [manual installation instructions for ExifTool](http://www.sno.phy.queensu.ca/~phil/exiftool/install.html#Unix) if needed.
16+
* Some video features require version 10.20 or higher
17+
* Support for HEIC files requires version 11.50 or higher
18+
* Translating geolocation to city name requires version 13.13 or higher
19+
20+
Check your version by typing `exiftool -ver` and see the [manual installation instructions for ExifTool](http://www.sno.phy.queensu.ca/~phil/exiftool/install.html#Unix) if needed.
1721

1822
```
1923
# OSX (uses homebrew, http://brew.sh/)
@@ -48,8 +52,6 @@ Now that you've got the minimum dependencies installed you can start using Elodi
4852
./elodie.py import --debug --destination="/where/i/want/my/photos/to/go" /where/my/photo/is.jpg
4953
```
5054

51-
You'll notice that the photo was organized into an *Unknown Location* folder. That's because you haven't set up your MapQuest API ([instructions](#using-openstreetmap-data-from-mapquest)).
52-
5355
### Testing changes safely with dry-run mode
5456

5557
Before running any command that modifies your photos, you can use the `--dry-run` flag to see exactly what Elodie would do without actually making any changes. This is especially useful when organizing large photo collections for the first time.
@@ -73,7 +75,7 @@ Now you're ready to learn more about Elodie.
7375

7476
## Slowstart guide
7577

76-
[Read a 3 part blog post on why I was created](https://medium.com/vantage/understanding-my-need-for-an-automated-photo-workflow-a2ff95b46f8f#.dmwyjlc57) and how [I can be used with Google Photos](https://medium.com/@jmathai/my-automated-photo-workflow-using-google-photos-and-elodie-afb753b8c724).
78+
[Read a 3 part blog post on why I was created](https://medium.com/vantage/understanding-my-need-for-an-automated-photo-workflow-a2ff95b46f8f#.dmwyjlc57) and how [I can be used with Immich](https://jaisenmathai.com/articles/my-ridiculously-robust-photo-management-system-immich-edition/).
7779

7880
I work tirelessly to make sure your photos are always sorted and organized so you can focus on more important things. By photos I mean JPEG, DNG, NEF and common video and audio files.
7981

@@ -430,19 +432,9 @@ When I organize photos I look at the embedded metadata. Here are the details of
430432
| Camera Make (photo, video) | EXIF:Make, QuickTime:Make | |
431433
| Camera Model (photo, video) | EXIF:Model, QuickTime:Model | |
432434

433-
## Using OpenStreetMap data from MapQuest
434-
435-
I use MapQuest to help me organize your photos by location. You'll need to sign up for a [free developer account](https://developer.mapquest.com/plans) and get an API key. They give you 15,000 calls per month so I can't do any more than that unless you shell out some big bucks to them. Once I hit my limit the best I'll be able to do is *Unknown Location* until the following month.
436-
437-
Once you sign up you'll have to get an API key and copy it into a file named `~/.elodie/config.ini`. I've included a `config.ini-sample` file which you can copy to `config.ini`.
438-
439-
```
440-
mkdir ~/.elodie
441-
cp config.ini-sample ~/.elodie/config.ini
442-
# now you're ready to add your MapQuest key
443-
```
435+
## Deprecated Use of MapQuest
444436

445-
If you're an english speaker then you will probably want to add `prefer_english_names=True` to the `[MapQuest]` section else you'll have cities named using the local language.
437+
I used to use the MapQuest API to help me organize your photos by location. I've deprecated this feature and will remove support from the code base. If you're already using MapQuest, after the removal of MapQuest support I'll automatically fall back to Exiftool which is the new default. Follow [pull request #518](https://github.com/jmathai/elodie/issues/518) to know when it gets removed.
446438

447439
## Questions, comments or concerns?
448440

0 commit comments

Comments
 (0)