Home > AutoPkg, Mac administration, Mac OS X > AutoPkgr – A GUI for AutoPkg

AutoPkgr – A GUI for AutoPkg

The Linde Group has released a new tool on Github: AutoPkgr, a GUI interface for AutoPkg. In my working with the initial release today, I’ve been impressed with the problems it solves for Mac admins who want to get started using AutoPkg but aren’t sure where to begin.


To use AutoPkgr, you will need to have the following pre-requisites:

1. OS X 10.9.x

2. Xcode and/or the Xcode Command Line Tools installed

3. Acceptance of the Xcode license agreement.

4. A logged-in user to run the AutoPkgr application in. This user can be a standard user or have admin rights.

Once the prerequisites have been met, see below the jump for details on installation and configuration.

Installing AutoPkgr

1. Download the latest version from the AutoPkgr release page.

2. Copy the AutoPkgr application to /Applications.

Screen Shot 2014-07-14 at 5.30.53 PM

Using AutoPkgr

1. Open AutoPkgr and verify that both Git and AutoPkg are installed.

Screen Shot 2014-07-14 at 5.31.07 PM

If not, AutoPkgr can install the latest versions for you using the Install Git and Install AutoPkg buttons available via the Install tab.

2. To configure AutoPkg‘s repos and recipes, click on the Configure Repos & Apps tab.

Screen Shot 2014-07-14 at 5.42.06 PM

AutoPkgr will check GitHub for the AutoPkg repos available via https://github.com/autopkg and display the linked repos available for selection in the Repositories list.

If you need to add a repository, you can add it by entering it in the Add a repo URL manually: blank and clicking the Add button.

Screen Shot 2014-07-14 at 5.42.24 PM

Note – 7-14-2014: You may need to manually add a repo to AutoPkgr before you’ll be able to select other repos.

Once a repo is selected, the repo’s AutoPkg recipes available will then appear in the Available Applications pane.

Screen Shot 2014-07-14 at 5.42.37 PM

As more repos are selected, the associated AutoPkg recipes are automatically added to the Available Applications pane.

Screen Shot 2014-07-14 at 5.43.11 PM

To add receipes to AutoPkg‘s run list, check the box next to the appropriate recipes to select them.

Screen Shot 2014-07-14 at 5.42.52 PM

3. To configure AutoPkg to run on a schedule, click on the Configure Schedule tab

Screen Shot 2014-07-14 at 9.47.02 PM

To configure AutoPkg to automatically run the selected recipes on a schedule, check the option for Check for new versions of apps every X hours and set an hour value.

Screen Shot 2014-07-14 at 9.47.09 PM

To have changes to the AutoPkg repos automatically updated, check the option for Check for repo updates when AutoPkgr launches.

Screen Shot 2014-07-14 at 9.47.15 PM

If you want to manually run the selected receipes with AutoPkg, click the Check Apps Now button.

Screen Shot 2014-07-14 at 9.47.19 PM

If you want to manually update the AutoPkg repos, click the Update Repos Now button.

Screen Shot 2014-07-14 at 9.47.21 PM

You can also be notified by email when AutoPkgr has completed running the selected recipes. To do this, check the option for Send email notifications when new versions are found.

Once checked, configure the mail settings as needed.

Screen Shot 2014-07-14 at 9.47.47 PM

Once your mail settings are configured, you can test them by clicking the Send Test Email button.

Screen Shot 2014-07-14 at 9.47.48 PM

You should receive an email that looks like the one below.

Screen Shot 2014-07-14 at 8.39.29 PM

The notification emails currently look like the example below.

Screen Shot 2014-07-14 at 5.02.25 PM

As I found the email in its current form a bit hard to parse, I’ve filed a feature request to improve the formatting. At this time, the response from the developers has been positive.

4. To access the AutoPkg receipe and download folders, click on AutoPkgr‘s Tools tab.

Screen Shot 2014-07-14 at 9.48.56 PM

If you want to be notified about possible problems when quitting AutoPkgr, check the option for Warn Before Quitting AutoPkgr.

Screen Shot 2014-07-14 at 9.49.06 PM

With this option enabled, the following warning will be displayed when quitting AutoPkgr.

Screen Shot 2014-07-14 at 7.28.20 PM

