shallow-backup

shallow-backup lets you easily create lightweight backups of installed packages, applications, fonts and dotfiles, and automatically push them to a remote Git repository.

Contents

• Featured On
• What can I back up?
• Installation
• Usage
  • Example Commands
  • Use Cases
  • Output Structure
• Inspiration
• How to Contribute

Featured On

---

shallow-backup is featured on these awesome lists!

• awesome-mac
• awesome-shell
• open-source-mac-os-apps
• tools-osx
• agarrharr/awesome-cli-apps

What can I back up?

---

1. dotfiles and dotfolders.

   • .bashrc
   • .bash_profile
   • .gitconfig
   • .pypirc
   • .shallow-backup
   • .ssh/
   • .vim/
   • .zshrc

2. Application Preferences

   • Sublime Text
   • Terminal
   • VS Code (Coming soon!)

3. Installed packages.

   • Atom Packages (apm)
   • brew and cask
   • cargo
   • gem
   • pip
   • npm
   • macports
   • Sublime Text Packages
   • ~/Applications/ directory

4. User installed fonts.

Installation

---

1. Install with pip

   • $ pip install shallow-backup
   • $ shallow-backup

2. Download the shallow-backup binary from Releases tab.

Usage

---

Usage: shallow_backup.py [OPTIONS]

  Easily back up installed packages, dotfiles, and more.
  You can edit which dotfiles are backed up in ~/.shallow-backup.

Options:
  -complete            Back up everything.
  -dotfiles            Back up dotfiles.
  -configs             Back up app config files.
  -fonts               Back up installed fonts.
  -packages            Back up package libraries and installed applications.
  -old_path            Skip setting new back up directory path.
  --new_path TEXT      Input a new back up directory path.
  --remote TEXT        Input a URL for a git repository.
  -reinstall_packages  Reinstall packages from package lists.
  -reinstall_configs   Reinstall configs from configs backup.
  -delete_config       Remove config file.
  -v                   Display version and author information and exit.
  -h, -help, --help    Show this message and exit.

NOTE: shallow-backup works best when it's populating an empty directory.

Example Commands

---

$ shallow-backup # Launch interactive CLI backup process
$ shallow-backup -old_path -complete # Make complete backup using same path as in config file
$ shallow-backup -new_path new_backup_dir -fonts # Back up fonts using path: `/new_backup_dir/`

Use Cases

---

1. Reduce your backup size by compressing all package manager libraries to simple .txt files.
2. Easily back up your dotfiles.
3. Back up all user installed .ttf and .otf fonts from Fontbook.
4. Back up application preferences of Terminal and Sublime.

Output Structure

---

backup_dir/
├── configs
│   ├── plist
│   │   └── com.apple.Terminal.plist
│   ├── sublime_2
│   │   └── ...
│   └── sublime_3
│       └── ...
├── dotfiles
│   ├── .bash_profile
│   ├── .bashrc
│   ├── .gitconfig
│   ├── .pypirc
│   ├── .shallow-backup
│   ├── .ssh/
│   │   └── known_hosts
│   ├── .vim/
│   └── .zshrc
├── fonts
│   ├── AllerDisplay.ttf
│   ├── Aller_Bd.ttf
│   ├── Aller_BdIt.ttf
│   ├── Aller_It.ttf
│   ├── ...
│   ├── Ubuntu Mono derivative Powerline Bold Italic.ttf
│   ├── Ubuntu Mono derivative Powerline Bold.ttf
│   ├── Ubuntu Mono derivative Powerline Italic.ttf
│   └── Ubuntu Mono derivative Powerline.ttf
└── packages
    ├── apm_list.txt
    ├── brew-cask_list.txt
    ├── brew_list.txt
    ├── cargo_list.txt
    ├── gem_list.txt
    ├── installed_apps_list.txt
    ├── npm_list.txt
    ├── macports_list.txt
    ├── pip_list.txt
    └── sublime3_list.txt

Inspiration

---

I back up system images of my MacBook Pro to an external SSD multiple times per week, and it always takes way too long. I wanted to speed this up, so I took a look at what was actually being backed up. I saw that my brew, npm, and pip libraries took up way more memory than I imagined.

And it's totally unnecessary! All you really need to "back up" your package installs is a list of the installed packages from each package manager. If you have these lists, restoring your system package installs is easy: $ pip install -r pip_list.txt, for example. Additionally, you have the added bonus of always installing up-to-date packages after an OS wipe and reinstall.

I cut down my backup size by almost 10GB by replacing my pip, brew, brew cask and npm install libraries with simple text files, also cutting down the back up time significantly.

Once I'd built that functionality, I wanted to have a single backup utility for files and folders often used by developers, so I added the ability to backup dotfiles and fonts. (Note: Because just having a list of installed fonts or a list of dotfiles that exist isn't very useful, shallow-backup creates copies of all dotfiles and user installed fonts.)

Want to Contribute?

---

Check out CONTRIBUTING.md