create-dmg

Create a good-looking DMG for your macOS app in seconds

Imagine you have finished a macOS app, exported it from Xcode, and now want to distribute it to users. The most common way of distributing an app outside the Mac App Store is by putting it in a .dmg file. These are hard to create, especially good-looking ones. You can either pay for a GUI app where you have to customize an existing design or you can run some homebrewed Bash script and you still have to design it. This tool does everything for you, so you can play with your instead.

This tool is intentionally opinionated and simple. I'm not interested in adding lots of options.

Install

Ensure you have Node.js 14 or later installed. Then run the following:

npm install --global create-dmg

Usage

$ create-dmg --help

  Usage
    $ create-dmg <app> [destination]

  Options
    --overwrite          Overwrite existing DMG with the same name
    --identity=<value>   Manually set code signing identity (automatic by default)
    --dmg-title=<value>  Manually set DMG title (must be <=27 characters) [default: App name]

  Examples
    $ create-dmg 'Lungo.app'
    $ create-dmg 'Lungo.app' Build/Releases

DMG

The DMG requires macOS 10.13 or later and has the filename App Name 0.0.0.dmg. For example, Lungo 1.0.0.dmg.

It will try to code sign the DMG, but the DMG is still created and fine even if the code signing fails, for example if you don't have a developer certificate.

Important: Don't forget to notarize your DMG.

Software license agreement

If either license.txt, license.rtf, or sla.r (raw SLAResources file) are present in the same directory as the app, it will be added as a software agreement when opening the image. The image will not be mounted unless the user indicates agreement with the license.

/usr/bin/rez (from Command Line Tools for Xcode) must be installed.

DMG icon

GraphicsMagick is required to create the custom DMG icon that's based on the app icon and the macOS mounted device icon.

Steps using Homebrew

brew install graphicsmagick imagemagick

Icon example

Original icon DMG icon

Defaults - Swifty and modern UserDefaults
LaunchAtLogin - Add Launch at Login functionality to your macOS
My apps
More

Project Name	Stars	Repos Using This	Packages Using This	Most Recent Commit	Total Releases	Latest Release	Open Issues	License	Language
Create Dmg	4,013	3	3	a month ago	22	February 07, 2023	10	mit	JavaScript
Create a good-looking DMG for your macOS app in seconds
Sqlcheck	2,077			2 years ago	18	September 01, 2020	6	apache-2.0	C++
Automatically identify anti-patterns in SQL queries
Macostriagetool	39			4 years ago				gpl-3.0	Go
A DFIR tool to collect artifacts on macOS
Rocketcleaner	17			2 years ago			14	mit	JavaScript
Mac OS Cleaner
Penney	14			2 years ago				mit	Python
Penney's Game
Mactomb	11			6 years ago			6	gpl-3.0	Shell
Mac OS X semi-implementation of Tomb https://github.com/dyne/Tomb
Dmg License	8			2 years ago			1	mit	TypeScript
Generate license agreements for macOS .dmg files
Ultrapiet	8			7 years ago			4	gpl-3.0	C++
最強のPiet拡張 (IDE付き)(マルチプラットフォームで動くよ！)(打倒3P(Python,PHP,Perl !))
Fmaru	8			7 years ago			1		JavaScript
free marumaru 혹은 fuck marumaru
Pkgman	6		1	a month ago	14	April 30, 2021	15	other	Go
📱 Package manipulation tool & library (ipa, etc)

Create Dmg