Metadata-Version: 2.3
Name: abletonosc-client
Version: 1.1.0
Summary: Python OSC client wrapper for AbletonOSC - control Ableton Live via OSC
License: MIT
Keywords: ableton,osc,music,midi,live
Author: ldraney
Requires-Python: >=3.11
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: python-osc (>=1.8.0)
Project-URL: Homepage, https://github.com/ldraney/abletonosc-client
Project-URL: Repository, https://github.com/ldraney/abletonosc-client
Description-Content-Type: text/markdown

# abletonosc-client

Python OSC client wrapper for AbletonOSC - control Ableton Live via OSC.

## Installation

```bash
pip install abletonosc-client
```

## Requirements

- Python 3.11+
- Ableton Live with [AbletonOSC](https://github.com/ideoforms/AbletonOSC) installed

## Quick Start

```python
from abletonosc_client import connect, Song, Track

# Connect to Ableton Live
client = connect()

# Control the song
song = Song(client)
song.set_tempo(120.0)
song.start_playing()

# Work with tracks
track = Track(client)
track.set_name(0, "My Track")
track.set_volume(0, 0.8)
```

## Features

- **Application**: Version info, reload script, log level, status bar messages
- **Song**: Tempo, transport, time signature, tracks, scenes, loops, recording, quantization, cue points, key/scale
- **Track**: Volume, pan, mute, solo, arm, color, routing, monitoring, meters, device management, sends
- **Clip**: Notes (add/get/remove), properties (loop, warp, gain, pitch), launch/stop
- **ClipSlot**: Create/delete/duplicate clips, launch, stop
- **Device**: Parameters (get/set by index or name), enable/disable, device info
- **Scene**: Name, color, tempo, time signature, launch
- **View**: Track/scene/clip/device selection, view focus
- **Listeners**: Real-time callbacks for tempo, transport, loop, record, beat, song time, track properties

## Documentation

See [CLAUDE.md](CLAUDE.md) for detailed documentation.

## License

MIT

