lra /mackup

Backup and keep your application settings in sync.

★ 15,359⑂ 940👁 133⑃ 1,446● 723▤ 40
PythonGPL-3.0Created 2013-04-06
下载:0.11.30.11.3 ↓0.11.32026-11-10
-1
日增长
15,359
stars
940
forks
133
watchers
1,446
prs
723
issues
40
releases

README

Mackup™








Backup and keep your application settings in sync.

 Table of contents

- Mackup™
  - Table of contents
  - Quickstart
  - Usage
  - What does it do
    - Copy mode
    - Link mode
      - mackup link install
      - mackup link
      - mackup link uninstall
  - Supported Storages
  - Unsupported Storages
  - Supported Applications
  - Can you support application X
  - Personalization \& configuration
  - Why did you do this
  - What platforms are supported
  - What's up with the weird name
  - Architecture
  - Where can I find more information

 Quickstart

On macOS or Linux, if you want an easy install, you can install
Homebrew and do:

bash
 Install Mackup
brew install mackup

 Launch it and back up your files
mackup backup


If not running macOS or Linux, or you don't like Homebrew, you can use pip.

bash
 Install Mackup with PIP
pip install --upgrade mackup

 Launch it and back up your files
mackup backup


You're all set and can back up from now on.

Next, on any new workstation, do:

bash
 Install Mackup
brew install mackup

 Launch it and restore your files
mackup restore


Done!

You can find more detailed instructions in INSTALL.md.

 Usage

backup, restore, link install, link uninstall and link operate on all
of your configured applications by default. To limit a command to a single
application, add its name (the identifier shown by mackup list), e.g.
mackup backup vim. Naming an application overrides the
[applications_to_sync] / [applications_to_ignore] settings in your
.mackup.cfg, so you can act on any supported app without editing your config.

mackup backup [application]

Back up your application files. Copy your local config files into the Mackup folder.
Name an application to back up only that one, e.g. mackup backup vim.

mackup restore [application]

Restore your application settings on a newly installed workstation.
Copy config files from the Mackup folder to your home folder.
Name an application to restore only that one, e.g. mackup restore emacs.

mackup link install [application]

Move your local config files into the Mackup folder,
and link them to their original place.
Name an application to install only that one.

$${\color{red}warning}$$ _the link strategy doesn't work correctly on macOS_

mackup link [application]

On another workstation, links local config files from the Mackup folder.
Name an application to link only that one.

mackup link uninstall [application]

Copy back any synced config file to its original place.
Removes the links and copies config files from the Mackup folder back into your
home.
Name an application (e.g. mackup link uninstall git) to unlink only that one;
scoping to an application skips the global uninstall confirmation.

mackup list

Display the list of applications supported by Mackup.

mackup -h

Get some help, obviously...

 What does it do

By only tracking pure configuration files, it keeps the crap out of your
freshly new installed workstation (no cache, temporary and 

Top issues

Discussions

Latest release

0.11.3 0.11.3 2026-11-10
What's Changed
 ci: drop macOS 14 runners, add macOS 26 and Ubuntu 26.04 by @lra in https://github.com/lra/mackup/pull/2204
 gmailctl - Add XDG configuration path by @brkn in https://github.com/lra/mackup/pull/2203

 New Contributors
 @brkn made their first contribution in https://github.com/lra/mackup/pull/2203

Full Changelog: https://github.com/lra/mackup/compare/0.11.2...0.11.3

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON