https://github.com/morgant/tempus-machina
A macOS (nee OS X) Time Machine work-alike powered by rsync
https://github.com/morgant/tempus-machina
backup backup-utility rsync time-machine
Last synced: 2 months ago
JSON representation
A macOS (nee OS X) Time Machine work-alike powered by rsync
- Host: GitHub
- URL: https://github.com/morgant/tempus-machina
- Owner: morgant
- License: mit
- Created: 2022-11-06T20:18:11.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-13T20:47:57.000Z (about 1 year ago)
- Last Synced: 2024-12-07T05:07:21.225Z (10 months ago)
- Topics: backup, backup-utility, rsync, time-machine
- Language: Shell
- Homepage:
- Size: 36.1 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tempus Machina
by Morgan Aldridge
## OVERVIEW
Tempus Machina aims to provide a macOS (nee OS X) [Time Machine](https://en.wikipedia.org/wiki/Time_Machine_(macOS)) work-alike powered by [rsync](https://rsync.samba.org/), especially the `tmutil` command line utility.
## PREREQUISITES
* OpenBSD:
* e2fsprogs package (for `genuuid`)
## USAGE
The intent is to support the same `tmutil` command line interface as Apple's native binary:
```
tmutil verb [options]
```
### VERBS
Supported verbs currently include:
* `setdestination [-a] arg`: Set a local mount as a backup destination
* Requires root
* If the `-a` option is given, the `arg` will be added to the list of destinations, otherwise `arg` will replace the list of destinations
* `destinationinfo`: Print information about currently configured backup destinations
* `removedestination identifier`: Remove the backup destination with the `indentifier` unique identifier
* Requires root
* `machinedirectory`: Print the path to the computer's current backup directory
* `listbackups`: Print information about completed backups for this computer
* `addexclusion [-p] item`: Add a file/directory/mount to be excluded from backups
* Requires root
* If the `-p` option (currently required) is given, a fixed-path exclusion will be added for `item`
* `removeexclusion [-p] item`: Remove exclusion of file/path/mount from backups
* Requires root
* If the `-p` option (currently required) is given, the fixed-path exclusion witll be removed for `item`
* `isexcluded item`: Determine if a file/directory/mount will be excluded from backups
* `startbackup [-b] [-d dest_id]`: Manually start a new backup
* Currently requires root
* If the `-b` option (currently required) is given, it will wait until the backup has completed before exiting
* If the `-d` option is given, the backup will be performed to the destination with `dest_id` unique identifier
* `latestbackup`: Print information about the computer's most recent backup
* `delete [ -d destination -t timestamp ] [ -p path ]`: Delete a specific backup for the computer
* Requires root
* If the '-p' option is given, it will delete the backup specified by the path
* If the '-d' & '-t' options are given, it will build the backup's path from the destination and timestamp and delete that backup
* `deleteinprogress machine_directory`: Delete incomplete backups in path
* Requires root
Not all of the options that Apple's binary supports are included above. More verbs and options will be added as time permits.
## LICENSE
Released under the [MIT License](LICENSE).