celogeek/piwigo-cli
1
0
Fork 0
mirror of https://github.com/celogeek/piwigo-cli.git synced 2025-05-25 10:12:37 +02:00
Code Issues Projects Releases Wiki Activity

update readme

Browse Source
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
1 changed files with 47 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
README.md
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