MuseHub Partners
Partner Portal
  • Welcome
  • πŸ‘‹Introduction
    • What is MuseHub?
    • Becoming a Muse Partner
      • Available Regions
  • βš’οΈGetting Started
    • Set up your Partner account
    • Generate API Keys
    • Prepare your product
  • βž•Adding Products
    • Product Types
      • Applications
        • Add Details
        • Set Pricing
        • Create a Submission
      • Plugins
        • Add Details
        • Set Pricing
        • Create a Submission
      • Elements
        • Add Details
        • Set Pricing
        • Upload a Version
      • MuseSounds
    • Pricing
      • Price Tiers
      • Price Scheduling
      • Pay once
      • Subscriptions
    • Product Page Assets
    • Beta Testing
    • Submitting for Release
  • Resources
    • Muse DRM
    • Muse SDK
    • URI Protocol
    • Web Hooks
    • Content Guidelines
    • Marketing Assets
Powered by GitBook
On this page
  • Supported types
  • macOS
  • Windows
  1. Adding Products
  2. Product Types

Applications

Apps encompass anything from audio editors, DAWs, notation editors, sound design tools, utilities right over to the latest AI tools or even desktop versions of browser-based services.

PreviousProduct TypesNextAdd Details

Last updated 2 months ago

MuseHub can distribute applications on macOS and Windows. Linux is not supported.

MuseHub is designed for music and audio creators. If your app falls into this demographic, then it's suitable for distribution on MuseHub.

Supported types

You can distribute application binaries in a few different ways. MuseHub installs applications through the use of a background service, which is called when it's required and may show UAC or ask for elevated privilieges from the user, depending on the requirements.

macOS

Application Bundles

If your application is a self-contained .app bundle, simply zip the .app and upload it to the Partner Portal. You can also use a .dmg disk image. However, if the .dmg is not correctly notarized, MuseHub's copying of the .app to the /Applications folder might cause the app to run under until GateKeeper considers it safe.

The recommended approach is to upload a ZIP archive of your application bundle.

Installers

MuseHub can install standard macOS .pkg installers. These installers run silently to provide a seamless experience for the user, which is recommended. However, if you wish to show the installer UI to the user, you can disable the "Silent Install" option.

Self-contained .app bundles can be uninstalled via the Hub, whereas applications delivered via a .pkg installer can not.

Bundle Identifiers

You'll need to provide the application's this can be found within the applications .plist file, and looks similar to com.muse.musehub

This bundleID is used by the Hub to ensure the application can be launched from the Hub properly, and is also used to track the installation state. It's important to provide the correct bundleID.

Windows

MuseHub supports installation of applications within .exe, .msi and .msix installer types. We recommend .msix as the best installation format for Windows, followed by .msi

MuseHub simplifies product acquisition, including the installation process. It can perform "silent" application installs, running installers without showing the UI for a seamless experience. You can disable silent install if user input is needed, though it’s not recommended.

MuseHub can also uninstall applications, even if delivered via an installer, as long as the provided installer type is capable.

Application IDs

Application IDs are mandatory for MSIX installers, and optional for MSI and EXE installers.

EXE or MSI: For these installers, the application id is optional but recommended. Without a valid id users will still be able to install and update your application via MuseHub, but enhanced functionality like version checking, launching, and uninstalling may be unavailable.

If you don't provide an application id, MuseHub will attempt to auto-discover it when a user is installing your application. This feature is quite conservative to avoid false positives, so there is no guarantee it will work.

Generally speaking, if in doubt about your application ID, leave it blank and MuseHub will detect it in most cases.

Manually finding your Application ID

EXE: Installers will refer to this field as the AppID or something similar, we have provided some examples for different installer technologies.

Technically speaking, MuseHub is after the Software\Microsoft\Windows\CurrentVersion\Uninstall\ registry key for your application (the key that makes it appear in Add/Remove Programs).

Here's some examples of what the id should look like. From internal testing, GUIDs (or the default generated ID) will tend to have {} brackets around the value before appending _is1.

  • Audacity_is1

  • {8AB81F47-272B-4C8B-9AA9-D29F6A36DDF4}}_is1

  • {52D4F102-D487-46F4-8DD8-738FD313BEAB}_is1

You probably know what it is already, use the Uninstall registry key.

This will probably be your Nuget package ID.

Use the name field within the installer configuration. If not provided, this defaults to the name field in your app's package.json file.

Automatically finding your Application ID

Alternatively, you can use the auto-discover feature mentioned above yourself to determine what value to place in this field. To do this, don't provide an application id and submit your product.

Once in-review or beta, open MuseHub and install your application, once installed, right-click the arrow next to the "Installed" or "Launch" button to find the detected application id.

MSIX: You must provide the package family name (for example Muse.MuseHub_rb9pth70m6nz6). See the for more information.

MSI: You must provide the for your MSI installer. It will look something like this: {141527EE-E28A-4D14-97A4-92E6075D28B2} . Please make sure you include the {} brackets around the id when submitting this to cosmos.

This is dependent on your installer build process and tools. See and for examples, but generally speaking, searching for "installer technology" + "UpgradeCode" should lead you to the right path.

See the documentation . You will find this value within the setup script (.iss). Make sure you append _is1 to the value specified.

Applications must meet the before they can be distributed on MuseHub

βž•
app translocation
bundle ID;
Microsoft Documentation
UpgradeCode
Wix
InstallShield
here
https://github.com/Squirrel/Squirrel.Windows/tree/develop
https://github.com/electron/windows-installer
Product Requirements
Detected application id for Audacity