Skip to content
master
Go to file
Code

Latest commit

Files

Permalink
Failed to load latest commit information.

README.md

Outset

Outset is a script which automatically processes packages, profiles, and scripts during the boot sequence, user logins, or on demand.

Note: Version 3.0 requires python3. If you wish to continue using Outset with Apple's system python2, you should use the Outset 2.0.6 release. However, at some point in the not-too-distant future, Apple is going to remove python completely from macOS, and you'll need to roll your own python3 to be able to use Outset.

Options for installing python3:

  1. Install the pkg downloaded directly from python.org.
  2. Install Apple's CL Tools (either by downloading the pkg from Apple's developer site, or by invoking the shim at /usr/bin/python3).
  3. Build your own copy of python (E.g. Greg Neagle's relocatable python tools). You'll need to ensure that this custom python is the default python in your $PATH.

Requirements

  • python 3.7+
  • It's only been tested on 10.15.x and above

Usage

usage: outset [-h]
			(--boot | --login | --login-privileged | --on-demand | --login-every | --login-once | --cleanup | --version | --add-ignored-user username | --remove-ignored-user username | --add-override scripts | --remove-override scripts)

This script automatically processes packages, profiles, and/or scripts at
boot, on demand, and/or login.

optional arguments:
-h, --help            show this help message and exit
--boot                Used by launchd for scheduled runs at boot
--login               Used by launchd for scheduled runs at login
--login-privileged    Used by launchd for scheduled privileged runs at login
--on-demand           Process scripts on demand
--login-every         Manually process scripts in login-every
--login-once          Manually process scripts in login-once
--cleanup             Used by launchd to clean up on-demand dir
--version             Show version number
--add-ignored-user username
						Add user to ignored list
--remove-ignored-user username
						Remove user from ignored list
--add-override scripts
						Add scripts to override list
--remove-override scripts
						Remove scripts from override list

See the wiki for info on how to use Outset.

Credits

This script was an excuse for me to try to learn python. I learn best when I can pull apart existing scripts. As such, this script is heavily based on the great work by Nate Walck, Allister Banks, Rich Trouton, Graham Gilbert, and Greg Neagle.

License

Copyright 2020 Joseph Chilcote

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

About

Automatically process packages, profiles, and scripts during boot, login, or on demand.

Topics

Resources

You can’t perform that action at this time.