Licensing

Internal licensing and authorization plumbing used by Live’s startup and trial flows. The PythonLicensingBridge class drives session and product identification, and ProgressDialog provides the modal UI shown during authorization activity.

Classes

ProgressDialog

A modal dialog showing a message and a progress animation. ^{From Live’s runtime docstring.}

Methods

end_modal_loop()

run_in_modal_loop()

set_status_message()

Parameters

msg: str

Returned by 1 member elsewhere in the LOM

PythonLicensingBridge

get_progress_dialog() → ProgressDialog

PythonLicensingBridge

Interface to the internal licensing services. ^{From Live’s runtime docstring.}

Properties

base_product_id: str^{high confidencedocstring “Returns Live’s current base product ID” — product IDs are string identifiers.}

Returns Live’s current base product ID. ^{From Live’s runtime docstring.}

in_sassafras_mode: bool^{low confidenceprobe property name pattern “in X mode” suggests boolean. No raw_doc, no usage snippets, no M4L doc — pure naming inference. Watch for drift if a probe ever reaches this property.}

license_must_match_variant: bool^{high confidencedocstring “Returns a bool indicating if we require…” — explicitly typed bool.}

Returns a bool indicating if we require the license information returned by the server to match the variant of Live. ^{From Live’s runtime docstring.}

random_number_for_trial_authorization: int^{high confidencedocstring “Returns the integer to send along with the Trial authorization request”.}

Returns the integer to send along with the Trial authorization request. This same integer will be checked for in process_trial_response (and then changed). ^{From Live’s runtime docstring.}

set_has_unsaved_changes: bool^{high confidencedocstring “Returns true if the set has unsaved changes” — explicitly bool.}

Returns true if the set has unsaved changes. ^{From Live’s runtime docstring.}

Methods

authorize_with_sassafras()

create_new_live_set()

Creates a new live set and discards unsaved changes. ^{From Live’s runtime docstring.}

deauthenticate_user()

Deletes the current session ID. ^{From Live’s runtime docstring.}

get_progress_dialog()

Returns

ProgressDialog

Retrieves an instance of ProgressDialog. ^{From Live’s runtime docstring.}

get_session_id()

Returns

str

Retrieve stored session ID. ^{From Live’s runtime docstring.}

get_startup_dialog()

Parameters

authorize_callable:
Callable^{Probed asobjecthigh confidencedocstring “callables connected to its buttons” — both args are callback functions.}
authorize_later_callable:
Callable^{Probed asobjecthigh confidencedocstring “callables connected to its buttons” — both args are callback functions.}

Returns

StartupDialog

Retrieves an instance of the startup dialog with the passed callables connected to its buttons. ^{From Live’s runtime docstring.}

get_trial_time_left()

Returns

str

Returns remaining time on a trial as a formatted string. ^{From Live’s runtime docstring.}

invoke_pack_installation_callback()

Call package installation callback. ^{From Live’s runtime docstring.}

load_and_convert_legacy_unlock_cfg()

Returns

dict[str, Any]^{Probed asdicthigh confidencedocstring “Loads the Unlock.cfg file and returns either an empty dict or one that can be converted to an UnlockData object.”
C++ signature explicitly returns boost::python::dict.
probe the dict’s keys/values aren’t enumerated in the docs (varies with the legacy cfg format), so dict[str, Any] is the honest parameterization.}

Loads the Unlock.cfg file and returns either an empty dict or one that can be converted to an UnlockData object. ^{From Live’s runtime docstring.}

process_license_response()

Parameters

license_response_lines:
list[str]^{Probed aslisthigh confidencedocstring “list of strings, each representing a server response”.}

Returns

UnlockStatus

Processes a list of strings, each representing a server response to a product authorization. ^{From Live’s runtime docstring.}

process_trial_response()

Parameters

trial_response_line: str

Returns

bool

Process the server’s response to a Trial authorization. ^{From Live’s runtime docstring.}

request_exit()

Parameters

exit_code: int = 0

save_current_set()

Saves the current Live session. ^{From Live’s runtime docstring.}

set_network_timer()

Parameters

callback:
Callable | None^{Probed asobjecthigh confidencedocstring “Pass None as callback to stop the timer”.}
interval_in_ms: int

Starts or stops a timer meant for driving network operations. Pass None as callback to stop the timer. If any callback invocation raises an exception, the timer is stopped. ^{From Live’s runtime docstring.}

store_session_id()

Parameters

session_id: str

Securely stores the user’s session ID (aka cookie, aka credentials). ^{From Live’s runtime docstring.}

StartupDialog

Serves as an entry point for the user to authorize Live on first launch. ^{From Live’s runtime docstring.}

Methods

