Branding

This page describes how to customize the application details such as name, icon, description, version, copyright, etc.

Overview

You can customize the application name, icon, description, copyright, version, etc. by editing the corresponding properties in molybden.conf.json:

{
  "app": {
    "name": "MyApp",
    "version": {
      "major": "1",
      "minor": "0",
      "patch": "0"
    },
    "author": "MyCompany",
    "copyright": "MyCopyright",
    "description": "MyDescription",
    "bundle": {
      "macOS": {
        "icon": "src-cpp/assets/app.icns",
        "bundleID": "",
        "codesignIdentity": "",
        "codesignEntitlements": "",
        "teamID": "",
        "appleID": "",
        "password": ""
      },
      "Windows": {
        "icon": "src-cpp/assets/app.ico",
        "certFile": "",
        "certPassword": "",
        "digestAlgorithm": "",
        "timestampServerURL": ""
      },
      "Linux": {
        "icon": "src-cpp/assets/app128.png"
      }
    },
    "configurations": {
      ...
    }
  }
}

Application details

We recommend that you configure the application version, author, copyright, and description properties if you build your application for Windows users.

These properties will be displayed in the application Properties:

Application icon

To change the application icon, just replace the existing platform-specific icon files with your own ones in the same format. Different platforms require different icon formats.

Windows

The default application icon is located in src-cpp/assets/app.ico. You can replace it with your own. The icon must be in the ICO format.

There are many ways to create an ICO file. We recommend that you use a special software such as IcoFX.

macOS

The application icon is located in src-cpp/assets/app.icns. The icon must be in the *.icns format.

To create your own app icon, save your app icon images with the following names and dimensions:

Then, follow these steps:

1. Move all the images into a new folder.
2. Rename the folder to: icon.iconset.
3. Confirm the file extension when prompted.
4. Navigate to the directory containing your icon.iconset in the terminal.
5. Run iconutil with the following command: iconutil -c icns icon.iconset.
6. Your icon.icns will be generated in the current directory.

Linux

The application icon is located in src-cpp/assets/app128.png. The icon represents a simple image in the PNG format with the 128x128 dimension.