/lporg

Organize Your macOS Launchpad Apps

Primary LanguageGoMIT LicenseMIT

logo

lporg

Go Github All Releases License

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)

Install

$ brew install blacktop/tap/lporg

Getting Started

Usage: lporg [OPTIONS] COMMAND [arg...]

Organize Your Launchpad

Version: 18.02.04, BuildTime: 20180204
Author: blacktop - <https://github.com/blacktop>

Options:
  --verbose, -V  verbose output
  --icloud, -I   save config to iCloud Drive
  --help, -h     show help
  --version, -v  print the version

Commands:
  default  organize by default app categories
  save     save current launchpad settings
  load     load launchpad settings config from `FILE`
  revert   revert to launchpad settings backup
  help     Shows a list of commands or help for one command

Run 'lporg COMMAND --help' for more information on 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 launchpad.yaml file

Load

$ lporg load launchpad.yaml

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 $HOME/.launchpad.yml

Example Configs

TODO

  • create Brewfile from unfound apps IF they are installable via brew?
  • add ability to save/load JSON as well as YAML
  • add ability to save/load private gist configs
  • add ability to org dock as well dorg ? (in progress)
  • add ability to have desktop image be a URL and it will download and check sha256, save in .lporg folder and add to desktop
  • add ability to set multiple desktop images
  • add ability to save/load to/from iCloud Drive ~/Library/Mobile\ Documents/com~apple~CloudDocs
  • backup current launchpad layout before changing
  • write backup config to $HOME/.launchpad.yml
  • create a macOS VM to test on a much crazier collection of apps. See Issue #1

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-2022 blacktop