Skip to content
clarationPublic

About

A rather familar looking installer for Disk Images.

Resources

Stars

186 stars

Watchers

0 watching

Forks

Repository files navigation

Claration Install System

GitHub License Sponsor Me

CIS allows you to open DMG files into an installer-like interface which directly extracts apps into applications without the need of the pain of dragging and dropping or waiting it to mount.

Demo of Discord Setup

Here's an example of CIS installing Discord's distributed .dmg file. It should work with most of these files, it just depends on how distributes made them.

Design Philosophy

DMG files

If you're someone coming from Windows and now using macOS, you will recognize that this looks like NSIS! This was intentional as it serves a good baseline for installer interfaces people recognize, however you can customize how the installer works to your liking!

  • Supports skipping some installer steps to be be less-like the Windows experience.
  • Supports some default options for destination folders & trashing the DMG file afterwards.

DMG files are not mounted! They are read and processed in memory, while trying to preserve near-native speeds when extracting files.

CIS will extract any .app directories embedded in DMG files into a destination directory, however you can customize it in the App Picker section in the installer. Though, setting the option to skip all the needless steps like this one will hinder that ability.

PKG files inside of DMG files

DMG files which house PKG files (e.g. SF Symbols) are also supported! CIS will extract any available PKG files and open them into the macOS package installer.

Demo of SF Symbols

CIS will first check for any available .app directories, if it can't find anything it will then search and extract any available .pkg files into a temporary directory, then execute the built-in macOS installer for these files.

Download

Visit releases and get the latest version for your computer.

Building

You will need Xcode for compilation. For packaging a .dmg, you will need Homebrew and will need to install some dependencies, look below for more information.

$ git clone https://github.com/claration/cis.git
$ cd cis
$ make build # optionally add DMG=1 for dmg
DMG building (click to expand)

When making a DMG, there's only one dependency you need and it's from Homebrew (sadly!)\

$ brew install create-dmg

The output of the app will be in _build/Applications/*.app | _build/*.dmg

Important

When debugging, CIS is going to try and by default open to a hardcoded path on my computer (sorry!). This is for testing purposes and having convenient access to a debugger.

Sponsors

Thanks to all my sponsors!!
"samara is cute" - Vendicated

Acknowledgements

  • CLARATION – The maker.
  • NSIS – NSIS assets, however I recreated them so they're higher quality,

License

Project is licensed under the MIT license. You can see the full details of the license here.

About

A rather familar looking installer for Disk Images.

Resources

Stars

186 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages