Readme update, pip-requirements.lst file name change
This commit is contained in:
3
.vscode/settings.json
vendored
3
.vscode/settings.json
vendored
@@ -1,3 +1,4 @@
|
||||
{
|
||||
"python.analysis.typeCheckingMode": "basic"
|
||||
"python.analysis.typeCheckingMode": "basic",
|
||||
"python.analysis.autoImportCompletions": true
|
||||
}
|
||||
|
||||
23
README.md
23
README.md
@@ -10,6 +10,11 @@ This script will update any of the Country Code, Country, State, City and Locati
|
||||
python3 -m venv .venv
|
||||
source .venv/bin/activate
|
||||
.venv/bin/python -m pip install -U pip setuptools wheel
|
||||
pip freeze > pip-requirements.lst
|
||||
```
|
||||
|
||||
```sh
|
||||
pip install -r pip-requirements.lst
|
||||
```
|
||||
|
||||
Then install the requests and python-xmp-toolkit modules from below
|
||||
@@ -65,25 +70,25 @@ Argument | Argument Value | Description
|
||||
--debug | | Full detailed debug output. Will print out alot of data
|
||||
--test | | Does not write any changed back to the XMP sidecar file. For testing purposes
|
||||
|
||||
The script will created a backup of the current sidecar file named <original name>.BK.xmp in the same location as the original file.
|
||||
The script will created a backup of the current sidecar file named `<original name>.BK.xmp` in the same location as the original file.
|
||||
|
||||
If the Lightroom lookup is used without the --strict argument and several files with the same name are found, they will be skipped for usage.
|
||||
|
||||
#### Example
|
||||
|
||||
```
|
||||
```sh
|
||||
reverse_geolocate.py -i Photos/2017/01 -i Photos/2017/02 -l LightRoom/MyCatalogue -f overwrite -g <API KEY>
|
||||
```
|
||||
|
||||
Will find all XMP sidecar files in both folders *Photos/2017/01* and *Photos/2017/02* and all folder below it. Uses the Lightroom database at *LightRoom/MyCatalogue*. The script will overwrite all data, even if it is already set
|
||||
|
||||
```
|
||||
```sh
|
||||
reverse_geolocate.py -i Photos/2017/01 -i Photos/2017/02 -x Photos/2017/02/Folder\ A -x Photos/2017/01/Folder\ B/some_file.xmp -l LightRoom/MyCatalogue
|
||||
```
|
||||
|
||||
Will exlucde "Photos/2017/02/Folder A" from processing. For -x also a file (including the .xmp extension) can be given.
|
||||
|
||||
```
|
||||
```sh
|
||||
reverse_geolocate.py -i Photos/2017/01/Event-01/some_photo.xmp -f location
|
||||
```
|
||||
|
||||
@@ -93,7 +98,7 @@ Only works on *some_photo.xmp* file and will only set the *location* field if it
|
||||
|
||||
The Google Maps API key and the OpenStreetMap Email address can be written to a config file with the -w argument. The config file is located in $HOME/.config/reverseGeolocate/reverse_geolocate.cfg in the following format
|
||||
|
||||
```
|
||||
```ini
|
||||
[API]
|
||||
googleapikey = <google api key>
|
||||
openstreetmapemail = <email>
|
||||
@@ -101,7 +106,7 @@ openstreetmapemail = <email>
|
||||
|
||||
if no -g or -e flag is given the keys are read from the config file. If the -g or -e parameter is given it will override the one found in the config file. A new parameter can be written to this config file with -w parameter.
|
||||
|
||||
### Cache lookups ###
|
||||
### Cache lookups
|
||||
|
||||
If the same GPS coordinate is detected no other API maps call is done. With the fuzzy-distance argument this can be further extended to certain distances for each GPS coordinate from each other. The default value is 10m and can be overriden with an value to the argument.
|
||||
|
||||
@@ -142,7 +147,7 @@ order | type | target set
|
||||
|
||||
After the script is done the following overview will be printed
|
||||
|
||||
```
|
||||
```txt
|
||||
========================================
|
||||
XMP Files found : 57
|
||||
Updated : 3
|
||||
@@ -158,7 +163,7 @@ More than one found in LR : 0
|
||||
|
||||
If there are problems with getting data from the Google Maps API the complete errior sting will be printed
|
||||
|
||||
```
|
||||
```txt
|
||||
...
|
||||
---> Photos/2017/02/some_file.xmp: Error in request: OVER_QUERY_LIMIT You have exceeded your daily request quota for this API. We recommend registering for a key at the Google Developers Console: https://console.developers.google.com/apis/credentials?project=_
|
||||
(!) Could not geo loaction data [FAILED]
|
||||
@@ -167,7 +172,7 @@ If there are problems with getting data from the Google Maps API the complete er
|
||||
|
||||
Also the files that could not be updated will be printed at the end of the run under the stats list
|
||||
|
||||
```
|
||||
```txt
|
||||
...
|
||||
----------------------------------------
|
||||
Files that failed to update:
|
||||
|
||||
Reference in New Issue
Block a user