README.md

lporg

Organize Your macOS Launchpad Apps

---

Why

This project is meant to help people setting up a brand new Mac or to keep all of their Launchpad Folders in sync across devices.

Features

• Load/Save Launchpad app and folder settings
• Load/Save Dock app ordering settings
• Set desktop background image from URL/path in config

Tested On

• macOS 10.12 (Sierra)
• macOS 10.13.2 (High Sierra)
• macOS 10.13.3 (High Sierra)
• macOS 14.0 (Sonoma)

Install

$ brew install blacktop/tap/lporg

Getting Started

❯ lporg

Organize Your Launchpad

Usage:
  lporg [command]

Available Commands:
  default     Organize by default Apple app categories
  help        Help about any command
  load        Load launchpad settings config from `FILE`
  revert      Revert to launchpad settings backup
  save        Save current launchpad settings
  version     Print the version number of lporg

Flags:
  -c, --config string   config file (default is $CONFIG/lporg/config.yaml)
  -h, --help            help for lporg
      --icloud          use iCloud for config
  -V, --verbose         verbose output

Use "lporg [command] --help" for more information about a command.

Commands

Default

$ lporg default

Organize your launchpad apps using the default Apple app categories as folders

Save

$ lporg save

Save your current launchpad app layout to a lporg.yml file

Load

$ lporg load lporg.yml

Load a launchpad app layout from a YAML config file

Revert

$ lporg revert

Revert a launchpad app layout to the backed up version stored at $CONFIG/lporg/config.yml

Example Configs

• lporg.yml

TODO

• create Brewfile from unfound apps IF they are installable via brew?
• add ability to save/load private gist configs
• add ability to have desktop image be a URL and it will download and check sha256, save in .lporg folder and add to desktop

Issues

Find a bug? Want more features? Find something missing in the documentation? Let me know! Please don't hesitate to file an issue

License

MIT Copyright (c) 2017-2023 blacktop