Create a good-looking DMG for your macOS app in seconds
Go to file
Sindre Sorhus ff1dfdb3f4 3.1.0 2018-05-01 21:39:01 +07:00
assets Init 2017-03-28 00:35:11 +07:00
fixture.app/Contents Make the default output name for humans 2018-04-29 20:46:11 +07:00
stuff Init 2017-03-28 00:35:11 +07:00
.editorconfig Meta tweaks 2017-10-23 19:35:26 +07:00
.gitattributes Init 2017-03-28 00:35:11 +07:00
.gitignore Meta tweaks 2017-10-23 19:35:26 +07:00
.npmrc Meta tweaks 2017-10-23 19:35:26 +07:00
.travis.yml Require Node.js 8 2018-04-29 20:45:19 +07:00
cli.js Support `Mac Developer` identity too (#21) 2018-05-01 21:37:08 +07:00
license Meta tweaks 2017-10-23 19:35:26 +07:00
package.json 3.1.0 2018-05-01 21:39:01 +07:00
readme.md Add `--overwrite` flag 2018-04-29 20:58:01 +07:00
screenshot-cli.gif Improve description and CLI screenshot 2017-03-31 19:46:41 +07:00
screenshot-dmg.png Init 2017-03-28 00:35:11 +07:00
test.js Make the default output name for humans 2018-04-29 20:46:11 +07:00

readme.md

create-dmg Build Status

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.

Discuss it on Product Hunt and Twitter.

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

You might also find my LaunchAtLogin project useful.

Install

Ensure you have Node.js 8 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

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

DMG

The DMG requires macOS 10.11 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.

License

MIT © Sindre Sorhus