https://github.com/Zebradil/Gimme-iPhotos
Download media files from iCloud.
https://github.com/Zebradil/Gimme-iPhotos
icloud icloud-photos icloud-sync python
Last synced: 8 days ago
JSON representation
Download media files from iCloud.
- Host: GitHub
- URL: https://github.com/Zebradil/Gimme-iPhotos
- Owner: Zebradil
- License: mit
- Archived: true
- Created: 2020-04-17T21:51:45.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-24T00:59:44.000Z (about 1 year ago)
- Last Synced: 2025-03-14T02:48:39.757Z (about 1 month ago)
- Topics: icloud, icloud-photos, icloud-sync, python
- Language: Python
- Homepage:
- Size: 291 KB
- Stars: 119
- Watchers: 3
- Forks: 4
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - Zebradil/Gimme-iPhotos - Download media files from iCloud. (Python)
README
# Gimme-iPhotos
## 🪦 Discontinued
This project is no longer maintained. Check https://github.com/icloud-photos-downloader/icloud_photos_downloader instead.
I have not been using iCloud and Apple devices since 2021 and I do not plan to.
This project was started to first off-load my photos from iCloud and then migrate out of iCloud completely.
Probably, it doesn't make sense to fork or attempt to recover it, as https://github.com/picklepete/pyicloud, on which Gimme-iPhotos relies is not maintained for a couple of years as well.
## Overview
[](https://pypi.python.org/pypi/gimme-iphotos)
[](https://opensource.org/licenses/MIT)
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 the keychain (provided by [pyicloud])
- Supports two-factor authentication
- Shows nice progress bars (thanks to [tqdm])
## Installation
```sh
$ pip3 install gimme-iphotos
```
or
```sh
$ 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] [-g] [--zero-pad]
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 Increase verbosity. Can be specified multiple times.
Use -vvvv to get maximum verbosity.
-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
-g, --group Group the photos into year and month directories.
--zero-pad Zero pad months when grouping photos.
```
Using config file:
```sh
$ cat john.cfg
[main]
username = [email protected]
password = not-secure123
destination = /home/john/Photos
remove = True
$ gimme-iphotos -c john.cfg
```
Overriding config file:
```sh
$ gimme-iphotos -c john.cfg --destination /tmp/icloud
```
Without config file:
```sh
$ # Password will be requested interactively
$ gimme-iphotos -u [email protected] --destination /tmp/icloud
Enter iCloud password for [email protected]:
```
### Docker
The CLI is the same but requires mounting the destination directory and config file (if needed).
```sh
$ docker run --interactive --tty \
-v :/somedir \
-v ${PWD}/john.cfg:/app/john.cfg \
zebradil/gimme-iphotos -c john.cfg
```
## License
Licensed under the [MIT License].
By [German Lashevich].
[MIT License]: https://github.com/zebradil/Gimme-iPhotos/blob/master/LICENSE
[pyicloud]: https://github.com/picklepete/pyicloud
[tqdm]: https://github.com/tqdm/tqdm
[German Lashevich]: https://github.com/zebradil