Skip to main content

Tools to support converting a Python project into a standalone native application.

Project description


Tools to support converting a Python project into a standalone native application.


In your virtualenv, install Briefcase:

$ pip install briefcase

Then, add extra options to your file to provide the app-specific properties of your app. Settings that are applicable to any app can be set under the app key; platform specific settings can be specified using a platform key:

        'app': {
            'formal_name': 'My First App',
            'bundle': 'org.example',
            'icon': 'icons/app.icns',
        'osx': {
            'app_requires': [
        'ios': {
            'app_requires': [
            'icon': {
                '29': 'icons/app-29.png',
                '40': 'icons/app-40.png',
                '58': 'icons/app-58.png',
                '76': 'icons/app-76.png',
                '80': 'icons/app-80.png',
                '87': 'icons/app-87.png',
                '120': 'icons/app-120.png',
                '152': 'icons/app-152.png',
                '167': 'icons/app-167.png',
                '180': 'icons/app-180.png',
            'splash': {
                '1024x768': 'splash/splash-1024x768.png',
                '1536x2048': 'splash/splash-1536x2048.png',
                '2048x1536': 'splash/splash-2048x1536.png',
                '768x1024': 'splash/splash-768x1024.png',
                '640x1136': 'splash/splash-640x1136.png',
                '640x960': 'splash/splash-640x960.png',
        'android': {
            'app_requires': [

At a minimum, you must set a formal_name key (the full, formal name for the app) and a bundle key (the bundle identifier for the author organization - usually a reverse domain name).

Then, you can invoke briefcase, using:

$ python osx

to create an OS/X app, or:

$ python ios

to create an iOS app, or:

$ python android

to create an Android app.


Briefcase is part of the BeeWare suite. You can talk to the community through:


If you experience problems with Briefcase, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
briefcase-0.1.2-py2.py3-none-any.whl (10.0 kB) Copy SHA256 hash SHA256 Wheel py2.py3
briefcase-0.1.2.tar.gz (14.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page