Skip to main content
The installer window is one calm column: your logo, a heading, one line of copy, a card of choices and buttons at the bottom. You change how it looks and what it says in [installer], [app] and [text]. This page walks through each lever.

Logo and icon

bach.toml
  • app.icon is a .ico file. It becomes the setup file’s icon and the window’s icon. When the icon holds a PNG image (most modern icons do) and installer.logo is not set, it is also the logo in the window. Include sizes 16 to 256 for crisp results.
  • installer.logo is an .svg or .png, or "none" for no logo at all. If you set neither, the window shows the Bach mark.
  • An SVG is drawn in one colour that follows the theme. Use a PNG for a full-colour logo. A wide PNG, such as a wordmark, keeps its shape. Give a PNG twice the size it is shown at for sharp results.

Style

The window comes in 14 built-in styles: Bach’s own, soft gradients, a terminal look, several game looks and more. Every app starts in Bach’s own style, bach. If you want another, pick one, and change its font, colours, corners or background in [style]:
bach.toml
bach styles lists them, and bach preview --style NAME shows one on your app without changing bach.toml. Every setting is in [style].

Layout

Start from one of ten layouts, such as showcase (the choices on the left, a large rounded picture on the right), hero, floating or tiles, then change the window’s size, the panel, spacing, buttons and animation:
bach.toml
bach layouts lists them and bach preview --layout NAME shows one on your app. Every setting is in [layout].

Theme and accent

bach.toml
system follows Windows’ light or dark setting, live. light or dark fixes it. Without accent, buttons are black in light mode and white in dark mode. With one, the accent replaces the primary colour of the window, and the button text automatically picks black or white for contrast.

Languages

bach.toml
The window ships in 19 languages and follows the user’s Windows display language when it is in your list, otherwise it uses your first language. With a single language, such as ["de"], the window always speaks it. Leave languages out to offer all 19. Preview any language without changing Windows: bach preview --lang de.

License page

bach.toml
The license file is UTF-8 text. The user must accept it before the install page. An update shows it again only when it changed.

Change any text

Every word the window shows can be replaced in [text], in one language or per language:
bach.toml
Every text can use {name}, {version} and {publisher}. A few have their own placeholders. The complete list of text names, their English defaults and their placeholders is in [text].
When the window speaks several languages and a text is given in only one, bach check points it out.

Where the app’s description shows

app.description is one line. It is the shortcut’s tooltip, and the line under “Install My App” on the first page, unless [text] install_subtitle replaces it. Without a description, that line is left out.

Look at the result

Next steps

Choices and components

Decide what the user can tick.

The installer window

Every page and state of the window.