Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lra/mackup

Keep your application settings in sync (OS X/Linux)
https://github.com/lra/mackup

Last synced: 6 days ago
JSON representation

Keep your application settings in sync (OS X/Linux)

Awesome Lists containing this project

README 

        
# Mackup™



Keep your application settings in sync.



## Table of contents



- [Mackup](#mackup)

  - [Table of contents](#table-of-contents)

  - [WARNING](#warning)

  - [Quickstart](#quickstart)

  - [Usage](#usage)

  - [What does it do](#what-does-it-do)

  - [Bullsh\*t, what does it really do to my files](#bullsht-what-does-it-really-do-to-my-files)

    - [Backup](#backup)

    - [Restore](#restore)

    - [Uninstall](#uninstall)

  - [Supported Storages](#supported-storages)

  - [Unsupported Storages](#unsupported-storages)

  - [Supported Applications](#supported-applications)

  - [Can you support application X](#can-you-support-application-x)

  - [Personalization \& configuration](#personalization--configuration)

  - [Why did you do this](#why-did-you-do-this)

  - [What platforms are supported](#what-platforms-are-supported)

  - [What's up with the weird name](#whats-up-with-the-weird-name)

  - [Where can I find more information](#where-can-i-find-more-information)



## WARNING



⚠️ Mackup does not work correctly in Macos Sonoma, since it does not support

symlinked files for preferences. Running this code will destroy all user

preferences without a means for recovery. For more information, see issues

[#1924](https://github.com/lra/mackup/issues/1924) and

[2035](https://github.com/lra/mackup/issues/2035).



## Quickstart



If you have [Dropbox](https://www.dropbox.com) installed and want to use it to

save your config files, that's super easy.



On macOS, if you want an easy install, you can install

[Homebrew](http://brew.sh/) and do:



```bash

# Install Mackup

brew install mackup



# Launch it and back up your files

mackup backup

```



If not running macOS, or you don't like Homebrew, you can use [pip](https://pip.pypa.io/en/stable/).



> Note: The below command will check if a previous version of Mackup

> is already installed on your system.

> If this is the case, it will be upgraded to the latest version.



```bash

# Install Mackup with PIP

pip install --upgrade mackup



# Launch it and back up your files

mackup backup

```



> On **Ubuntu**, pip will install to the current user's home

> directory rather than system-wide. Because of this, when

> installing pip on **Ubuntu** you will need to run `pip install`

> with the `--system` flag as well (on other platforms this is not

> needed)



You're all set and constantly backed 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](INSTALL.md).



## Usage



`mackup backup`



Backup your application settings.



`mackup restore`



Restore your application settings on a newly installed workstation.



`mackup uninstall`



Copy back any synced config file to its original place.



`mackup list`



Display the list of applications supported by Mackup.



`mackup -h`



Get some help, obviously...



## What does it do



- Back ups your application settings in a safe directory (e.g. Dropbox)

- Syncs your application settings among all your workstations

- Restores your configuration on any fresh install in one command line



By only tracking pure configuration files, it keeps the crap out of your

freshly new installed workstation (no cache, temporary and locally specific

files are transfered).



Mackup makes setting up the environment easy and simple, saving time for your

family, great ideas, and all the cool stuff you like.



## Bullsh\*t, what does it really do to my files



Let's take `git` as an example. Your settings for `git` are saved in your home

folder, in the `.gitconfig` file.



### Backup



If you have Dropbox, these things happen when you launch `mackup backup`:



1. `cp ~/.gitconfig ~/Dropbox/Mackup/.gitconfig`

2. `rm ~/.gitconfig`

3. `ln -s ~/Dropbox/Mackup/.gitconfig ~/.gitconfig`



Now your `git` config is always backed up and up to date on all your workstations.



### Restore



When you launch `mackup restore`, here's what it's really doing:



1. `ln -s ~/Dropbox/Mackup/.gitconfig ~/.gitconfig`



That's it, you got your `git` config setup on your new workstation.



`mackup` does the same for any supported application.



### Uninstall



You can revert all your files to their original state.



```bash

# Just run this

mackup uninstall

```



This will remove the symlinks and copy back the files from the Mackup folder in

Dropbox to their original places in your home. The Mackup folder and the files

in it stay put, so that any other computer also running Mackup is unaffected.



## Supported Storages



- [Dropbox](https://www.dropbox.com/)

- [Google Drive](https://drive.google.com/)

- [iCloud](http://www.apple.com/icloud/)

- Anything able to sync a folder (e.g. [Git](http://git-scm.com/))



See the [README](doc/README.md) file in the doc directory for more info.



## Unsupported Storages



- [Box](https://www.box.com): No longer supported as it ignores dotfiles, see

  .



## Supported Applications



- [1Password 4](https://agilebits.com/onepassword)

- [2Do](http://www.2doapp.com/)

- [Ack](http://beyondgrep.com/)

- [act](https://github.com/nektos/act)

- [Adium](https://adium.im/)

- [Adobe Camera Raw](http://www.adobe.com/products/photoshop/extend.html)

- [Adobe Illustrator CC](https://www.adobe.com/products/illustrator.html)

- [Adobe Photoshop CC](http://www.adobe.com/products/photoshop.html)

- [Adobe Photoshop Lightroom CC](https://www.adobe.com/products/photoshop-lightroom.html)

- [Adobe Photoshop Lightroom Classic](https://www.adobe.com/de/products/photoshop-lightroom-classic.html)

- [aerc](https://aerc-mail.org/)

- [AeroSpace](https://github.com/nikitabobko/AeroSpace)

- [Affinity Designer](https://affinity.serif.com/designer)

- [Affinity Photo](https://affinity.serif.com/photo)

- [Affinity Publisher](https://affinity.serif.com/publisher)

- [Airflow](https://airflowapp.com/)

- [Airmail](http://airmailapp.com/)

- [Akamai-CLI](https://developer.akamai.com/cli)

- [Alacritty](https://github.com/jwilm/alacritty)

- [AltTab](https://alt-tab-macos.netlify.app/)

- [Amethyst](https://ianyh.com/amethyst/)

- [Ancient Domains of Mystery](http://www.adom.de/home/index.html)

- [Android Studio](https://developer.android.com/sdk/)

- [Ansible](http://www.ansible.com/)

- [AppCleaner](http://freemacsoft.net/appcleaner/)

- [AppCode](http://www.jetbrains.com/objc/)

- [Apple Music](https://www.apple.com/apple-music/)

- [Apptivate](http://www.apptivateapp.com/)

- [Arara](https://github.com/cereda/arara)

- [aria2c](http://aria2.sourceforge.net/)

- [Arm](https://www.atagar.com/arm/)

- [Artistic Style](http://astyle.sourceforge.net)

- [asciinema](https://asciinema.org/)

- [asdf version manager](https://github.com/asdf-vm/asdf)

- [Aspell](http://aspell.net/)

- [Atlantis](http://www.riverdark.net/atlantis/)

- [Atom](https://atom.io/)

- [Audacious](http://audacious-media-player.org/)

- [AusKey](https://abr.gov.au/AUSkey/)

- [Autokey](https://code.google.com/p/autokey/)

- [Awareness](http://iamfutureproof.com/tools/awareness/)

- [AWS Command Line Interface](https://aws.amazon.com/cli/)

- [ActivityWatch](http://activitywatch.net/)

- [Bartender](http://www.macbartender.com/)

- [Bash it](https://github.com/Bash-it/bash-it)

- [Bash](http://www.gnu.org/software/bash/)

- [Base](https://menial.co.uk/base/)

- [Bat](https://github.com/sharkdp/bat)

- [Bc](https://www.gnu.org/software/bc/)

- [Beatport Pro](https://www.beatport.com/desktop)

- [Beets](http://beets.io/)

- [BetterSnapTool](http://www.boastr.net/)

- [BetterTouchTool](http://www.boastr.net/)

- [Beyond Compare](https://scootersoftware.com/)

- [BibDesk](http://bibdesk.sourceforge.net/)

- [Billings Pro Server Admin](https://www.marketcircle.com/billingspro/download/billingspro-server/)

- [BitBar](https://getbitbar.com/)

- [Bitchx](http://www.bitchx.org/)

- [Blackfire](https://blackfire.io/)

- [Blender](https://blender.org/)

- [Boto](https://github.com/boto/boto)

- [Boxer](http://boxerapp.com)

- [Brackets](http://brackets.io/)

- [Brave](https://brave.com/)

- [Btop](https://github.com/aristocratos/btop)

- [Bump](https://github.com/fabiospampinato/bump)

- [Bundler](http://bundler.io)

- [Byobu](http://byobu.co/)

- [Caffeine](http://lightheadsw.com/caffeine/)

- [Calibre](https://calibre-ebook.com/)

- [Capture One](http://www.phaseone.com/Imaging-Software/Capture-One.aspx)

- [Cartographica](https://www.macgis.com/)

- [Cerebro](https://cerebroapp.com/)

- [Charles](http://www.charlesproxy.com)

- [Cheat](https://github.com/chrisallenlane/cheat)

- [Chef](https://www.chef.io/chef/)

- [Chicken](http://sourceforge.net/projects/chicken/)

- [Choosy](https://www.choosyosx.com/)

- [chunkwm](https://github.com/koekeishiya/chunkwm)

- [Cider](https://github.com/msanders/cider)

- [ClashX](https://github.com/yichengchen/clashX)

- [Clasp](https://github.com/google/clasp)

- [CleanShot](https://cleanshot.com/)

- [Clementine](https://www.clementine-player.org/)

- [CLion](https://www.jetbrains.com/clion/)

- [ClipMenu](http://www.clipmenu.com/)

- [Clipy](https://clipy-app.com/)

- [CloudApp](http://getcloudapp.com/)

- [Coda 2](http://panic.com/coda/)

- [Colloquy](http://colloquy.info/)

- [ColorSchemer Studio 2](http://www.colorschemer.com/osx_info.php)

- [ColorSlurp](http://colorslurp.com/)

- [ColorSync](https://en.wikipedia.org/wiki/ColorSync)

- [Composer](https://getcomposer.org/)

- [Concentrate](http://www.getconcentrating.com/)

- [Conky](https://github.com/brndnmtthws/conky)

- [Consular](https://github.com/achiu/consular)

- [Contexts](https://contexts.co)

- [ControlPlane](http://www.controlplaneapp.com/)

- [CopyQ](https://github.com/hluk/CopyQ)

- [CoRD](http://cord.sourceforge.net/)

- [CotEditor](http://coteditor.com/)

- [Ctags](http://ctags.sourceforge.net/)

- [Cursor](https://cursor.sh/)

- [cVim](https://github.com/1995eaton/chromium-vim)

- [Cyberduck](https://cyberduck.io/)

- [DaisyDisk](https://daisydiskapp.com)

- [DataGrip](https://www.jetbrains.com/datagrip/)

- [Dash](https://kapeli.com/dash)

- [Day-O](http://www.shauninman.com/archive/2011/10/20/day_o_mac_menu_bar_clock)

- [DBeaver](https://dbeaver.io/)

- [DbVisualizer](https://www.dbvis.com/)

- [Deal Alert](http://dealalertapp.com/)

- [Deepin-dde-dock](https://github.com/linuxdeepin/dde-dock)

- [Deepin-dde-file-manager](https://www.deepin.org/en/original/dde-file-manager/)

- [Deepin-Terminal](https://github.com/linuxdeepin/deepin-terminal)

- [Default Folder X](http://www.stclairsoft.com/DefaultFolderX/)

- [Devil's Pie 2](http://www.gusnan.se/devilspie2/)

- [Devil's Pie]()

- [dig]()

- [Divvy](http://mizage.com/divvy/)

- [Docker](https://www.docker.com/)

- [Dolphin](https://dolphin-emu.org/)

- [Doom Emacs](https://github.com/hlissner/doom-emacs)

- [Double Commander](http://doublecmd.sourceforge.net/)

- [Doxie](http://www.getdoxie.com/)

- [Dozer](https://github.com/Mortennn/Dozer)

- [Draft](https://draft.sh/)

- [Droplr](https://droplr.com/)

- [Dropzone 3](https://aptonic.com/dropzone3/)

- [Drush](http://www.drush.org/)

- [Eagle (ogdesign)](https://eagle.cool/)

- [EditorConfig](http://editorconfig.org/)

- [Electrum](https://electrum.org/#home)

- [Elgato StreamDeck](https://www.elgato.com/en/welcome-to-stream-deck)

- [Emacs](http://www.gnu.org/software/emacs/)

- [Enjoyable](https://yukkurigames.com/enjoyable/)

- [Environmental Station Alpha](http://www.hempuli.com/esa/)

- [eqMac2](https://bitgapp.com/eqmac/)

- [ESLint](https://eslint.org/)

- [espanso](https://espanso.org)

- [Exercism](http://exercism.io/)

- [ExpanDrive](http://www.expandrive.com/)

- [Factorio](https://www.factorio.com)

- [Fantastical](http://flexibits.com/fantastical)

- [fasd](https://github.com/clvv/fasd)

- [fastlane](https://fastlane.tools)

- [FastScripts](https://redsweater.com/fastscripts/)

- [Feeds](http://www.feedsapp.com/)

- [FileZilla](https://filezilla-project.org/)

- [Finicky](https://github.com/johnste/finicky)

- [Fish](http://fishshell.com/)

- [Fisher](https://github.com/jorgebucaran/fisher)

- [Flake8](https://flake8.pycqa.org/)

- [Flameshot](https://flameshot.org)

- [FlexGet](http://flexget.com/)

- [Flux](https://justgetflux.com/)

- [Focus](https://heyfocus.com)

- [Fontconfig](https://www.freedesktop.org/wiki/Software/fontconfig/)

- [FontExplorer X](http://www.fontexplorerx.com/)

- [Forge](http://www.slightlymagic.net/wiki/Forge)

- [Fork](https://git-fork.com/)

- [ForkLift](http://www.binarynights.com/forklift/)

- [Franz](https://meetfranz.com)

- [Gas Mask](https://github.com/2ndalpha/gasmask/)

- [gdb](https://www.gnu.org/software/gdb/)

- [Gear Player](https://www.gearmusicplayer.com/)

- [GeekTool](http://projects.tynsoe.org/en/geektool/)

- [GHCi](https://wiki.haskell.org/GHC/GHCi)

- [Ghidra](https://ghidra-sre.org)

- [Ghostwriter](https://wereturtle.github.io/ghostwriter/)

- [Gimp](https://www.gimp.org/)

- [Git Hooks](https://github.com/git-hooks/git-hooks)

- [Git](http://git-scm.com/)

- [Gitbox](http://gitboxapp.com/)

- [GitFox](https://www.gitfox.app)

- [GitKraken](https://www.gitkraken.com)

- [GitUp](http://gitup.co/)

- [Gmail Notifr](http://ashchan.com/projects/gmail-notifr)

- [GMVault](http://gmvault.org/)

- [Gnome SSH Tunnel Manager](http://sourceforge.net/projects/gstm/)

- [GnuPG](https://www.gnupg.org/)

- [Go2Shell](http://zipzapmac.com/Go2Shell)

- [Goku](https://github.com/yqrashawn/GokuRakuJoudo)

- [GoLand](https://www.jetbrains.com/go/)

- [Goldendict](http://goldendict.org/)

- [GoodSync](https://goodsync.com/)

- [GoShare](https://github.com/dictget/goshare)

- [Gradle](http://gradle.org)

- [GrandTotal 3](http://www.mediaatelier.com/GrandTotal4/)

- [grsync](http://www.opbyte.it/grsync/)

- [Hammerspoon](http://www.hammerspoon.org/)

- [HandBrake](https://handbrake.fr/)

- [Hands Off!](http://www.oneperiodic.com/products/handsoff/)

- [Hazel](http://www.noodlesoft.com/hazel.php)

- [Hero Lab](http://www.wolflair.com/index.php?context=hero_lab)

- [Heroku](https://www.heroku.com/)

- [HexChat](https://hexchat.github.io/)

- [Hexels](http://hexraystudios.com/hexels/)

- [Hocus Focus](http://hocusfoc.us/)

- [Homebridge](https://github.com/nfarina/homebridge)

- [Homebrew](https://brew.sh)

- [Houdini](http://uglyapps.co.uk/houdini/)

- [Hstr](https://github.com/dvorka/hstr)

- [Htop](http://htop.sourceforge.net/)

- [HTTPie](https://httpie.org/)

- [hub](https://hub.github.com)

- [Hyper.app](https://hyper.is/)

- [HyperDock](https://bahoom.com/hyperdock)

- [HyperSwitch](https://bahoom.com/hyperswitch)

- [i2cssh](https://github.com/wouterdebie/i2cssh)

- [i3](https://i3wm.org/)

- [IDA Pro](https://www.hex-rays.com/products/ida/)

- [IdeaVim](https://github.com/JetBrains/ideavim)

- [IINA](https://iina.io)

- [Inkscape](https://inkscape.org/)

- [Insomnia](https://insomnia.rest/)

- [IntelliJIDEA](http://www.jetbrains.com/idea/)

- [IPython](http://ipython.org/)

- [Irssi](http://www.irssi.org/)

- [iStat Menus](https://bjango.com/mac/istatmenus/)

- [Itsycal](https://github.com/sfsam/Itsycal)

- [iTerm2](https://www.iterm2.com/)

- [iTermocil](https://github.com/TomAnthony/itermocil)

- [iTunes Scripts](https://www.apple.com/)

- [JankyBorders](https://github.com/FelixKratz/JankyBorders)

- [Janus](https://github.com/carlhuda/janus)

- [Jitouch](http://www.jitouch.com/)

- [Joplin](https://joplinapp.org/)

- [jrnl](https://jrnl.sh)

- [JS Beautifier](https://github.com/beautify-web/js-beautify)

- [JSHint](http://jshint.com/)

- [Julia](http://julialang.org)

- [Jumpcut](http://jumpcut.sourceforge.net/)

- [Jupyter](http://jupyter.org/)

- [k9s](https://k9scli.io/)

- [Kaggle](https://kaggle.com/)

- [Kaleidoscope](http://www.kaleidoscopeapp.com/)

- [Karabiner Elements](https://github.com/tekezo/Karabiner-Elements)

- [Karabiner](https://pqrs.org/osx/karabiner/)

- [Kdenlive](https://kdenlive.org/)

- [KeePassX](http://www.keepassx.org/)

- [KeePassXC](https://keepassxc.org/)

- [KeepingYouAwake](https://github.com/newmarcel/KeepingYouAwake)

- [Keka](http://www.kekaosx.com/en/)

- [Keybase](https://keybase.io/)

- [Keyboard Maestro](http://www.keyboardmaestro.com)

- [Keymo](http://manytricks.com/keymo/)

- [KeyRemap4MacBook](https://pqrs.org/osx/karabiner/)

- [Khd](https://github.com/koekeishiya/khd/)

- [kitty](https://sw.kovidgoyal.net/kitty/)

- [Krew](https://github.com/kubernetes-sigs/krew)

- [Kubectl](https://kubernetes.io/docs/reference/kubectl/overview/)

- [Kwm](https://koekeishiya.github.io/kwm/)

- [LaTeXiT](http://www.chachatelier.fr/latexit/latexit-home.php?lang=en)

- [LaunchBar](https://www.obdev.at/products/launchbar/index.html)

- [lazygit](https://github.com/jesseduffield/lazygit)

- [Ledger](http://ledger-cli.org)

- [lf](https://github.com/gokcehan/lf)

- [LibreOffice](https://www.libreoffice.org/)

- [Liftoff](https://github.com/thoughtbot/liftoff)

- [Light Table](http://lighttable.com/)

- [LimeChat](http://limechat.net/mac/)

- [Liquid Prompt](https://github.com/nojhan/liquidprompt)

- [LittleSnitch](http://www.obdev.at/products/littlesnitch/)

- [Livestreamer](http://livestreamer.tanuki.se/)

- [Logitech Options](https://www.logitech.com/en-us/product/options)

- [Logseq](https://logseq.com/)

- [Lollypop](https://gnumdk.github.io/lollypop-web/)

- [Loopback](https://rogueamoeba.com/loopback/)

- [Luftrausers](http://luftrausers.com)

- [LunarVim](https://www.lunarvim.org/)

- [MacDive](http://www.mac-dive.com/)

- [MacDown](http://macdown.uranusjr.com/)

- [MacOSX](http://www.apple.com/osx/)

- [MacVim](https://github.com/macvim-dev/macvim)

- [Magic Launch](https://www.oneperiodic.com/products/magiclaunch/)

- [MagicPrefs](http://magicprefs.com/)

- [Magnet](https://magnet.crowdcafe.com/)

- [Maid](https://github.com/benjaminoakes/maid/)

- [Mail](https://support.apple.com/guide/mail/welcome/mac)

- [Mailmate](http://freron.com/)

- [Mailplane](http://mailplaneapp.com/)

- [mako](https://wayland.emersion.fr/mako/)

- [Marked 2](http://marked2app.com)

- [Marta](https://marta.yanex.org/)

- [MATLAB](http://www.mathworks.com/products/matlab/)

- [Maven](http://maven.apache.org)

- [Max](http://sbooth.org/Max/)

- [Mendeley Desktop](https://www.mendeley.com)

- [MenuMeters](http://www.ragingmenace.com/software/menumeters/)

- [Mercurial](https://www.mercurial-scm.org/)

- [MercuryMover](http://www.heliumfoot.com/mercurymover/)

- [Messages](http://www.apple.com/osx/apps/#messages)

- [Micro](https://github.com/zyedidia/micro)

- [Microsoft Azure CLI](https://github.com/Azure/azure-xplat-cli)

- [Microsoft Remote Desktop](https://itunes.apple.com/us/app/microsoft-remote-desktop-10/id1295203466)

- [mitmproxy](https://mitmproxy.org/)

- [mkcert](https://github.com/FiloSottile/mkcert)

- [MonoDevelop](http://www.monodevelop.com)

- [Moom](http://manytricks.com/moom/)

- [Mosaic](https://lightpillar.com/mosaic.html)

- [Mou](http://25.io/mou/)

- [mpd](http://www.musicpd.org)

- [MPlayerX](http://mplayerx.org)

- [MPS Youtube](https://github.com/mps-youtube/mps-youtube)

- [MPV](https://mpv.io/)

- [MTMR](https://github.com/Toxblh/MTMR)

- [Multitouch](https://multitouch.app/)

- [Mumu](https://getmumu.com)

- [MusicBrainz Picard](https://picard.musicbrainz.org/)

- [MuteSpotifyAds](https://github.com/simonmeusel/MuteSpotifyAds)

- [mycli](https://www.mycli.net/)

- [myrepos](https://github.com/joeyh/myrepos)

- [MySQL Workbench](https://www.mysql.com/products/workbench/)

- [MySQL](http://www.mysql.com/)

- [Name Mangler](http://manytricks.com/namemangler/)

- [Nano](http://www.nano-editor.org/)

- [Navicat](http://navicat.com/)

- [ncmpcpp](http://rybczak.net/ncmpcpp/)

- [Neofetch](https://github.com/dylanaraps/neofetch)

- [neovim](https://github.com/neovim/neovim)

- [Nethack](http://www.nethack.org)

- [Netlify](https://www.netlify.com/)

- [newsbeuter](http://newsbeuter.org/)

- [ngrok](https://ngrok.com/)

- [ni](https://github.com/antfu/ni/)

- [Nomacs](http://nomacs.org/)

- [NoSQLBooster for MongoDB](https://www.nosqlbooster.com/)

- [notion-enhancer](https://notion-enhancer.github.io/)

- [Nova](https://www.nova.app/)

- [npm](https://www.npmjs.com/)

- [npmrc](https://github.com/deoxxa/npmrc/)

- [NSLogger](https://github.com/fpillet/NSLogger)

- [nuget](https://www.nuget.org/)

- [Nushell](https://www.nushell.sh/)

- [nvALT](http://brettterpstra.com/projects/nvalt/)

- [nvm](https://github.com/nvm-sh/nvm)

- [nvpy](https://github.com/cpbotha/nvpy)

- [OBS](https://obsproject.com)

- [Oh My Fish](https://github.com/bpinto/oh-my-fish)

- [Oh My Tmux](https://github.com/gpakosz/.tmux)

- [OmniFocus](https://www.omnigroup.com/omnifocus/)

- [OmniGraffle](https://www.omnigroup.com/omnigraffle/)

- [Openbox](http://openbox.org)

- [OpenEmu](http://openemu.org)

- [OpenSSH](http://www.openssh.com/)

- [Oracle Cloud Infrastructure CLI](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/cliconcepts.htm)

- [Paintbrush](http://paintbrush.sourceforge.net/)

- [Pandoc](http://pandoc.org)

- [Pass](http://www.passwordstore.org/)

- [Pastebot](http://tapbots.com/software/pastebot/)

- [Path Finder](http://www.cocoatech.com/pathfinder/)

- [PDFjam](https://warwick.ac.uk/fac/sci/statistics/staff/academic-research/firth/software/pdfjam/)

- [Pear](http://pear.php.net/)

- [Pentadactyl](http://5digits.org/pentadactyl/)

- [Perl](https://www.perl.org/)

- [Phoenix](https://github.com/kasper/phoenix)

- [PhoneView](https://www.ecamm.com/mac/phoneview/)

- [PhpStorm](http://www.jetbrains.com/phpstorm/)

- [PicGo](https://github.com/Molunerfinn/PicGo)

- [Pidgin](https://www.pidgin.im)

- [PIP](http://www.pip-installer.org/)

- [PixelSnap](https://getpixelsnap.com/)

- [PixelSnap 2](https://getpixelsnap.com/)

- [Planner](https://useplanner.com/)

- [Pnpm](https://pnpm.js.org/)

- [Pock](https://pock.pigigaldi.com)

- [Poedit](http://poedit.net/)

- [Poetry](https://python-poetry.org)

- [PokerStars](https://www.pokerstars.com/)

- [Polybar](https://polybar.github.io/)

- [PopClip](http://pilotmoon.com/popclip/)

- [Popcorn-Time](https://popcorntime.io/)

- [PostgreSQL](http://www.postgresql.org/)

- [Postico](https://eggerapps.at/postico/)

- [Pow](http://pow.cx/)

- [Powerlevel10k](https://github.com/romkatv/powerlevel10k)

- [Powerline](https://github.com/powerline/powerline)

- [Powerline-shell](https://github.com/b-ryan/powerline-shell)

- [Prezto](https://github.com/sorin-ionescu/prezto)

- [Processing](https://processing.org/)

- [Proselint](https://github.com/amperser/proselint)

- [ProxyChains NG](http://sourceforge.net/projects/proxychains-ng/)

- [ProxyChains](http://proxychains.sourceforge.net)

- [Proxyman](https://proxyman.io)

- [PrusaSlicer](https://www.prusa3d.com/prusaslicer/)

- [PsySH](https://psysh.org/)

- [Punto Switcher](https://punto.yandex.ru/)

- [PyCharm](https://www.jetbrains.com/pycharm/)

- [PyPI](https://pypi.python.org/pypi)

- [PyRadio](http://www.coderholic.com/pyradio/)

- [Querious](http://www.araelium.com/querious/)

- [Quicksilver](http://qsapp.com/)

- [Quitter](https://marco.org/apps)

- [Qutebrowser](http://qutebrowser.org/)

- [Qv2ray](https://qv2ray.net/)

- [R](http://www.r-project.org/)

- [Rails](http://rubyonrails.org/)

- [Ranger](https://ranger.github.io/)

- [Rbenv](https://www.github.com/rbenv/rbenv)

- [Rclone](https://rclone.org/)

- [Rectangle](https://rectangleapp.com/)

- [Redshift Scheduler](https://github.com/spantaleev/redshift-scheduler)

- [Redshift](http://jonls.dk/redshift/)

- [Remote Desktop Manager](https://remotedesktopmanager.com/)

- [Rhythmbox](https://wiki.gnome.org/Apps/Rhythmbox)

- [Rime](http://rime.im/)

- [ripgrep](https://github.com/BurntSushi/ripgrep)

- [Robo 3T](http://robomongo.org/)

- [Rocket](https://matthewpalmer.net/rocket/)

- [Rofi](https://github.com/DaveDavenport/rofi)

- [Royal TSX](http://www.royaltsx.com/ts/osx/features)

- [RStudio](https://www.rstudio.com/)

- [rTorrent](http://libtorrent.rakshasa.no/)

- [rtx](https://github.com/jdx/rtx)

- [rubiTrack 5](https://www.rubitrack.com)

- [Rubocop](https://github.com/bbatsov/rubocop)

- [Ruby Version Manager](https://rvm.io/)

- [Ruby Version](https://gist.github.com/fnichol/1912050)

- [Ruby](https://www.ruby-lang.org/)

- [RubyMine](http://www.jetbrains.com/ruby/)

- [Rust](https://www.rust-lang.org/)

- [S3cmd](http://s3tools.org/s3cmd)

- [SABnzbd](http://sabnzbd.org/)

- [SBCL](http://www.sbcl.org/)

- [SBT](http://www.scala-sbt.org/)

- [Scenario](http://www.lagentesoft.com/scenario/)

- [Screen](http://www.gnu.org/software/screen/)

- [Screenhero](https://screenhero.com)

- [Scrivener](http://www.literatureandlatte.com/scrivener.php)

- [Scroll Reverser](https://pilotmoon.com/scrollreverser/)

- [SecureCRT](https://www.vandyke.com/products/securecrt/)

- [Secure Pipes](http://www.opoet.com/)

- [Seil](https://pqrs.org/osx/karabiner/seil.html.en)

- [SelfControl](http://selfcontrolapp.com/)

- [Sequel Pro](http://www.sequelpro.com/)

- [ShiftIt](https://github.com/fikovnik/ShiftIt)

- [Shifty](https://shifty.natethompson.io/)

- [Shimo](https://www.feingeist.io/shimo/)

- [ShowyEdge](https://pqrs.org/osx/ShowyEdge/index.html.en)

- [SHSH Blobs](https://en.wikipedia.org/wiki/SHSH_blob)

- [Shuttle](http://fitztrev.github.io/shuttle/)

- [SizeUp](http://www.irradiatedsoftware.com/sizeup/)

- [Sizzy](https://sizzy.co/)

- [SketchyBar](https://felixkratz.github.io/SketchyBar/)

- [skhd](https://github.com/koekeishiya/skhd/)

- [Skim](http://skim-app.sourceforge.net/)

- [Skitch](https://evernote.com/skitch/)

- [Slate](https://github.com/jigish/slate)

- [Slic3r](http://slic3r.org)

- [Slogger](http://brettterpstra.com/projects/slogger/)

- [SmartGit](http://www.syntevo.com/smartgit/)

- [Smooth Mouse](http://smoothmouse.com/)

- [Soulver](http://www.acqualia.com/soulver/)

- [SourceTree](https://www.sourcetreeapp.com/)

- [SpaceLauncher](https://spacelauncherapp.com)

- [Spacemacs](https://github.com/syl20bnr/spacemacs)

- [SpaceVim](https://github.com/SpaceVim/SpaceVim)

- [SpamSieve](https://c-command.com/spamsieve)

- [Spark](http://www.shadowlab.org/softwares/spark.php)

- [Spectacle](https://www.spectacleapp.com/)

- [Spectrwm](https://github.com/conformal/spectrwm/wiki)

- [Splice](https://splice.com/)

- [Spotify Notifications](http://spotify-notifications.citruspi.io/)

- [Spotify](https://www.spotify.com/)

- [Sqitch](https://sqitch.org/)

- [Starship](https://starship.rs/)

- [Startupizer2](http://appledoc.gentlebytes.com/startupizer/)

- [Stata](http://www.stata.com/)

- [Stats](https://github.com/exelban/stats)

- [Stay](https://cordlessdog.com/stay/)

- [Storyist](http://storyist.com/)

- [Subler](https://subler.org)

- [Sublime Merge](https://www.sublimemerge.com/)

- [Sublime Text](http://www.sublimetext.com/)

- [Subversion](http://subversion.apache.org/)

- [SuperDuper!](http://www.shirt-pocket.com/SuperDuper/SuperDuperDescription.html)

- [Surge](http://surge.run/manual/)

- [Sway](https://swaywm.org/)

- [Swinsian](http://swinsian.com/)

- [Swish](https://highlyopinionated.co/swish/)

- [SwitchHosts](https://github.com/oldj/SwitchHosts)

- [T](http://sferik.github.io/t/)

- [TablePlus](https://tableplus.io)

- [TaskPaper](https://www.taskpaper.com)

- [Taskwarrior](http://taskwarrior.org/)

- [Teamocil](https://github.com/remi/teamocil)

- [Telegram for macOS](https://macos.telegram.org)

- [Terminal](http://www.apple.com/osx/apps/)

- [Terminator](https://launchpad.net/terminator/)

- [termite](https://github.com/thestinger/termite)

- [Termux](https://termux.dev/)

- [TextExpander](https://smilesoftware.com/textexpander)

- [TextMate](http://macromates.com/)

- [Textual](http://www.codeux.com/textual/)

- [Tig](https://github.com/jonas/tig)

- [Tiles](https://www.sempliva.com/tiles/)

- [Tilix](https://github.com/gnunn1/tilix)

- [Timeout](https://www.dejal.com/timeout/)

- [tint2](https://code.google.com/p/tint2/)

- [TinyFugue](http://tinyfugue.sourceforge.net)

- [Tmux](http://tmux.sourceforge.net/)

- [Tmuxp](https://github.com/tony/tmuxp)

- [Tmuxinator](https://github.com/tmuxinator/tmuxinator)

- [Todo.txt CLI](http://todotxt.com/)

- [ToothFairy](https://c-command.com/toothfairy/)

- [TotalSpaces2](http://totalspaces.binaryage.com/)

- [Tower](http://www.git-tower.com/)

- [Transmission](http://www.transmissionbt.com/)

- [Transmit](http://panic.com/transmit/)

- [TripMode](https://www.tripmode.ch)

- [Trizen](https://github.com/trizen/trizen)

- [Tunnelblick](https://tunnelblick.net)

- [tvnamer](https://github.com/dbr/tvnamer)

- [Twitterrific](http://twitterrific.com/)

- [Typinator](http://www.ergonis.com/products/typinator/)

- [Typora](https://typora.io)

- [uTorrent](http://www.utorrent.com/)

- [ulauncher](https://ulauncher.io/)

- [Ventrilo](http://www.ventrilo.com/)

- [Verdaccio](https://verdaccio.org/)

- [Versions](http://www.versionsapp.com)

- [Vim](http://www.vim.org/)

- [Vimperator](http://www.vimperator.org/vimperator)

- [Viscosity](http://www.sparklabs.com/viscosity/)

- [Visual Studio Code](https://code.visualstudio.com/)

- [Visual Studio Code - Insiders](https://code.visualstudio.com/insiders)

- [Visual Studio Code - OSS](https://github.com/Microsoft/vscode)

- [VSCodium](https://vscodium.com/)

- [Visual Studio for Mac](https://www.visualstudio.com/vs/visual-studio-mac/)

- [VLC](http://www.videolan.org/)

- [Volt](https://github.com/vim-volt/volt)

- [Wakatime](https://wakatime.com/)

- [Warp](https://www.warp.dev)

- [waybar](https://github.com/Alexays/Waybar)

- [WebStorm](https://www.jetbrains.com/webstorm/)

- [WezTerm](https://wezfurlong.org/wezterm/)

- [Wget](https://www.gnu.org/software/wget/)

- [WhatsApp Web](https://web.whatsapp.com/)

- [Wireshark 2](https://www.wireshark.org)

- [Witch](http://manytricks.com/witch/)

- [WordGrinder](https://cowlark.com/wordgrinder/)

- [WordPress WP-CLI](http://wp-cli.org/)

- [Workrave](http://www.workrave.org/)

- [X11](http://www.x.org/)

- [Xee](https://theunarchiver.com/xee)

- [Xamarin Studio](https://xamarin.com/studio)

- [xbar](https://xbarapp.com/)

- [XBindKeys](http://www.nongnu.org/xbindkeys/)

- [Xchat](http://xchat.org/)

- [Xcode](https://developer.apple.com/xcode/)

- [XEmacs](http://www.xemacs.org/)

- [XLD](http://tmkk.undo.jp/xld/)

- [Xonsh](https://xon.sh)

- [XtraFinder](http://www.trankynam.com/xtrafinder/)

- [yabai](https://github.com/koekeishiya/yabai)

- [yarn](https://yarnpkg.com)

- [Yummy FTP](http://www.yummysoftware.com/)

- [zabbix-cli](https://github.com/usit-gd/zabbix-cli)

- [zathura](https://pwmt.org/projects/zathura/)

- [zed](https://zed.dev/)

- [Zoom](http://zoom.com/)

- [zoxide](https://github.com/ajeetdsouza/zoxide)

- [Zsh](http://zsh.sourceforge.net/)

- [Übersicht](http://tracesof.net/uebersicht/)



## Can you support application X



We can [with your help](doc#get-official-support-for-an-application) ;)



## Personalization & configuration



Have an application that shouldn't be generally supported but that you use?

Or a cool file you want to sync?



- Create a `~/.mackup` directory to [sync an application or any file or directory](doc#add-support-for-an-application-or-any-file-or-directory)



## Why did you do this



Yesterday, I had a talk with [Zach Zaro](http://zacharyzaro.com/), complaining

about the pain it is to reconfigure our Macbook each time we get a new one or

install from scratch. That's a talk we have already had months ago.



I change my workstation every X months. Each time I either lose my apps'

configurations, or I just waste a bunch of hours getting setup like I was on my

old box. I also spend a lot of time reconfiguring the same stuff again on all my

workstations (home, work).



Boring...



Some people tried to solve the problem on the application layer, like [Github's Boxen](https://boxen.github.com/),

but it solves a different problem, from my point of view. I don't spend a lot

of time installing or downloading stuff. I spend time configuring it.



For years, I've used a personal shell script that was copying known config

files into Subversion, Git or Dropbox, and linked them into my home. But I felt

a lot of us had the same problem: Making a more generic tool could help others

and I could get help from others to support more apps in the tool.



So here comes Mackup, the little tool that will sync all your application

configs to Dropbox (or Google Drive, or anything).



And it's [GPL](http://www.gnu.org/licenses/gpl.html), of course.



## What platforms are supported



- macOS

- GNU/Linux



## What's up with the weird name



Mackup is just a portmanteau of Mac and Backup. It is simple, short, and easy to

remember, and it corresponds with the whole idea of Mackup: the simpler – the better!

(And I suck at naming stuff, but who doesn't.)



## Where can I find more information



In the [doc](doc) directory.