https://github.com/blacktop/lporg
Organize Your macOS Launchpad Apps
https://github.com/blacktop/lporg
backup golang launchpad launchpad-apps macos organizer osx provisioning
Last synced: 5 months ago
JSON representation
Organize Your macOS Launchpad Apps
- Host: GitHub
- URL: https://github.com/blacktop/lporg
- Owner: blacktop
- License: mit
- Created: 2017-12-22T03:49:28.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2025-03-10T19:42:30.000Z (7 months ago)
- Last Synced: 2025-04-19T12:39:56.609Z (6 months ago)
- Topics: backup, golang, launchpad, launchpad-apps, macos, organizer, osx, provisioning
- Language: Go
- Size: 6.03 MB
- Stars: 365
- Watchers: 9
- Forks: 25
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# lporg
[](https://github.com/blacktop/lporg/actions) [](https://github.com/blacktop/lporg/releases) [](https://github.com/blacktop/lporg/releases) [](http://doge.mit-license.org)
> 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
```sh
brew install blacktop/tap/lporg
```
## Getting Started
```sh
❯ 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
```sh
lporg default
```
Organize your launchpad apps using the default Apple app categories as folders
### Save
```sh
lporg save
```
Save your current launchpad app layout to a `lporg.yml` file
### Load
```sh
lporg load lporg.yml
```
Load a launchpad app layout from a YAML config file
### Revert
```sh
lporg revert
```
Revert a launchpad app layout to the backed up version stored at `$CONFIG/lporg/config.yml`
### Example Configs
- [lporg.yml](https://github.com/blacktop/dotfiles/blob/master/init/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](https://github.com/blacktop/lporg/issues/new)
## License
MIT Copyright (c) 2017-2024 **blacktop**