end_modal_loop()

run_in_modal_loop()

Parameters

show_only_offline_auth_instructions: bool

set_notification_message()

Parameters

notification_text: str
show_progress_bar: bool

Returned by 1 member elsewhere in the LOM

PythonLicensingBridge

get_startup_dialog() → StartupDialog

UnlockStatus

Returns relevant information after unlock ^{From Live’s runtime docstring.}

Properties

authorization_deactivated: bool

authorization_expired: bool

has_max_unlock_products: bool

temp_demo_mode: bool

time_limited: bool

unlock_error: bool

unlocked: bool

Returned by 1 member elsewhere in the LOM

PythonLicensingBridge

process_license_response() → UnlockStatus

Enums

TrialContext

Members

`SAVE`	0
`FORCE_UPDATE`	2
`STARTUP`	3

Functions

authorization_clock_days_ahead()

Returns

int

Advances the current date by the number of days specified by _AuthClockDaysAhead ^{From Live’s runtime docstring.}

get_authorization_page_url()

Parameters

reauthorize: bool
is_trial: bool

Returns

str

Retrieves the appopriate URL on ableton.com where the unser can initiate the authorization. ^{From Live’s runtime docstring.}

get_purchase_live_url()

Returns

str

Returns the environment-aware purchase URL for purchasing Live licenses ^{From Live’s runtime docstring.}

get_services_url()

Returns

str

Returns the URL against which service calls (e.g. for authorization) can be performed. ^{From Live’s runtime docstring.}

get_unlock_dir()

Returns

tuple[str, bool]^{Probed astuple[object, …]high confidencedocstring “Returns a tuple containing the unlock file directory and a flag” — directory is str, flag is bool.
probe probe stamps tuple with element_reprs [str, bool]; this refinement narrows to the fixed-position tuple shape.}

Returns a tuple containing the unlock file directory and a flag indicating if the unlock file is in the system domain. ^{From Live’s runtime docstring.}

launch_web_browser()

Parameters

url: str

Opens a web browser at the specified URL on the user’s computer. ^{From Live’s runtime docstring.}

This is an independent reference site. Not affiliated with, endorsed by, or sponsored by Ableton AG. “Ableton”, “Live”, “Push”, and related marks are trademarks of Ableton AG.

Licensing

Classes

ProgressDialog

Methods

end_modal_loop()

run_in_modal_loop()

set_status_message()

PythonLicensingBridge

Properties

base_product_id: strhigh confidencedocstring “Returns Live’s current base product ID” — product IDs are string identifiers.

in_sassafras_mode: boollow confidenceprobe property name pattern “in X mode” suggests boolean. No raw_doc, no usage snippets, no M4L doc — pure naming inference. Watch for drift if a probe ever reaches this property.

license_must_match_variant: boolhigh confidencedocstring “Returns a bool indicating if we require…” — explicitly typed bool.

random_number_for_trial_authorization: inthigh confidencedocstring “Returns the integer to send along with the Trial authorization request”.

set_has_unsaved_changes: boolhigh confidencedocstring “Returns true if the set has unsaved changes” — explicitly bool.

Methods

authorize_with_sassafras()

create_new_live_set()

deauthenticate_user()

get_progress_dialog()

get_session_id()

get_startup_dialog()

get_trial_time_left()

invoke_pack_installation_callback()

load_and_convert_legacy_unlock_cfg()

process_license_response()

process_trial_response()

request_exit()

save_current_set()

set_network_timer()

store_session_id()

StartupDialog

Methods

end_modal_loop()

run_in_modal_loop()

set_notification_message()

UnlockStatus

Properties

authorization_deactivated: bool

authorization_expired: bool

has_max_unlock_products: bool

temp_demo_mode: bool

time_limited: bool

unlock_error: bool

unlocked: bool

Enums

TrialContext

Members

Functions

authorization_clock_days_ahead()

get_authorization_page_url()

get_purchase_live_url()

get_services_url()

get_unlock_dir()

launch_web_browser()

base_product_id: str^{high confidencedocstring “Returns Live’s current base product ID” — product IDs are string identifiers.}

in_sassafras_mode: bool^{low confidenceprobe property name pattern “in X mode” suggests boolean. No raw_doc, no usage snippets, no M4L doc — pure naming inference. Watch for drift if a probe ever reaches this property.}

license_must_match_variant: bool^{high confidencedocstring “Returns a bool indicating if we require…” — explicitly typed bool.}

random_number_for_trial_authorization: int^{high confidencedocstring “Returns the integer to send along with the Trial authorization request”.}

set_has_unsaved_changes: bool^{high confidencedocstring “Returns true if the set has unsaved changes” — explicitly bool.}