In-app branding

Logo

The keys Logo and LogoDark control the logo shown in the sidebar and in other places of the Catalog App.

URL or File

When using an image from URL or local file image, there are no special requirements other than the full path to the image.

SF Symbol

To apply an SF Symbol, the use the SF= prefix, followed by the SF Symbol name:

<key>Logo</key>
<string>SF=building.2.crop.circle.fill</string>

Color options:

To apply a color rendering mode or custom color, some color options are available:

• auto: the macOS Accent Color or the color set by CustomColor

<key>Logo</key>
<string>SF=building.2.crop.circle.fill,color=auto</string>

• multicolor: Enables the multicolor rendering mode

<key>Logo</key>
<string>SF=app.badge.fill,color=multicolor</string>

• hierarchical: Enabled the hierarchical rendering mode

<key>Logo</key>
<string>SF=building.2.crop.circle.fill,color=hierarchical</string>

• HEX color code: Apply a custom color and overrule if CustomColor is set. Set the color using the HEX code in RGB format, a '#' immediately followed by six hexadecimal characters(0-9, A-F)

<key>Logo</key>
<string>SF=building.2.crop.circle.fill,color=#9ACEA4</string>

• Default: Enables the monochrome rendering mode

<key>Logo</key>
<string>SF=building.2.crop.circle.fill</string>

Sidebar titles

The sidebar allows setting a title and subtitle to provide additional context to the user. Both titles are optional and appear at the top of the sidebar or, if a logo is set, directly beneath the logo.

<key>SidebarTitle</key>
<string>Sidebar Title</string>
<key>SidebarSubtitle</key>
<string>Sidebar Subtitle</string>

Color

Set a custom color to use across the app instead of the macOS accent color. For example, sidebar icons and the install buttons will be use this color. Set the color using the HEX code in RGB format, a '#' immediately followed by six hexadecimal characters(0-9, A-F).

<key>CustomColor</key>
<string>#9ACEA4</string>

Header

Catalog App can be branded with an optional header image or color which is presented above the available apps and updates. This key accepts a remote image from URL or one or more colors which result into a gradient effect. The header option is exclusive to macOS 26 and uses Apple’s new background extension effect which shows the image edge to edge and mirrors under the sidebar to avoid losing content.

To use the color option, start the string with "color=" followed by the color(s) using the HEX code in RGB format, a '#' immediately followed by six hexadecimal characters(0-9, A-F). Use a comma as separator when using multiple colors.

Availability: macOS 26+

Examples:

<key>Header</key>
<string>/PATH/TO/URL</string>

<key>Header</key>
<string>color=#9ACEA4,#7FCBD7,#F39B9C</string>

Image option

Color option