https://github.com/hazcod/macbac

Manage and automate your macOS snapshots.
https://github.com/hazcod/macbac

backup bash macbac macos snapshot

Last synced: about 1 month ago
JSON representation

Manage and automate your macOS snapshots.

• Host: GitHub
• URL: https://github.com/hazcod/macbac
• Owner: hazcod
• License: mit
• Created: 2020-12-30T10:16:00.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2021-10-12T07:29:21.000Z (about 3 years ago)
• Last Synced: 2024-05-02T05:09:43.708Z (8 months ago)
• Topics: backup, bash, macbac, macos, snapshot
• Language: Shell
• Homepage:
• Size: 22.5 KB
• Stars: 32
• Watchers: 5
• Forks: 2
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# macbac

Lists, controls and schedules efficient APFS snapshots for your convenience.

```shell

# let's take space efficient APFS snapshots every hour

# knowing they get cleaned up if necessary

% macbac schedule hourly

Installing daemon config to /Users/user/Library/LaunchAgents/com.hazcod.macbac.plist

Loading config to enable schedule...

Scheduled hourly snapshots!

# show our current snapshots

% macbac list

/Volumes/SSD

> 2020/12/30 10:23

> 2020/12/30 11:04

> 2020/12/30 11:05

# take a manual snapshot

% macbac snapshot

Assuming / is the volume we would like to snapshot.

Created local snapshot with date: 2020-12-30-111728

Snapshotted volume /

# let's remove snapshots but ensure we keep the 3 most recent

% macbac prune 3

Pruning 1 of 4 snapshots for /

Pruning snapshot 2021-02-04-155845 (1/1)

```

## How does it work?

It's a convenient wrapper around `tmutil` and basically replicates the local snapshot feature Time Machine would perform when you are backing up to a remote disk.

## Installation

Installation can be done straight from [my Homebrew tap](https://github.com/hazcod/homebrew-hazcod) via `brew install hazcod/homebrew-hazcod/macbac` or just copy `macbac.sh` to  your filesystem.

## Setup

1. First enable Time Machine by running `macbac enable`.

   You may need to add `Terminal.app` to Full Disk Access in Security & Privacy.

   

2. Now schedule your snapshots e.g. hourly via `macbac schedule hourly`.

## Usage

`Usage: macbac  <...>`

To view Time Machine status: `macbac status`

To take a snapshot: `macbac snapshot`

To take a snapshot and keep 3: `macbac snapshot 3`

To prune but keep 5: `macbac prune 5`

To schedule hourly snapshots, keeping 24: `macbac schedule hourly`

To schedule hourly snapshots, keeping 3: `macbac schedule hourly 3` 

To schedule daily snapshots, keeping 7: `macbac schedule daily`

To view when the next snapshot is going to be taken: `macbac next`