Update README with install and run information update

tool is installed with uv tool and update run name
This commit is contained in:
2026-02-28 23:56:44 +09:00
parent ffedc9d9cf
commit 8e2414f2fd
+6 -17
View File
@@ -6,15 +6,10 @@ This script will update any of the Country Code, Country, State, City and Locati
## Installing and setting up ## Installing and setting up
The script uses the following external non defauly python libraries Everything is setup with uv, to install the tool itself
* xmp toolkit
* requests
install both with the pip3 command
```sh ```sh
uv sync uv tool install reverse-geolocate
``` ```
XMP Toolkit also needs the [Exempi Library](http://libopenraw.freedesktop.org/wiki/Exempi). This one can be install via brew or macports directly. XMP Toolkit also needs the [Exempi Library](http://libopenraw.freedesktop.org/wiki/Exempi). This one can be install via brew or macports directly.
@@ -23,7 +18,7 @@ See more information for [Python XMP Tool kit](http://python-xmp-toolkit.readthe
## Command line arguments ## Command line arguments
```sh ```sh
uv run reverse-geolocate [-h] -i reverse-geolocate [-h] -i
[XMP SOURCE FOLDER [XMP SOURCE FOLDER ...]] [XMP SOURCE FOLDER [XMP SOURCE FOLDER ...]]
[-x [EXCLUDE XMP SOURCE FOLDER [EXCLUDE XMP SOURCE FOLDER ...]]] [-x [EXCLUDE XMP SOURCE FOLDER [EXCLUDE XMP SOURCE FOLDER ...]]]
[-l LIGHTROOM FOLDER] [-s] [-l LIGHTROOM FOLDER] [-s]
@@ -33,12 +28,6 @@ uv run reverse-geolocate [-h] -i
[-v] [--debug] [--test] [-v] [--debug] [--test]
``` ```
or if outside of the project dir
```sh
uv run --project <path to project> reverse-geolocate
```
### Arguments ### Arguments
Argument | Argument Value | Description Argument | Argument Value | Description
@@ -69,19 +58,19 @@ If the Lightroom lookup is used without the --strict argument and several files
#### Example #### Example
```sh ```sh
uv run reverse-geolocate -i Photos/2017/01 -i Photos/2017/02 -l LightRoom/MyCatalogue -f overwrite -g <API KEY> reverse-geolocate -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 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 ```sh
uv run reverse-geolocate -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 reverse-geolocate -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. Will exlucde "Photos/2017/02/Folder A" from processing. For -x also a file (including the .xmp extension) can be given.
```sh ```sh
uv run reverse-geolocate -i Photos/2017/01/Event-01/some_photo.xmp -f location reverse-geolocate -i Photos/2017/01/Event-01/some_photo.xmp -f location
``` ```
Only works on *some_photo.xmp* file and will only set the *location* field if it is not yet set. Only works on *some_photo.xmp* file and will only set the *location* field if it is not yet set.