Once the selected repos have been downloaded, the Open AutoPkg RecipeRepos Folder button becomes active.

Screen Shot 2014-07-14 at 5.56.17 PM

Clicking the button will open a new Finder window directly to AutoPkg‘s RecipeRepos directory in /Users/username/Library/AutoPkg.

Screen Shot 2014-07-14 at 5.51.25 PM

After AutoPkgr has completed its initial run of recipes, the Open AutoPkg Cache Folder button becomes active.

Screen Shot 2014-07-14 at 7.26.52 PM

Clicking it will open a new Finder window directly to AutoPkg‘s Cache directory in /Users/username/Library/AutoPkg, which will give you access to the completed application installers.

Screen Shot 2014-07-14 at 7.27.57 PM

5. To save your changes, click the Save and Close button.

Screen Shot 2014-07-14 at 9.48.56 PM

When you click the Save and Close button, the AutoPkgr interface closes. To get back into it, locate the briefcase icon in the menubar and click Configure…

Screen Shot 2014-07-14 at 5.48.52 PM

Once clicked, the AutoPkgr interface will re-open for editing.

Screen Shot 2014-07-14 at 5.31.07 PM

For the initial release, AutoPkgr includes a lot of nice features and I’m looking forward to seeing how this application develops. One thing I didn’t test was the Munki-specific features, as I’m not a Munki user. If you’ve used AutoPkgr with Munki, please let me know your experiences in the comments.

  1. July 15, 2014 at 8:42 pm

    Had a simple AppleScript I was using to attach a similar front end, but a more comprehensive tool like this is great to see.

  2. MiqViq
    July 17, 2014 at 9:29 am

    From their website:
    AutoPkgr requires Mac OS X 10.8 or higher???

    • July 17, 2014 at 10:03 am

      The developer has been making changes in response to feedback. The initial release required 10.9.x.

  3. cashxx
    July 18, 2014 at 2:41 am

    Oh man just as I get done learning it….lol. Always love to see a GUI, makes life more simple sometimes!! Couldn’t live without MunkiAdmin……always love to see GUI front ends being released for these tools!

  4. imperfectfuture
    July 22, 2014 at 6:25 am

    Hi Rich,

    Thanks for your post!

    We just released v1.0.1 of AutoPkgr, which addresses a bunch of issues that have been reported by the community, including some of those listed here.


    Please don’t hesitate to file an issue on GitHub or post a message to our Google Group if you have questions and/or encounter an issue.



    James Barclay

  5. James McConachie
    July 23, 2014 at 3:11 pm

    How about a complete uninstall of the App. Mine did not seem to install correctly and I would like to reinstall and start over.

  6. July 30, 2014 at 11:48 pm

    Am I missing it or is there no log files that are created when autopkgr adds recipes and creates packages other than a email that is sent?

    • everythingisgray
      August 1, 2014 at 6:42 am

      Hi Beau,

      I plan on adding to what is written to the logs soon. We’re using NSLog so everything is written to the ASL/system log, (which means you can query for logs with an ASL query or by browsing “All Messages” in Console.app).

      Also, AutoPkgr only sends email notifications when something new is downloaded, (not necessarily every time something is packaged or imported).


      I will consider adding the ability to uninstall AutoPkg in the tool.


  7. August 8, 2014 at 12:08 am

    Is there a way to use this remotely? i.e., use AutoPkgr on my machine, in order to update the munki database on the remote server?

    • mungo
      November 7, 2014 at 11:37 am

      Ian, if you mount your remote munki repository on your machine, you can simply reference /Volumes/munki_repo (or whatever your mount point is called) as the path (much as you also need to do if you use MunkiAdmin). I mount the repo as a login item so it’s always ready.

  8. Jeff Uchtman
    September 2, 2014 at 1:15 am

    I am not able to get Check Now or scheduler to run. In console I get nothing. I see the program and close and write any changes to the program but nothing else. v.1.0.1, OSX 10.9.4

  9. May 4, 2015 at 10:08 am

    Normally I’ve used Jenkins and autopkg to auto-run daily builds, but finally I’ve switched to AutoPkgr — it saves a lot of time for me. Great tool!

  10. Vinicio
    March 22, 2016 at 1:48 pm

    Ohh man!!!! this is really cool… i haven’t tried yet but i will…

  1. No trackbacks yet.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: