Download photos and videos from iCloud
Project description
Gimme-iPhotos
Download media files from iCloud.
This tool uses pyicloud to synchronize photos and videos from iCloud to your local machine.
Features
- Downloads media files from iCloud in parallel (might be beneficial on small files and wide bandwidth)
- Keeps local collection in sync with iCloud by:
- skipping files which exist locally
- removing local files which were removed from the cloud
- Reads configuration from ini-file
- Stores password in keychain (provided by pyicloud)
- Supports two-factor authentication
- Shows nice progress bars (thanks to tqdm)
Installation
$ pip3 install gimme-iphotos
or
$ docker pull zebradil/gimme-iphotos
Usage
$ gimme-iphotos --help
usage: gimme-iphotos [-h] [-c CONFIG] [-v] [-u USERNAME] [-p PASSWORD] [-d DESTINATION] [-o] [-r] [-n PARALLEL]
Downloads media files from iCloud
optional arguments:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
Configuration file. It's ini-like file (see configparser module docs), must contain [main] section. Keys are fully-named arguments, except help, config and verbose.
Values specified using command line arguments take precedence over values from a provided config file.
-v, --verbose
-u USERNAME, --username USERNAME
iCloud username (email). Can be specified interactively if not set.
-p PASSWORD, --password PASSWORD
iCloud password. Can be specified interactively if not set.
-d DESTINATION, --destination DESTINATION
Destination directory. Can be specified interactively if not set.
-o, --overwrite Overwrite existing files. Default: false.
-r, --remove Remove missing files. Default: false.
-n PARALLEL, --num-parallel-downloads PARALLEL
Max number of concurrent downloads. Increase this number if bandwidth is not fully utilized. Default: 3
Using config file:
$ cat john.cfg
[main]
username = john.doe@example.com
password = not-secure123
destination = /home/john/Photos
remove = True
$ gimme-iphotos -c john.cfg
Overriding config file:
$ gimme-iphotos -c john.cfg --destination /tmp/icloud
Without config file:
$ # Password will be requested interactively
$ gimme-iphotos -u john.doe@rexample.com --destination /tmp/icloud
Enter iCloud password for john.doe@rexample.com:
Docker
The CLI is the same but requires mounting destination directory and config file (if needed).
$ docker run -it \
-v <destination>:/somedir \
-v ${PWD}/john.cfg:/app/john.cfg \
zebradil/gimme-iphotos -c john.cfg
License
Licensed under the MIT License.
By German Lashevich.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
gimme-iphotos-1.0.7.tar.gz
(8.2 kB
view hashes)
Built Distribution
Close
Hashes for gimme_iphotos-1.0.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 47c2d7ffda84eca06dae771b43c2df86af7e38d19b524af6d443fe8db668a7a9 |
|
MD5 | 2e0d85358589c17f7d35b184953c2aa7 |
|
BLAKE2b-256 | ae3e65578f1a63d55c2b56ad7512707575593e9337ae9a4f45903fc0f1bfc5ff |