Skip to main content
An installed app often needs more than a program file: a second shortcut, a myapp:// link that opens it, or a file type it can open. Bach declares these in bach.toml and registers them for the current user only, never taking anything away from another program.

Extra Start menu shortcuts

The app’s own shortcut comes from start_menu_shortcut. For more, such as a second program in the install folder or the app started with arguments, add [[shortcuts]]:
bach.toml
Extra shortcuts follow the Start menu box and go away when their file is not installed, for example because its component was unticked. A link like myapp://open?file=x starts your app with the link as its first argument.
bach.toml
  • Registered for the user only.
  • Schemes that belong to Windows or browsers (http, file, ms-... and so on) are refused.
  • If another program already owns the scheme, setup leaves it alone.

File types

Declare the files your app opens:
bach.toml
The type is listed under Open with. Your app becomes the default only for types no other program opens yet, so installing your app never takes files away from another one. Types that run code (.exe, .bat, .ps1, .lnk and similar) are refused.

Start with Windows and PATH

These are options on the install page, described in Choices and components:
  • start_with_windows starts the app when the user signs in (HKCU\...\Run).
  • add_to_path puts a folder on the user’s PATH so command-line tools run from any terminal.

How removal stays safe

The registry keys Bach creates for link schemes and file types carry a BachApp mark. Keys without that mark belong to another program and are never changed or deleted. On uninstall, each integration is removed only if it is this install’s own.

Next step

Requirements

Check for WebView2, .NET or the Visual C++ runtime before installing.