lporg

README

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

Documentation

Overview

Copyright © 2023 blacktop

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.