A helper app to launch a main app at login under sandboxing

View the Project on GitHub kgn/LaunchAtLoginHelper

When creating a sandboxed app LSSharedFileListInsertItemURL can no longer be used to launch the app at startup. Instead SMLoginItemSetEnabled should be used with a helper app inside the main app's bundle that launches the main app. LaunchAtLoginHelper is that helper app, it is designed to be as easy as possible to integrate into the main app to allow it to launch at login when sandboxed.

A lot of research was put into this helper app. For example Apple's docs state that LSRegisterURL should be used to register the helper app, however this never seemed to work and after further digging it turns out this is a typo in the docs. Many examples I found online used NSWorkspace launchApplication: to launch the main app, however this was blocked by sandboxing so a url scheme is used instead.

This project contains a sample app to demonstrate how the main app should be configured and how to setup a checkbox to enable and disable launching at login.

How to use

First download or even better submodule LaunchAtLoginHelper. To clone the repository as a submodule use the following commands:

$ cd <main_app_project>
$ git clone --recursive git://

LaunchAtLoginHelper uses a url scheme to launch the main app, if the main app doesn't have a url scheme yet add one.

There are two files missing from this repo that are specific to your instance of the helper app. To generate these files run the python script and pass in the url scheme to launch the main app and the bundle identifier of the helper app, this is usually based of of the bundle identifier of the main app but with Helper added onto the end.

$ cd LaunchAtLoginHelper
$ python <main_app_url_scheme> <helper_app_bundle_identifier>

This will create LLManager.h which is used in both the helper app and the main app and contains #define's for the url scheme and the helper app's bundle identifier. LaunchAtLoginHelper-Info.plist is also created for the helper app with it's custom bundle identifier filled in.

Once these two files are generated it's time to add LaunchAtLoginHelper to the main app. Drag LaunchAtLoginHelper.xcodeproj, LLStrings.h, LLManager.h, and LLManager.m to the main app's project.

Next go to the Build Phases for the main app and add LaunchAtLoginHelper as a Target Dependency and create a new Copy Files Build Phase. Set the Destination of this build phase to Wrapper and the Subpath to Contents/Library/LoginItems.

Lastly add ServiceManagement.framework to the main app.

Once this is done use LLManager to enable and disable launching at login! LaunchAtLoginSample shows how to hook this up to a checkbox.

#import "LLManager.h"

[LLManager launchAtLogin] // will the app launch at login?
[LLManager setLaunchAtLogin:YES] // set the app to launch at login

Special thanks to Curtis Hard for offering some much needed advice on this project.