Backup multiple iOS (iPhone/iPad) devices regularly
Krummstiel is a small Python script automating regular backup apple ios device. The idea is to incrementally save pictures to your server/desktop. It is in use on Linux, but could be run on macOS as well with the proper tools installed.
- Automatically mount and copy Files to Backup path via rsync for configured and connected devices.
- Configuration of backup path
- Configure excluded paths globally or per Device
- Help in connecting new devices
- Silently ignore disconnected devices
- Notify user of the backup start and finished on the device
- Delete old photos and videos from the device after backup. Should understand not to delete Favourites or specified
albums. For that the
Photos.sqlitedatabase has to be read and understood. My efforts to understand the database are found in photossqlite.md File.
- Backup application data
- Install required tools and libraries:
Linux (Ubuntu 20.4):
apt install libimobiledevice6 libimobiledevice-utils ifuse rsyncmacOS:
brew install --cask osxfuse brew install libimobiledevice ifuse
- Clone this Repository or get
- Create a target directory that will contain the backups e.g. via
- Create your config file from example.ini
- Discover connected devices via
krummstiel.py --discover --config "/path/to/myconfig.ini"
- run the script via:
krummstiel.py --config "/path/to/myconfig.ini" --verbose
Configuration is done via .ini File and is passed via
# path fo the backup, the name of the device will always be appended
backup_path = /mnt/data/iphone_backups
# excludes can be an json array or a single value see example of iphone1
# format is for rsync --exclude syntax
exclude = Podcasts
# Section naming will be used for identifying the ios device
# Section is the uid of the ios device
# name is used to create the folder and copy files
name = my_iphone
# exclude can be repeated and is overriding exclude of the DEFAULT section
# json array
exclude = ["Podcasts", "Books"]
Automating with UDEV (Linux only)
Udev allows you to run scripts when devices are plugged in.
Automating with cron
Krummstiel can just run regularly with as a cronjob. Running it with your user ensures that you have access to the files backed up.
*/5 * * * * your_user_id path/to/krummstiel.py --config "path/to/config.ini" >> /path/to/backup.log
The name of the program was chosen to be an Apple that is under threat. One would assume that apples are ubiquitous and are in status "least concern", while this is true for many apples (especially for commercially used and still distributed apples) there are many apple types that are endangered.
The Rheinischer Krummstiel is an old apple variant which is on the "Red list of endagered domestic plants" of the German "Federal Office for Agriculture and Food". It can roughly be translated to "crooked stalk", which I found a good analogy for attaching the Apple device to an usb cable.
There are more apples, that are under threat visit the IUCN Threatened Species list for a full list of all species.
Krummstiel uses the MIT License.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for krummstiel-0.0.6-py3-none-any.whl