ableton-detect

Get information from installed Ableton Live instances

ableton-detect scans application folders and returns an array of all installed Ableton Live instances. For every detected instance, it attempts to read the versions, varients (eg. Suite), architectures, ableton licences, addon licences, serial numbers and more, reporting any issues it encounters.

During scanning, a number of checks are performed to detect broken or damaged installations. Any issues found while running compatibility checks are reported in the output object's .error array.

This package exports an ES module and requires Node 15+ and macOS.

Examples

Basic example:

import getAbletons from '@stonegray/ableton-detect'

console.log(await getAbletons());

Output:

[
    {
    relPath: 'Ableton Live 10 Lite.app',
    absPath: '/Applications/Ableton Live 10 Lite.app',
	hidden: false,
    version: SemVer {
      raw: '10.1.25',
      major: 10,
      minor: 1,
      patch: 25,
      prerelease: [],
      build: [],
      version: '10.1.25'
    },
    fullVersion: '10.1.25 (2020-10-01_995d768242)',
    minSystemVersion: '10.11.6',
    variant: 'Lite',
    icon: '/Applications/Ableton Live 10 Lite.app/Contents/Resources/app.icns',
    ok: true,
    errors: [],
    arch: [ 'x64' ],
    addons: [
      {
        productId: '40',
        licenceId: 1,
        versionCode: 16,
        serial: '37B6-7A82-3991-4943-8AEE-617E',
        distrobutionType: 80
      }
      /* ... 271 more items */
    ],
    licence: {
      logicalId: 0,
      licenceId: 0,
      versionCode: 160,
      productId: '04',
      serial: '51A8-6AE6-DFDB-8C40-E26E-500F',
      distrobutionType: 80,
      responseCode: 'AC9F5F44DC8A8D18AFE9A9B2FF7A00407A2543EFD57F1F9E310726723BF7E34493A80D980394449D'
    }
]

Licences

This library provides experimental support for reading licences. Currently, it provides the following information about the Ableton licence, as well as any installed addons:

• SerialNumber (version 0.0.8+)
• ProductID
• ProductVersion (version 0.0.11+)
• DistrobutionType
• ResponseCode (version 0.0.11+)
• Logical ID (16-bit integer, position in internal database)

Example uses of this information:

• Checking that the user has access to a certain feature
• Licencing your software by tying it to a unique Ableton seat
• Verifying that the software is genuine

Additional fields (such as Buffer instances of serials) are included in the output but not shown in the example above.

Licences are stored in the AB1E5678 (.cfg) files, which I don't have any documentation for. The current code to read the file format works, but should be rewriten.

Licences are stored on the system by version, so the licences array for all varients of the same version will share the Addons field.

For testing, an example Ableton serial number, licence database, and activation file (.auz) is provided in ./resources. This code is for testing only, it won't work to activate Ableton (obviously!)

Windows Support

ableton-detect uses many macOS specific methods to achieve what it does, such as reading Mach-O headers, parsing Info.plist files, and reading information in .apps. These cannot be simply ported to Windows, and retrieving the same information would require a complete rewrite. If somebody else is willing to figure out how to collect the same data on Windows I think it would be great to add support.

Projects using ableton-detect

Ableton Licence Backup [npm] [github] Extracts the Ableton licences you currently have activated on your machine, and exports them to an Ableton offline authorization (.auz) file, which can be used to reactivate all of the same products and addons in the future, without using the ableton website.

Made something neat with this library? File an issue or submit a PR!