Skip to main content

Converts any executable to a non-self-contained mac app bundle which depends on system libraries.

Project description



Converts any executable to a non-self-contained mac app bundle which depends on system libraries. Other converters often have problems when complex dependencies (e.g. PyQt) must be included. shallow-appify avoids these problems by referencing present system libraries.


The latest version is available from PyPI:

pip install shallow-appify

If you use Arch Linux or one of its derivatives, you can also install shallow-appify from the AUR:

yay -S shallow-appify


usage: shallow-appify [-h] [-d EXECUTABLE_ROOT_PATH]
                      [-e ENVIRONMENT_VARS [ENVIRONMENT_VARS ...]] [-i ICON_PATH]
                      [-g GROUP] [-n] [-o APP_PATH] [-v VERSION_STRING]
                      [--conda CONDA_REQ_FILE]
                      [--conda-channels CONDA_CHANNELS [CONDA_CHANNELS ...]]
                      [--extension-makefile EXTENSION_MAKEFILE]

Creates a runnable application for Mac OS X with references to system
libraries. The result is a NON-self-contained app bundle.

positional arguments:
  executable_path       Sets the executable that is started when the app is

optional arguments:
  -h, --help            show this help message and exit
                        Defines the executable root directory that will be
                        included in the app.
                        Specifies which environment variables -- set on the
                        current interpreter startup -- shall be included in
                        the app bundle.
  -i ICON_PATH, --icon ICON_PATH
                        Image file that is used for app icon creation. It must
                        be quadratic with a resolution of 1024x1024 pixels or
  -g GROUP, --group GROUP
                        Developer group name that is saved to the internal app
  -n, --hidden          Hides the app icon in the dock when given.
  -o APP_PATH, --output APP_PATH
                        Sets the path the app will be saved to.
                        Specifies the version string of the program.
  --conda CONDA_REQ_FILE
                        (Python only) Creates a miniconda environment from the
                        given conda requirements file and includes it in the
                        app bundle. Can be used to create self-contained
                        python apps.
  --conda-channels CONDA_CHANNELS [CONDA_CHANNELS ...]
                        (Python only) A list of custom conda channels to
                        install packages that are not included in the main
                        anaconda distribution.
  --extension-makefile EXTENSION_MAKEFILE
                        (Python only) Path to a makefile for building python
                        extension modules. The makefile is called with the
                        target "app_extension_modules" and a variable
                        "PYLIBPATH" that holds the path to the conda python

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for shallow-appify, version 0.4.4
Filename, size File type Python version Upload date Hashes
Filename, size shallow_appify-0.4.4-py2.py3-none-any.whl (19.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size shallow-appify-0.4.4.tar.gz (18.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page