mirror of
https://github.com/jamf/Setup-Manager.git
synced 2026-02-06 15:22:18 +00:00
Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
6ea7365dc0 | ||
|
|
640672b945 | ||
|
|
035796c035 |
1
.gitignore
vendored
Normal file
1
.gitignore
vendored
Normal file
@@ -0,0 +1 @@
|
||||
.DS_Store
|
||||
161
ChangeLog.md
161
ChangeLog.md
@@ -1,72 +1,81 @@
|
||||
# Setup Manager - Change Log
|
||||
|
||||
## v1.0
|
||||
(2024-07-01)
|
||||
|
||||
- updated to new Jamf Concepts Use Agreement
|
||||
- updated German and Swedish localizations
|
||||
- added name for macOS 15
|
||||
- new `hideActionLabels` and `hideDebugLabel` keys
|
||||
- 'Jamf ID' is now only visible in the extended 'About this Mac' View (reachable when holding the option key)
|
||||
- messaging when Setup Manager is launched in user space or with missing configuration
|
||||
- UI tweaks
|
||||
|
||||
## v1.0RC
|
||||
|
||||
(2024-03-11)
|
||||
|
||||
- various minor fixes to localization, documentation, and small UI tweaks (#128)
|
||||
- better error handling and display for some edge cases (#52, #53, #120)
|
||||
- added ReadMe and License to installer pkg (#126)
|
||||
- various minor fixes to localization, documentation, and small UI tweaks
|
||||
- better error handling and display for some edge cases
|
||||
- added ReadMe and License to installer pkg
|
||||
|
||||
## v0.9.1
|
||||
|
||||
(2023-11-20)
|
||||
|
||||
- Norwegian and Swedish localizations, thanks to Sam Wennerlund (#111, #112)
|
||||
- refactored process launching code, this should help with some stalling issues (#95)
|
||||
- shutdown button should not stall anymore (#118)
|
||||
- Setup Manager now caches the defaults at launch. This makes it more resilient to its configuration profile "disappearing" because the computer is not scope. (We still recommend scoping the Setup Manager Configuration profile as well as adding it to the Prestage.) This also addresses the custom UI "flickering" while it runs. (#99, setup-manager/setup-manager#21)
|
||||
|
||||
- Norwegian and Swedish localizations, thanks to Sam Wennerlund
|
||||
- refactored process launching code, this should help with some stalling issues
|
||||
- shutdown button should not stall anymore
|
||||
- Setup Manager now caches the defaults at launch. This makes it more resilient to its configuration profile "disappearing" because the computer is not scope. (We still recommend scoping the Setup Manager Configuration profile as well as adding it to the Prestage.) This also addresses the custom UI "flickering" while it runs. (#21)
|
||||
|
||||
## v0.9
|
||||
|
||||
(2023-10-26)
|
||||
|
||||
- Help button
|
||||
- new key `help` shows a help button (circled question mark) in the lower right corner. The "Continue" and/or "Shutdown" buttons will replace the "Help" when the appear (#113)
|
||||
- new key `help` shows a help button (circled question mark) in the lower right corner. The "Continue" and/or "Shutdown" buttons will replace the "Help" when the appear
|
||||
- see [Configuration Profile documentation](ConfigurationProfile.md#help) for more detail
|
||||
- "About this Mac" info window
|
||||
- now shows network connection status. (#116) With the option key, the info window shows the interface name (#90) and IP address (#106)
|
||||
- to keep the info window clean, some (more) items are now only shown when opening the info window while holding option keys (#115) (Jamf Pro and Setup Manager version)
|
||||
- updated Installomator to v10.5 (#107)
|
||||
- added new defaults key `overrideSerialNumber` to display a preset serial number (#100), this is useful for creating screenshots or recordings
|
||||
- main window is not resizable (#103, setup-manager/setup-manager#26)
|
||||
- user entry with options menu would be empty unless manually set (#110, setup-manager/setup-manager#23)
|
||||
- item progress indicators are now more distinct (#109, setup-manager/setup-manager#25)
|
||||
- added "Powered by Jamf" and icon in button bar (#117)
|
||||
- Setup Manager rearranges windows properly when a screen is attached or removed (#105)
|
||||
- now shows network connection status. With the option key, the info window shows the interface name and IP address
|
||||
- to keep the info window clean, some (more) items are now only shown when opening the info window while holding option keys (Jamf Pro and Setup Manager version)
|
||||
- updated Installomator to v10.5
|
||||
- added new defaults key `overrideSerialNumber` to display a preset serial number, this is useful for creating screenshots or recordings
|
||||
- main window is not resizable (#26)
|
||||
- user entry with options menu would be empty unless manually set (#23)
|
||||
- item progress indicators are now more distinct (#25)
|
||||
- added "Powered by Jamf" and icon in button bar
|
||||
- Setup Manager rearranges windows properly when a screen is attached or removed
|
||||
- app and pkg are now signed and notarized with Jamf Developer certificates
|
||||
- many more bug fixes and improvements (#98, #102)
|
||||
|
||||
- many more bug fixes and improvements
|
||||
|
||||
## v0.8.2
|
||||
|
||||
(2023-09-19)
|
||||
|
||||
- local files are now shown correctly with `icon` (#93)
|
||||
- download speed is shown in macOS Sonoma (#94)
|
||||
- fixed a strange race condition that led to large installomator installations stalling with Jamf School (#80)
|
||||
- 'Shutdown' button is now hidden by default, since it breaks some of the workflows (#25). You can unhide it by setting the `finalAction` key to `shutdown` (this will hide the continue button) or setting the `showBothButtons` key to `true` which will show both buttons.
|
||||
- local files are now shown correctly with `icon`
|
||||
- download speed is shown in macOS Sonoma
|
||||
- fixed a strange race condition that led to large installomator installations stalling with Jamf School
|
||||
- 'Shutdown' button is now hidden by default, since it breaks some of the workflows. You can unhide it by setting the `finalAction` key to `shutdown` (this will hide the continue button) or setting the `showBothButtons` key to `true` which will show both buttons.
|
||||
|
||||
|
||||
## v0.8
|
||||
|
||||
(2023-09-05)
|
||||
|
||||
- Italian and Spanish localizations (Thanks to Nicola Lecchi, Andre Vilja and Javier Tetuan) (#71, #85)
|
||||
- fixed crashing bug when `background` is set (#73)
|
||||
- 'Save Button' in User Entry now enables properly (#76)
|
||||
- UI layout improvements (#74, #75, #88)
|
||||
- main `icon` now properly displays wide aspect images (#82)
|
||||
- watchPath actions time faster in DEBUG mode (#70)
|
||||
- unloads Jamf Pro background check-in during workflow (#81)
|
||||
- Italian and Spanish localizations (Thanks to Nicola Lecchi, Andre Vilja and Javier Tetuan)
|
||||
- fixed crashing bug when `background` is set
|
||||
- 'Save Button' in User Entry now enables properly
|
||||
- UI layout improvements
|
||||
- main `icon` now properly displays wide aspect images
|
||||
- watchPath actions time faster in DEBUG mode
|
||||
- unloads Jamf Pro background check-in during workflow
|
||||
- About this Mac…
|
||||
- downloand speed (measured with `networkQuality`) and esitmated download time (#84)
|
||||
- Jamf Pro version (#43)
|
||||
- downloand speed (measured with `networkQuality`) and esitmated download time
|
||||
- Jamf Pro version
|
||||
- new preference keys (see [config profile documentation for details](ConfigurationProfile.md))
|
||||
- `accentColor` (#83)
|
||||
- `totalDownloadBytes` (#91)
|
||||
- `userEntry.showForUserIDs` (#87)
|
||||
- `accentColor`
|
||||
- `totalDownloadBytes`
|
||||
- `userEntry.showForUserIDs`
|
||||
|
||||
## v0.7.1
|
||||
|
||||
@@ -82,25 +91,25 @@
|
||||
|
||||
- added macOS Sonoma to list of known macOS releases
|
||||
- added documentation for Jamf School
|
||||
- added changelog and some more updates to documentation (#68, #67)
|
||||
- computer name can now be generated wihtout UI from a template (#8, #69)
|
||||
- added changelog and some more updates to documentation
|
||||
- computer name can now be generated wihtout UI from a template
|
||||
- added slight scale animation and edge fade to action list
|
||||
- user entry fields can now be validated with a regular expression and localized message (#6, #7)
|
||||
- battery widget now display correctly on Macs without a battery (#66)
|
||||
- user entry fields can now be validated with a regular expression and localized message
|
||||
- battery widget now display correctly on Macs without a battery
|
||||
|
||||
## v0.6
|
||||
|
||||
(2023-06-05)
|
||||
|
||||
- launchd plist is now removed when app launches and flag file is present. This will prevent further accidental restarts after the app has been re-installed (#54)
|
||||
- improved logging when parsing an action fails (#55)
|
||||
- added Pendo integration to track app launches (#57, #58)
|
||||
- hitting cmd-L multiple times would open multiple log windows (#61)
|
||||
- log window now auto-scrolls to latest entry (#62)
|
||||
- command-W no longer closes main window (#63)
|
||||
- launchd plist is now removed when app launches and flag file is present. This will prevent further accidental restarts after the app has been re-installed
|
||||
- improved logging when parsing an action fails
|
||||
- added Pendo integration to track app launches
|
||||
- hitting cmd-L multiple times would open multiple log windows
|
||||
- log window now auto-scrolls to latest entry
|
||||
- command-W no longer closes main window
|
||||
- added French localization
|
||||
- fixed some typos in Dutch localization
|
||||
- Warning screen appears when battery drops below 20% (#37, #38) and disappears when charger is connected
|
||||
- Warning screen appears when battery drops below 20% and disappears when charger is connected
|
||||
- you can show/hide battery status with cmd-B
|
||||
- updated built-in Installomator to v10.4
|
||||
- fixed some logic errors in the Jamf Pro workflow that were introduced when adding Jamf School support
|
||||
@@ -109,9 +118,9 @@
|
||||
|
||||
(2023-05-09)
|
||||
|
||||
- should now support Jamf School, this required major changes throughout the code, please test everything, also on Jamf Pro (#47, #48)
|
||||
- added installomator as an option for actions (mostly for Jamf School, but this also works with Jamf Pro) (#49)
|
||||
- changed packaging script so that Jamf School can parse the pkg (#46)
|
||||
- should now support Jamf School, this required major changes throughout the code, please test everything, also on Jamf Pro
|
||||
- added installomator as an option for actions (mostly for Jamf School, but this also works with Jamf Pro)
|
||||
- changed packaging script so that Jamf School can parse the pkg
|
||||
- while rebuilding everything found a few edge cases that weren't handled very well
|
||||
- holding the option key when clicking "About this Mac…" will now show some extra info (want to add more data there going forward)
|
||||
- added SwiftLint to the project
|
||||
@@ -120,42 +129,42 @@
|
||||
|
||||
(2023-04-05)
|
||||
|
||||
- disk size is shown in "About this Mac…" (#30)
|
||||
- display and Mac will not sleep during installations (#28)
|
||||
- Setup Manager will ignore non-managed enrollmentActions when not in Debug mode (#32)
|
||||
- Setup Manager shows when Debug mode is enabled (#39)
|
||||
- command-Q no longer quits the app (you can use shift-control-command-E) instead (#29)
|
||||
- disk size is shown in "About this Mac…"
|
||||
- display and Mac will not sleep during installations
|
||||
- Setup Manager will ignore non-managed enrollmentActions when not in Debug mode
|
||||
- Setup Manager shows when Debug mode is enabled
|
||||
- command-Q no longer quits the app (you can use shift-control-command-E) instead
|
||||
|
||||
## v0.3
|
||||
|
||||
(2023-03-10)
|
||||
|
||||
- localization (English, German, Dutch)
|
||||
- DEBUG mode now does something (#10)
|
||||
- added flag requiresRoot to shell action (#42)
|
||||
- Prerequisites now wait for Jamf keychain (#41)
|
||||
- About this Mac info should work for Intel Macs (#41)
|
||||
- Connected Shutdown button (#1)
|
||||
- Setup Manager creates a flag file at /private/var/db/.JamfSetupEnrollmentDone when it finishes. (#2)
|
||||
- when this file exists when Setup Manager launches, the app will terminate immediately and do nothing. (#3)
|
||||
- new defaults key finalCountdown which automatically continues (or shuts down) after a timer (#27)
|
||||
- DEBUG mode now does something
|
||||
- added flag requiresRoot to shell action
|
||||
- Prerequisites now wait for Jamf keychain
|
||||
- About this Mac info should work for Intel Macs
|
||||
- Connected Shutdown button
|
||||
- Setup Manager creates a flag file at /private/var/db/.JamfSetupEnrollmentDone when it finishes
|
||||
- when this file exists when Setup Manager launches, the app will terminate immediately and do nothing.
|
||||
- new defaults key finalCountdown which automatically continues (or shuts down) after a timer
|
||||
- new defaults key finalAction which can set 'shut down' as the action when the timer runs out
|
||||
- started out with localization (#23)
|
||||
- background window and log window work over Setup Assistant #22
|
||||
- show Jamf Computer ID in Info Window #13 and re-worked Info View
|
||||
- user input configurable in profile #4
|
||||
- added department, building and room as options for input #5
|
||||
- started out with localization
|
||||
- background window and log window work over Setup Assistant
|
||||
- show Jamf Computer ID in Info Window and re-worked Info View
|
||||
- user input configurable in profile
|
||||
- added department, building and room as options for input
|
||||
|
||||
## v0.2
|
||||
|
||||
- app should now work with macOS Monterey #9
|
||||
- window not movable #18
|
||||
- main window centered correctly #17
|
||||
- menu bar hidden #20
|
||||
- removed coverflow effect from main action list #14
|
||||
- app should now work with macOS Monterey
|
||||
- window not movable
|
||||
- main window centered correctly
|
||||
- menu bar hidden
|
||||
- removed coverflow effect from main action list
|
||||
|
||||
known issues:
|
||||
|
||||
- log window and background image window don't open when run over login window #22
|
||||
- user input not yet optional #4
|
||||
- shutdown button does not work yet #1
|
||||
- log window and background image window don't open when run over login window
|
||||
- user input not yet optional
|
||||
- shutdown button does not work yet
|
||||
|
||||
@@ -196,6 +196,33 @@ This will set the computer name to `Mac-ABC123` where `ABC123` is the last six c
|
||||
|
||||
When set, the "About this Mac" info window will show this value instead of the real serial number. This is useful when making screen shots or recordings for documentation or presentations where you do not want to expose real serial numbers.
|
||||
|
||||
#### `hideActionLabels`
|
||||
|
||||
(Bool, default: `false`)
|
||||
|
||||
Hides the individual labels under each action's icon.
|
||||
|
||||
Example:
|
||||
|
||||
```
|
||||
<key>hideActionLabels</key>
|
||||
<true/>
|
||||
```
|
||||
|
||||
#### `hideDebugLabel`
|
||||
|
||||
(Bool, default: `false`)
|
||||
|
||||
When set, suppresses display of the red 'DEBUG' label in debug mode. Useful for screenshots and recordings.
|
||||
|
||||
Example:
|
||||
|
||||
```
|
||||
<key>hideDebugLabel</key>
|
||||
<true/>
|
||||
```
|
||||
|
||||
|
||||
## Actions
|
||||
|
||||
All actions should have these keys:
|
||||
|
||||
2
LICENSE.md
Normal file
2
LICENSE.md
Normal file
@@ -0,0 +1,2 @@
|
||||
Offered under the terms of the [Jamf Concepts Use Agreement](https://resources.jamf.com/documents/jamf-concept-projects-use-agreement.pdf).
|
||||
|
||||
12
README.md
12
README.md
@@ -6,11 +6,11 @@ _"Every Assistant has a Manager"_
|
||||
|
||||
|
||||
|
||||
Please report issues, feature requests [as an issue.](https://github.com/setup-manager/setup-manager/issues)
|
||||
Please report issues, feature requests [as an issue.](https://github.com/jamf-concepts/setup-manager/issues)
|
||||
|
||||
We have opened the [discussions](https://github.com/setup-manager/setup-manager/discussions) area for questions and more generic feedback.
|
||||
We have opened the [discussions](https://github.com/jamf-concepts/setup-manager/discussions) area for questions and more generic feedback.
|
||||
|
||||
Updates will be published in the '[Releases](https://github.com/setup-manager/setup-manager/releases)' section of the repo. There you can also [download the latest pkg installer](https://github.com/setup-manager/setup-manager/releases/latest). You can subscribe to notifications for the repo using the 'Watch' button above.
|
||||
Updates will be published in the '[Releases](https://github.com/jamf-concepts/setup-manager/releases)' section of the repo. There you can also [download the latest pkg installer](https://github.com/jamf-concepts/setup-manager/releases/latest). You can subscribe to notifications for the repo using the 'Watch' button above.
|
||||
|
||||
## What it does
|
||||
|
||||
@@ -59,7 +59,11 @@ Setup Manager requires macOS 12.0.0 or higher. It will work only with Jamf Pro o
|
||||
### Known Issues
|
||||
|
||||
- Setup Manager will **_not_** launch with Auto-Advance enabled
|
||||
- Setup Manager may **_not_** launch when you disable _all_ Setup Assistant screens
|
||||
- Setup Manager may **_not_** launch or launch and quit quickly when you disable _all_ Setup Assistant screens
|
||||
- Policies that are triggered by `enrollmentComplete` may disrupt Setup Manager running from Prestage/Automated Device Enrollment. To avoid this, disable or unscope policies triggered by `enrollmentComplete` on devices using Setup Manager.
|
||||
- In some deployments, Setup Manager attempts to start while Jamf is still installing. Try adding a 30-60 second `wait` action as the first action. We are working on a solution.
|
||||
- SVG and PDF files don't work with download URLs. workaround: convert files to PNG or use local SVG or PDf files instead.
|
||||
- With Jamf School, there will a few seconds after the remote management dialog where Setup Assistant shows before Setup Manager launches. With the Jamf School enrollment architecture, this is unavoidable.
|
||||
|
||||
### Quit
|
||||
|
||||
|
||||
@@ -1,23 +0,0 @@
|
||||
# Jamf Setup Manager Terms of Use
|
||||
|
||||
## Non-Product/Add-On Software
|
||||
|
||||
This application is an add-on utility that may enhance your use of Jamf Pro. However, it is not a part of the Jamf Product Line and as such is not eligible for support via our normal product support channels. It has not been tested or validated by Jamf's internal compliance, security, and quality processes. We make no representation about when or if the utility will become a part of the Jamf Product line or when or in what form its functionality might be integrated into other Jamf Products.
|
||||
|
||||
## Privacy
|
||||
|
||||
We send an anonymous event notification to our monitoring system whenever the app is launched. The collected data is used to measure the project's adoption and helps us prioritize future development.
|
||||
|
||||
The data format of the event record is as follows: {"uuid": "<uuid>", "event": "Setup Manager - Launch"}. The "uuid" value is randomly-generated. The application will not collect or transmit information about you, your organization, your users, or anything related to the device being used or the data it contains.
|
||||
|
||||
## Testing
|
||||
|
||||
We make no representation that the software will perform or continue to perform as intended in your environment. You agree to test the software in a non-production environment and independently evaluate its functionality prior to any use that may impact your operations.
|
||||
|
||||
## "As-Is"
|
||||
|
||||
THIS 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 NON-INFRINGEMENT. IN NO EVENT SHALL JAMF SOFTWARE, LLC OR ANY OF ITS AFFILIATES BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF OR OTHER DEALINGS IN THE SOFTWARE, INCLUDING BUT NOT LIMITED TO DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR PUNITIVE DAMAGES AND OTHER DAMAGES SUCH AS LOSS OF USE, PROFITS, SAVINGS, TIME OR DATA, BUSINESS INTERRUPTION, OR PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES.
|
||||
|
||||
## Copyright notice
|
||||
|
||||
Jamf-developed portions of the project are ©2023-2024, JAMF
|
||||
Reference in New Issue
Block a user