A tool to monitor Ableton Live and update the color of clips that have been played.
Project description
pylive-played-clip.py
Details
Original Author: Scott Selberg
Current Owner: Scott Selberg
Introduction
This is a python package that deploys a command line tool to monitor Ableton Live clips through AbletonOSC and pylive. When a clip finishes playing, this utility can change the color to visually flag the clip as having been played. When the global playback is stopped, the utility will reset all of the clips to the color they had before it changed them.
This was developed for a talent show at Foothills Elementary. We needed a way for an elementary student to control the sequencing of several dozen sound clips. In the past we've used iTunes, but it was a bit unresponsive and error prone. We'll be using a launchpad to trigger the clips and this utility will be running in the background to dim the color of the clips as they get played to make it easy to know which clips have been played and which is the next clip to play.
There is a similar utility created using MaxForLive created by AbletonDrummer. That 'device' costs $12 and I believe it requires MaxForLive or Ableton Live Suite which I think includes MaxForLive. I've only got the free Ableton Live Lite license that came with the LaunchPad. The AbletonOSC works fine with Ableton Live Lite 11.
How it works
AbletonOSC is a MIDI remote script that should be placed in Ableton's 'Remote Scripts' folder. As Ableton starts up, it will launch the script. This creates a listener program on the local computer where we can send messages that conform to the Live Object Model and it will convert them to the proper MIDI syntax and pass it into Ableton.
The same group that makes AbletonOSC also maintain a python library, pylive, that makes it easy to send messages to the listener.
This project builds on top of pylive to create a background program that will monitor Ableton and when a clip finishes playing, it will change the color of that clip. The program can either set the clip to a pre-defined value, such as dark grey, or it can 'dim' the original color.
Installation
First, install Python version 3.8 or above. This is likely to be preinstalled on a linux or MacOS machine. There are plenty of install instructions on the internet for Windows.
Next, you will need to install AbletonOSC.
This involves downloading a zip file and unpacking it into
.../Ableton/User Library/Remote Scripts
. On my system, I had to create the
directory Remote Scripts
, but the rest was created by Ableton. After
putting the files in place, I had to restart Ableton, locate the 'Link|Tempo|Midi'
preferences and add AbletonOSC
as a controller. The
AbletonOSC home page has detailed
instructions on the process.
Lastly, you will need to install pylive-played-clip
. The python package
creates a command line script that you can use to launch the utility. On
Windows, it will only have permissions to setup the utility if you install the
package as an administrator. On linux and macOS, the user install will also
setup the utility.
> pip install pylive-played-clip
Using
To use, Ableton should already be up and running. Then from a console launch pylive-played-clip as shown below.
> pylive-played-clip
If you installed on Windows as a regular user, the command line script will not be setup because of permissions issues, but you can still launch it by calling python first as shown below.
> python -m pylive_played_clip
Command Line Options
The command line utility has the following options:
- --dim-color FFFFFF: This is the fixed color that played clips should receive. We're using the standard web notation for colors without the leading '#' symbol.
- --dim-ratio 2: If a dim-color is not specified, we'll take the original color and in the HSB space divide the brightness by this number. A value of 2 should reduce the brightness of the clip by half, but have the same hue and saturation.
- --polling-delay: The utility will scan all of the tracks for playing clips, wait this amount of time, and then re-scan. Should it detect that a clip was playing in the previous scan but not playing in the current scan, the color will be changed.
Examples
All played clips will be set to dark gray:
> pylive-played-clip --dim-color 555555
All played clips will be dimmed by 25%:
> pylive-played-clip --dim-ratio 4
License
BSD 3-Clause
Author Information
Scott Selberg
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pylive_played_clip-1.1.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 15a3e3442d214979ce4d4d310a4ab0cc307e019cbae172f26478c29c4f5af449 |
|
MD5 | 4a1464f15a1f5e30fab7583965ca11a9 |
|
BLAKE2b-256 | 7447fbd1db6d2f3b400d14c5d1ad729430112d20393c0ffe9588b950696df5d0 |