cinnamon thoughts.

Please see this post for Mountain Lion (OS X 10.8).

The Goal

I want to use AirPrint on my iPhone or iPad to print to a PDF document on my Mac. For convenience reasons the PDF should be created on the desktop. Furthermore I don’t want to use any hacks or additional programs that run in the background all the time.

In this how-to you’ll enable AirPrint in Mac OS X (tested on Mac OS X 10.6.5), install a PDF printer using a free, open source driver and add an AppleScript which moves the PDFs printed on your iOS device to your Mac’s Desktop.

(If you’ve got the installed, a utility called Printer Simulator.app is available which simulates several AirPrint capable printers. You can use those to print from iOS to a PDF which will be opened in Preview. This requires that the program runs all the time which is exactly what I don’t want. It’s a great way great to test AirPrint, though.)

Only follow the next steps (at your own risk) if you have a full backup of your Mac and are comfortable using a shell (Terminal.app)!

The Preparation

Mac OS X 10.7 Lion users can skip this section and follow these instructions on how to use a tool called AirPrint Activator instead. Afterwards continue with the section The PDF Printer.

On Mac OS X 10.6.5 it isn’t possible to use every printer that is shared through the Mac for AirPrint. Only a few HP printers support AirPrint at the moment. Hence the first step is to enable AirPrint for every printer connected to the Mac.

A good tutorial (in German) can be found here and includes a downloadable script to do the work for you. If you want to use Terminal (or in case the site is not available) all you have to do is start /Applications/Utilities/Terminal.app and input the following line (all in one line):

sudo bash -c "echo 'image/urf urf (0,UNIRAST<00>)' > /usr/share/cups/mime/airprint.types"

This command asks for your (administrator) password and creates a file called airprint.types in the directory /usr/share/cups/mime/. The content of this file is image/urf urf (0,UNIRAST<00>).

After creating this file the Mac needs to be rebooted. After the reboot you can already use printers connected to the Mac for AirPrint. Just delete and recreate them in System Preferences → Print & Fax and share them in System Preferences → Sharing.

The PDF Printer

Once Mac OS X supports AirPrint for every shared printer, the preparations from above will most likely no longer be necessary.

To be able to create PDFs through AirPrint we first need a PDF printer on Mac OS X. The PDF button in the default printer dialog works great when creating PDFs locally on the Mac but it doesn’t help on iOS.

CUPS-PDF is a PDF printer available for many platforms. To install it, follow these steps:

1. Download the Mac OS X version of CUPS-PDF
2. Install it by unzipping and running the installer
3. Go to System Preferences → Print & Fax
4. The following illustration show the steps necessary to add the PDF printer

1. Click the “+” symbol
2. Select the printer CUPS-PDF (you may also give it another name)
3. Select Generic PostScript Printer for “Print Using”
4. Click “Add”
5. Select the newly created PDF printer and mark the checkbox Share this printer on the network

Now print any document (e.g. this website) from your Mac using your newly created PDF printer. The PDF document is created in /Users/Shared/CUPS-PDF in a folder with your user account’s name.
When printing from iOS over AirPrint the PDFs are created in the guest account’s folder under /Users/Shared/CUPS-PDF and you won’t be able to easily access them due to missing permissions. Thus we will restrict the PDF printer to your account which results in correct permissions on the created PDF files.

1. For this go to Sharing in the System Preferences
2. There you select Printer Sharing (make sure the checkbox is marked)
3. Select your PDF printer
4. Click the “+” button
5. You get a popup where — under Users & Groups — you can select your account
6. Click “Select”

In the Users list you should see your account’s name and Everyone with No Access. These steps make sure that you won’t run into permission problems later on.

Now you can use AirPrint on iOS to print a PDF document to your Mac. Follow the steps in this illustration (click to enlarge), e.g. using Safari in your iPhone. When asked for your user name and password, enter the login data from your Mac OS X account (you allowed sharing of the PDF printer only with this account in the steps above).

Now your PDF document should be stored in /Users/Shared/CUPS-PDF inside a folder with your user account’s name (as during the first test print from your Mac).

If you want the PDFs to be move to the Desktop, follow the next (optional) steps.

The Icing on the Cake

To automatically move newly created PDFs to the Desktop (which is easier to access than the CUPS-PDF folder) we’ll use Folder Actions and an AppleScript.

You can simply create a new AppleScript by opening the AppleScript Editor located in /Applications/Utilities/ and inserting the code from below. Save the script to /Users/[your account]/Library/Scripts/Folder Action Scripts with a name like move - move files to desktop. This is the script:

(*
moves files to the desktop of the current user
*)
on adding folder items to this_folder after receiving added_items
  try
    tell application "Finder"
      set targetFolder to path to desktop folder from user domain
      move entire contents of this_folder to targetFolder
    end tell
  end try
end adding folder items to

This simple script (when used as a Folder Action) moves all files in the folder to the desktop. Once the script is created you can attach it to the folder where new PDFs are stored: /Users/Shared/CUPS-PDF/[your account].
To do this, follow the steps in this illustration (click to enlarge):

1. Right click or cmd-click on the folder /Users/Shared/CUPS-PDF/[your account]
2. Select “Folder Actions Setup”
3. In the popup choose the move script you’ve created earlier and click “Attach”
4. Make sure that the script is attached to the folder named like your account

The End

That’s it! The instructions are a bit longer than I first expected. Also I think most of this would be scriptable, but I just don’t have the time to do this.

If you run into any problems or find errors in the instructions please leave a comment or tell me on .

tags: AirPrint, AirPrint to PDF, CUPS-PDF, iOS 4.2, iPad, iPhone

Posted on Saturday, November 27th, 2010 at 23:36 by Daniel M. Gattermann. This Post is filed under Apple, Development, iOS, , iPhone, Mac OS X. You can follow responses through the and view other blogs commenting on this post. You can also leave a response, or trackback from your own site.