https://github.com/chyroc/icloudgo
Access Apple iCloud via go, go port of pyicloud
https://github.com/chyroc/icloudgo
icloud icloud-photos icloudpb
Last synced: 3 months ago
JSON representation
Access Apple iCloud via go, go port of pyicloud
- Host: GitHub
- URL: https://github.com/chyroc/icloudgo
- Owner: chyroc
- License: apache-2.0
- Created: 2023-02-15T05:02:55.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-12-29T15:52:22.000Z (over 1 year ago)
- Last Synced: 2025-03-16T10:51:20.648Z (3 months ago)
- Topics: icloud, icloud-photos, icloudpb
- Language: Go
- Homepage:
- Size: 323 KB
- Stars: 105
- Watchers: 5
- Forks: 16
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# icloudgo
Access Apple iCloud via go, go port of pyicloud.
## Download iCloud Photos
### By Docker
```shell
docker run \
-e ICLOUD_USERNAME=your_icloud_username \
-e ICLOUD_PASSWORD=your_icloud_password \
-e ICLOUD_COOKIE_DIR=/icloud_cookie \
-e ICLOUD_DOMAIN=com \
-e ICLOUD_OUTPUT=/icloud_photos \
-e ICLOUD_ALBUM= \
-e ICLOUD_THREAD_NUM=10 \
-e ICLOUD_AUTO_DELETE=true \
-e ICLOUD_STOP_FOUND_NUM=50 \
-e ICLOUD_FOLDER_STRUCTURE="2006/01/02" \
-e ICLOUD_FILE_STRUCTURE="id" \
-e ICLOUD_WITH_LIVE_PHOTO="true" \
-v /path/to/your/cookie:/icloud_cookie \
-v /path/to/your/photos:/icloud_photos \
ghcr.io/chyroc/icloud-photo-cli:0.21.1 download
```
### By Go
- **Install**
```shell
go install github.com/chyroc/icloudgo/icloud-photo-cli@latest
```
- **Usage**
```shell
NAME:
icloud-photo-cli download
USAGE:
icloud-photo-cli download [command options] [arguments...]
DESCRIPTION:
download photos
OPTIONS:
--username value, -u value apple id username [$ICLOUD_USERNAME]
--password value, -p value apple id password [$ICLOUD_PASSWORD]
--cookie-dir value, -c value cookie dir [$ICLOUD_COOKIE_DIR]
--domain value, -d value icloud domain(com,cn) (default: com) [$ICLOUD_DOMAIN]
--output value, -o value output dir (default: "./iCloudPhotos") [$ICLOUD_OUTPUT]
--album value, -a value album name, if not set, download all albums [$ICLOUD_ALBUM]
--folder-structure 2006, --fs 2006 folder structure, support: 2006(year), `01`(month), `02`(day), `15`(24-hour), `03`(12-hour), `04`(minute), `05`(second), example: `2006/01/02`, default is `/` [$ICLOUD_FOLDER_STRUCTURE]
--file-structure value support: id(unique file id), name(file human readable name) (default: "id") [$ICLOUD_FILE_STRUCTURE]
--stop-found-num stop-found-num, -s stop-found-num stop download when found stop-found-num photos have been downloaded (default: 0) [$ICLOUD_STOP_FOUND_NUM]
--thread-num value, -t value thread num, if not set, means 1 (default: 1) [$ICLOUD_THREAD_NUM]
--auto-delete, --ad Automatically delete photos from local but recently deleted folders (default: true) [$ICLOUD_AUTO_DELETE]
--with-live-photo, --lp Save video of the live photo (default: true) [$ICLOUD_WITH_LIVE_PHOTO]
--help, -h show help
```
## Upload iCloud Photos
### By Docker
```shell
docker run \
-i \
-e ICLOUD_USERNAME=your_icloud_username \
-e ICLOUD_PASSWORD=your_icloud_password \
-e ICLOUD_COOKIE_DIR=/icloud_cookie \
-e ICLOUD_DOMAIN=com \
-e ICLOUD_FILE=/icloud_photos/filepath \
-v /path/to/your/cookie:/icloud_cookie \
-v /path/to/your/photos:/icloud_photos \
ghcr.io/chyroc/icloud-photo-cli:0.21.1 upload
```
### By Go
- **Install**
```shell
go install github.com/chyroc/icloudgo/icloud-photo-cli@latest
```
- **Usage**
```shell
NAME:
icloud-photo-cli upload
USAGE:
icloud-photo-cli upload [command options] [arguments...]
DESCRIPTION:
upload photos
OPTIONS:
--username value, -u value apple id username [$ICLOUD_USERNAME]
--password value, -p value apple id password [$ICLOUD_PASSWORD]
--cookie-dir value, -c value cookie dir [$ICLOUD_COOKIE_DIR]
--domain value, -d value icloud domain(com,cn) (default: com) [$ICLOUD_DOMAIN]
--file value, -f value file path [$ICLOUD_FILE]
--help, -h show help
```