Contents  DropDMG Manual  Technical Support

5.3   Layouts

When you double-click a disk image, macOS mounts it and opens a Finder window showing its top-level contents. Layouts let you control the appearance of this window: the window position, background picture, view options, and icon positions. Additionally, when you create a disk image with a layout, DropDMG sets it to automatically open the window when mounting the image or inserting a disc burned from the image.

Note: The files/folders that you add to a layout are only used for the purposes of designing the layout, i.e. specifying where each icon goes. The actual contents of the disk image are determined by the source folder that you drag onto DropDMG. Normally, you would add an icon to the layout for each file that will be in your source folder. However, a layout can have more files than the source folder, in which case you can reuse that layout for different purposes. A layout can also have fewer files than the source folder, in which case DropDMG will leave the icon positions of the extra files unspecified.

See the Making Images With Background Pictures section for a tutorial on creating disk images with background pictures and layouts.

preferences layoutspreferences layouts

Use the + button to create a new layout and the - button or the Delete key to remove one. Several commands are available in the action menu and contextual menu:

Duplicate Layout
Create a new layout that matches the selected one.
Rename Layout
Change the name of the selected layout. You can also click-and-hold on the name or press the Return or Enter key.

DropDMG automatically saves the layouts that you create, as you edit them. You can also create copies of the layouts outside DropDMG, as described in the Sharing Licenses and Layouts section.

Window position
This controls the position of the upper left corner of the window, relative to the upper left corner of the user’s main display (i.e. the Apple menu).
Background image

Set the background image by dragging an image file onto the well or by clicking the Choose… button. The background image determines the size of the layout. If you do not specify a background image, DropDMG uses a plain white background with dimensions 640×480.

The background image can be a 72 or 144dpi image, a PDF file, or a multi-resolution TIFF file. DropDMG will render a multi-resolution background picture that’s optimized for display on both Retina and non-Retina Macs. DropDMG looks at the background image’s actual resolution (dots per inch) to determine whether to treat it as Retina; it does not, e.g., look for @2x in the filename.

To remove a background image, Control-click and choose Delete Background Image.

See Designing a Background Image below for information about how large your background picture should be and how its contents should be designed.

Text boxes

Click Add Text to create text boxes that are drawn atop the background image. Click once on a text box to resize it. Double-click to edit its contents. After selecting some text, you can use the Fonts panel to set the font, style, color, and shadow. The ruler lets save favorite styles and adjust the spacing and alignment (left, center, full, or right) of the text.

fonts panel

The Variables pop-down menu lets you add placeholders that DropDMG will fill in when you build the disk image, so that you don’t have to manually update the text in your layout. The supported variables are Application Name (e.g. DropDMG), Application Short Version String (the marketing version from CFBundleShortVersionString), Application Version (the build number from CFBundleVersion), and Date (YYYY-MM-DD) (e.g. the date the disk image was created).

Icon positions

To add an icon to the layout, drag and drop a file or folder or click the Add Icon… button.

Click the Application Placeholder button to add a special icon to your layout called ${APP_BASENAME}.app. This will set the position of whichever application (or other principal file) is in your source folder, letting you use the same layout to create disk images for multiple applications.

Click the Application Folder button to create a link to the Applications folder. This makes it possible to install an application by dragging its icon onto the Applications icon in the same window. When you create a disk image using the layout, DropDMG will automatically add a symlink to the Applications folder. (This option is not recommended for use with Internet-enabled disk images.)

You can drag and drop to rearrange the icons. By default, DropDMG uses a 16×16 grid so that the icons are aligned with one another. To drag an icon to any position, unconstrained by the grid, hold down the Command key. You can also move the selected icons one point at a time by pressing the arrow keys.

Icon size
The icons can be displayed at 16×16, 32×32, 48×48, 64×64, 96×96, 128×128, 256×256, or 512×512.
Text size
The text size can vary from 10 to 16 point.

See also:

Designing a Background Image

Here are some things to consider when choosing the size of your background image and designing its contents:

Supporting macOS 10.6

Please see the documentation for the DisableRetinaBackgroundPictures esoteric preference.

Supporting macOS 10.5 and Earlier

With the macOS 10.6 Finder, Apple changed the file format that it uses to save a folder’s view options. Previous versions of macOS do not know how to fully read the new format. This means that disk images created on macOS 10.6 (using either the Finder or DropDMG) may not appear exactly as intended when using macOS 10.4 or 10.5. To deploy a disk image for previous versions of macOS, you may wish to create the disk image using DropDMG on macOS 10.5. Another option is to create a read-write disk image, manually tweak its view options on macOS 10.5, and then use DropDMG to convert it to a final format.

     Contents  DropDMG Manual  Technical Support