update readme

This commit is contained in:
Celogeek 2022-01-05 09:14:03 +01:00
parent 5f5bc852ed
commit 2c2cc62371
Signed by: celogeek
GPG Key ID: E6B7BDCFC446233A

View File

@ -8,6 +8,53 @@ This tools allow you to interact with your Piwigo Instance.
go install github.com/celogeek/piwigo-cli/cmd/piwigo-cli@latest go install github.com/celogeek/piwigo-cli/cmd/piwigo-cli@latest
``` ```
## Quickstart
### Login
```
piwigo-cli session login -u URL -l USER -p PASSWORD
```
### Check your status
```
piwigo-cli session status
```
### List Categories
```
piwigo-cli categories list
```
### List images in a category and sub categories
```
piwigo-cli images list -c 4 -r
```
With a tree style
```
piwigo-cli images list -c 4 -r -t
```
### Upload a tree of images
This will also create all the categories using the directory name.
In this example, the category 4 (-c 4) is 2021
```
images upload-tree -d ~/Downloads/2021 -j4 -c 4
```
This will create the categories based on your local directories, and upload only the images that doen't already exists somewhere else.
The check of the images existance use MD5 checksum. If you change the metadata of the images, it will reupload the image as a new one.
You can remove the duplicates in piwigo by looking for similar photo with Name & Date & Size. Just pickup the first one so when you try to upload again, it won't reupload the images.
## License ## License
MIT MIT