Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hazcod/maclaunch
Manage your macOS startup items.
https://github.com/hazcod/maclaunch
agent bash daemon launch loader mac macos osx startup
Last synced: 6 days ago
JSON representation
Manage your macOS startup items.
- Host: GitHub
- URL: https://github.com/hazcod/maclaunch
- Owner: hazcod
- License: mit
- Created: 2017-01-20T10:30:23.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-11-13T06:27:12.000Z (about 1 year ago)
- Last Synced: 2024-12-07T12:11:45.261Z (14 days ago)
- Topics: agent, bash, daemon, launch, loader, mac, macos, osx, startup
- Language: Shell
- Homepage:
- Size: 75.2 KB
- Stars: 308
- Watchers: 10
- Forks: 16
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-starred-test - hazcod/maclaunch - Manage your macOS startup items. (Shell)
README
# maclaunch
Lists and controls all your macOS startup items and their startup policy.
Take back control of your macOS system!
```shell
% maclaunch list microsoft
> com.microsoft.update.agent
Type : user
User : hazcod
Launch: disabled
File : /Library/LaunchAgents/com.microsoft.update.agent.plist
> com.microsoft.teams.TeamsUpdaterDaemon
Type : system
User : root
Launch: disabled
File : /Library/LaunchDaemons/com.microsoft.teams.TeamsUpdaterDaemon.plist
> com.microsoft.office.licensingV2.helper
Type : system
User : root
Launch: disabled
File : /Library/LaunchDaemons/com.microsoft.office.licensingV2.helper.plist
> com.microsoft.autoupdate.helper
Type : system
User : root
Launch: disabled
File : /Library/LaunchDaemons/com.microsoft.autoupdate.helper.plist
```
## How does it work?
maclaunch will list all types of entries on your macOS system that can be persistently installed:
1. Configuration files for LaunchAgents and LaunchDaemons which are loaded by launchctl.
2. Kernel extensions loaded in the kernel.
3. System extensions loaded in userspace.
4. Login or Logout Hooks
5. emon.d scripts
6. Cron scripts
When disabling an item, it uses `launchctl`, `kextutil` or `systemextensionsctl` to natively stop loading that service.
It does **not** alter the contents in any way or moves the file, so it should work with practically any service.
The name you provide can either be specific to that service or function as a filter to work on multiple services simultaneously.
By default it hides system startup items which are most likely not interesting, but you can set the environment variable `ML_SYSTEM=1` to show those.
## Installation
Installation can be done straight from Homebrew via `brew install maclaunch` or just copy `maclaunch.sh` to your filesystem.
## Usage
`Usage: maclaunch (filter|system)`
To list all your services: `maclaunch list`
To list all enabled services: `maclaunch list enabled`
To list all enabled services, ignoring internal ones: `ML_SYSTEM=no maclaunch list enabled`
To list all disabled services: `maclaunch list disabled`
To list all your services including system services: `maclaunch list system`
To list all microsoft services: `maclaunch list microsoft`
To enable plex player-helper: `maclaunch enable tv.plex.player-helper`
To disable everything related to plex: `maclaunch disable plex`