Metadata-Version: 2.4
Name: ableton-live-stubs
Version: 12.1.0
Summary: PEP 561 type stubs for Ableton Live's Python API (for MIDI Remote Script developers)
Project-URL: Homepage, https://github.com/PhotonicVelocity/LiveAPI
License-Expression: MIT
Keywords: ableton,live,stubs,typing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Typing :: Stubs Only
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# ableton-live-stubs

PEP 561 type stubs for Ableton Live 12.1.0's Python API (`Live.*` modules).

These stubs are for developers building **MIDI Remote Scripts** (Control Surfaces) that run inside
Ableton Live's embedded Python runtime. They provide type information for the `Live` module that Live
exposes to scripts at runtime but is not available for static analysis outside of Live.

## Installation

```
pip install ableton-live-stubs
```

## Usage

Once installed, type checkers (pyright, mypy) automatically discover the `Live` module stubs.
No configuration needed.

```python
from Live.Application import Application
from Live.Song import Song
from Live.Track import Track
```

## Manual setup (without pip)

Download the zip from the
[GitHub release](https://github.com/PhotonicVelocity/LiveAPI/releases/tag/v12.1.0)
and add the extracted `Live/` directory to your type checker's search path:

```json
// pyrightconfig.json
{
  "extraPaths": ["path/to/Live-stubs"]
}
```

## Version matching

Each release of `ableton-live-stubs` corresponds to a specific Ableton Live version. Install the
version that matches your target Live version — the API surface changes between releases.

## Documentation

For detailed API documentation — including property restrictions (e.g. which track/clip types support
a given property), valid input ranges, and observable properties — see the
[LiveAPI reference](https://photonicvelocity.github.io/LiveAPI/).

## Source

Generated from runtime introspection of Ableton Live 12.1.0.
See [LiveAPI](https://github.com/PhotonicVelocity/LiveAPI) for details.
