{"id":13862319,"url":"https://github.com/ideoforms/pylive","last_synced_at":"2025-07-14T11:33:21.495Z","repository":{"id":40267332,"uuid":"11980609","full_name":"ideoforms/pylive","owner":"ideoforms","description":"Query and control Ableton Live from Python","archived":false,"fork":false,"pushed_at":"2024-09-23T18:41:47.000Z","size":328,"stargazers_count":504,"open_issues_count":10,"forks_count":66,"subscribers_count":22,"default_branch":"master","last_synced_at":"2024-11-09T01:38:52.444Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ideoforms.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-08-08T16:11:26.000Z","updated_at":"2024-11-08T12:11:35.000Z","dependencies_parsed_at":"2024-08-05T06:14:51.660Z","dependency_job_id":null,"html_url":"https://github.com/ideoforms/pylive","commit_stats":{"total_commits":188,"total_committers":7,"mean_commits":"26.857142857142858","dds":"0.037234042553191515","last_synced_commit":"2ab38079fcead9b1f8bbacbf80bfd18a6a1a0861"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ideoforms%2Fpylive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ideoforms%2Fpylive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ideoforms%2Fpylive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ideoforms%2Fpylive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ideoforms","download_url":"https://codeload.github.com/ideoforms/pylive/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225974427,"owners_count":17553953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-05T06:01:41.799Z","updated_at":"2025-07-14T11:33:21.487Z","avatar_url":"https://github.com/ideoforms.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# PyLive\n\nPyLive is a framework for querying and controlling Ableton Live from a standalone Python script, mediated via Open Sound Control. Internally, it uses the same API as a Live Control Surface, which means it can do anything that a hardware control surface can do, including:\n\n - query and modify global parameters such as tempo, volume, pan, quantize, arrangement time\n - query and modify properties of tracks, clips, scenes and devices\n - trigger and stop clips and scenes\n\nIt can perform many of the operations described in the [AbletonOSC API](https://github.com/ideoforms/AbletonOSC). More comprehensive feature coverage is a work-in-progress.\n\nIf you are looking simply to send MIDI messages to Live, this module is not what you want. Instead, try setting up a [virtual MIDI bus](https://help.ableton.com/hc/en-us/articles/209774225-How-to-setup-a-virtual-MIDI-bus) and using [isobar](https://ideoforms.github.io/isobar/) to generate MIDI sequences.\n\n**Note for legacy users:** As of 2023, pylive has been updated to interface exclusively with [AbletonOSC](https://github.com/ideoforms/AbletonOSC) for Live 11 support. Legacy LiveOSC is no longer supported beyond [v0.2.2](https://github.com/ideoforms/pylive/releases/tag/v0.2.2).\n\n## Requirements\n\n* [Ableton Live 11+](http://www.ableton.com/live)\n* [Python 3.7+](http://www.python.org)\n* [AbletonOSC](https://github.com/ideoforms/AbletonOSC)\n\n## Installation\n\nFrom PyPi:\n\n```\npip3 install pylive\n```\n\nOr to install the latest (pre-release) code from git:\n```\ngit clone https://github.com/ideoforms/pylive.git\ncd pylive\npython3 setup.py install\n```\n\nTo check that pylive is communicating successfully with Ableton Live, try running one of the [examples](examples), or run the test suite with:\n```\npython3 setup.py test\n```\n\n## Usage\n\n```python\n#------------------------------------------------------------------------\n# Basic example of pylive usage: connect to the Live set, trigger a clip,\n# and modulate some device parameters.\n#------------------------------------------------------------------------\nimport live\nimport random\n\n#------------------------------------------------------------------------\n# Query the set's contents, and set its tempo to 110bpm.\n#------------------------------------------------------------------------\nset = live.Set(scan=True)\nset.tempo = 110.0\n\n#------------------------------------------------------------------------\n# Each Set contains a list of Track objects.\n#------------------------------------------------------------------------\ntrack = set.tracks[0]\nprint(\"Track name '%s'\" % track.name)\n\n#------------------------------------------------------------------------\n# Each Track contains a list of Clip objects.\n#------------------------------------------------------------------------\nclip = track.clips[0]\nprint(\"Clip name '%s', length %d beats\" % (clip.name, clip.length))\nclip.play()\n\n#------------------------------------------------------------------------\n# Mdulate the parameters of a Device object.\n#------------------------------------------------------------------------\ndevice = track.devices[0]\nparameter = random.choice(device.parameters)\nparameter.value = random.uniform(parameter.min, parameter.max)\nprint(\"Randomising parameter %s of device %s\" % (parameter, device))\n```\n\n## Overview\n\nTo begin interacting with an Ableton Live set, the typical workflow is as follows. Live should normally be running on localhost, with LiveOSC enabled as a Control Surface.\n\n* Create a `live.Set` object, passing `scan=True` to automatically index the tracks, clips and devices within the set\n* Interact with Live by setting and getting properties on your `Set`:\n  * `set.tempo`, `set.time`, `set.overdub` are global Set properties\n  * `set.tracks` is a list of Track objects\n  * `set.tracks[N].name`, `set.tracks[N].mute`, are Track properties\n  * `set.tracks[N].clips` is a list of Clip objects (with empty slots containing `None`)\n  * `set.tracks[N].devices` is a list of Device objects\n  * `set.tracks[N].devices[M].parameters` is a list of Parameter objects\n\nGetters and setters use Python's `@property` idiom, meaning that accessing `set.tempo` will query or update your Live set.\n\nIf you know that no other processes will interact with Live, set `set.caching = True` to cache properties such as tempo. This will query the Live set on the first instance, and subsequently return locally-stored values.\n\nFor further help, see `pydoc live`.\n\n## Classes\n\n* `Set`: Represents a single Ableton Live set in its entirety. \n* `Track`: A single Live track object. Contains `Device` and `Clip` objects. May be a member of a `Group`.\n* `Group`: A grouped set of one or more `Track` objects.\n* `Device`: An instrument or audio effect residing within a `Track`. Contains a number of `Parameter` objects.\n* `Parameter`: An individual control parameter of a `Device`, with a fixed range and variable value.\n\n## Limitations\n\nNote that pylive is not intended for sending MIDI note events or control messages to a set. For MIDI controls, use a separate module such as [mido](https://mido.readthedocs.io).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fideoforms%2Fpylive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fideoforms%2Fpylive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fideoforms%2Fpylive/lists"}