Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions src/MacVim/dmg/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
This folder contains resources used for creating the dmg installation file.
File renamed without changes
File renamed without changes.
2 changes: 1 addition & 1 deletion src/Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -3752,7 +3752,7 @@ macvim-dmg:
create-dmg/create-dmg \
--volname "MacVim" \
--volicon MacVim/icons/MacVim.icns \
--background create-dmg/background.png \
--background MacVim/dmg/background.png \
--window-size 650 470 \
--icon-size 80 \
--icon MacVim.app 240 320 \
Expand Down
Empty file.
1 change: 1 addition & 0 deletions src/create-dmg/LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
The MIT License (MIT)

Copyright (c) 2008-2014 Andrey Tarantsov
Copyright (c) 2020 Andrew Janke

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
3 changes: 1 addition & 2 deletions src/create-dmg/README
Original file line number Diff line number Diff line change
@@ -1,2 +1 @@
Content of this directory (except background.png) is copied from
https://github.com/andreyvit/create-dmg (5acf22f).
Content of this directory is copied from https://github.com/create-dmg/create-dmg (v1.0.8 / 0985398).
102 changes: 102 additions & 0 deletions src/create-dmg/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
create-dmg
==========

A shell script to build fancy DMGs.

Status and contribution policy
------------------------------

Create-dmg is maintained thanks to the contributors who send pull requests.
As of May 2020, [Andrew Janke](https://github.com/apjanke) is the primary maintainer, and (since September 2018) [@aonez](https://github.com/aonez) has helped with the maintenance.
The project home page is <https://github.com/create-dmg/create-dmg>.

We will merge any pull request that adds something useful and does not break existing things.

If you're an active user and want to be a maintainer, or just want to chat, please ping us on Gitter at [gitter.im/create-dmg/Lobby](https://gitter.im/create-dmg/Lobby), or [email Andrew directly](floss@apjanke.net).

Create-dmg was originally created by [Andrey Tarantsov](https://github.com/andreyvit).

Installation
------------

- You can install this script using [Homebrew](https://brew.sh):

```sh
brew install create-dmg
```

- You can download the [latest release](https://github.com/create-dmg/create-dmg/releases/latest) and install it from there:

```sh
make install
```

- You can also clone the entire repository and run it locally from there:

```sh
git clone https://github.com/create-dmg/create-dmg.git
```

Usage
-----

```sh
create-dmg [options ...] <output_name.dmg> <source_folder>
```

All contents of source\_folder will be copied into the disk image.

**Options:**

- **--volname \<name\>:** set volume name (displayed in the Finder sidebar and window title)
- **--volicon \<icon.icns\>:** set volume icon
- **--background \<pic.png\>:** set folder background image (provide png, gif, jpg)
- **--window-pos \<x\> \<y\>:** set position the folder window
- **--window-size \<width\> \<height\>:** set size of the folder window
- **--text-size \<text_size\>:** set window text size (10-16)
- **--icon-size \<icon_size\>:** set window icons size (up to 128)
- **--icon \<file_name\> \<x\> \<y\>:** set position of the file's icon
- **--hide-extension \<file_name\>:** hide the extension of file
- **--custom-icon \<file_name|custom_icon|sample_file\> \<x\> \<y\>:** set position and -tom icon
- **--app-drop-link \<x\> \<y\>:** make a drop link to Applications, at location x, y
- **--ql-drop-link \<x\> \<y\>:** make a drop link to /Library/QuickLook, at location x, y
- **--eula \<eula_file\>:** attach a license file to the dmg
- **--rez \<rez_path\>:** specify custom path to Rez tool used to include license file
- **--no-internet-enable:** disable automatic mount&copy
- **--format:** specify the final image format (default is UDZO)
- **--add-file \<target_name\> \<file|folder\> \<x\> \<y\>:** add additional file or folder (can be used multiple times)
- **--disk-image-size \<x\>:** set the disk image size manually to x MB
- **--hdiutil-verbose:** execute hdiutil in verbose mode
- **--hdiutil-quiet:** execute hdiutil in quiet mode
- **--sandbox-safe:** execute hdiutil with sandbox compatibility and do not bless
- **--version:** show tool version number
- **-h, --help:** display the help

Example
-------

```sh
#!/bin/sh
test -f Application-Installer.dmg && rm Application-Installer.dmg
create-dmg \
--volname "Application Installer" \
--volicon "application_icon.icns" \
--background "installer_background.png" \
--window-pos 200 120 \
--window-size 800 400 \
--icon-size 100 \
--icon "Application.app" 200 190 \
--hide-extension "Application.app" \
--app-drop-link 600 185 \
"Application-Installer.dmg" \
"source_folder/"
```

See the `examples` folder in the source tree for more examples.

Alternatives
------------

- [node-appdmg](https://github.com/LinusU/node-appdmg)
- [dmgbuild](https://pypi.python.org/pypi/dmgbuild)
- see the [StackOverflow question](http://stackoverflow.com/questions/96882/how-do-i-create-a-nice-looking-dmg-for-mac-os-x-using-command-line-tools)
Loading