Skip to content

Tracks Module: Dictionary Registry + Most Methods and Properties #186

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
PhotonicVelocity wants to merge 17 commits into
base: master
Choose a base branch
from
Open

Tracks Module: Dictionary Registry + Most Methods and Properties #186

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
fe2b908
Add handler for creating midi and audio clips on tracks
jmiceo Nov 20, 2025
477a5b3
Clarified clip descriptions in README.md
jmiceo Nov 20, 2025
1fbbf3c
fix: duplicate_clip_to_arrangement passes clip instead of clip_slot
ldraney Jan 15, 2026
4c4d60e
Add create_audio_clip for clip slots
PhotonicVelocity Jan 28, 2026
d8c8d79
Add clip slot properties and improve property management
PhotonicVelocity Jan 29, 2026
351d750
added tests for all properties
PhotonicVelocity Jan 29, 2026
e6b3186
spelling
PhotonicVelocity Jan 29, 2026
7484d45
dictionary based methods and properties
PhotonicVelocity Feb 4, 2026
8a9f7d1
fix clip_slot logging format
PhotonicVelocity Feb 4, 2026
5dba069
Merge branch 'pr-168' into feat/tracks_refactor
PhotonicVelocity Feb 6, 2026
05445c6
Merge branch 'pr-172' into feat/tracks_refactor
PhotonicVelocity Feb 6, 2026
a57557f
updated to dictionary-based registry
PhotonicVelocity Feb 9, 2026
9985f04
Unified mixer props/params. Added track methods/props. Added tests.
PhotonicVelocity Feb 10, 2026
3246c5b
add routing properties
PhotonicVelocity Feb 10, 2026
db4c36b
added track view properties
PhotonicVelocity Feb 10, 2026
c487dff
add duplicate/clip_slot and jump_in_running_session_clip
PhotonicVelocity Feb 10, 2026
5000bf3
updated readme
PhotonicVelocity Feb 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
317 changes: 239 additions & 78 deletions README.md
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion abletonosc/__init__.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
from .song import SongHandler
from .clip import ClipHandler
from .clip_slot import ClipSlotHandler
from .track import TrackHandler
from .track import TrackHandler, TrackViewHandler
from .device import DeviceHandler
from .scene import SceneHandler
from .view import ViewHandler
Expand Down
122 changes: 85 additions & 37 deletions abletonosc/clip_slot.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,61 +7,109 @@ def __init__(self, manager):
self.class_identifier = "clip_slot"

def init_api(self):
def create_clip_slot_callback(func, *args, pass_clip_index=False):
def create_clip_slot_callback(func, *args, pass_clip_index=False, **kwargs):
def clip_slot_callback(params: Tuple[Any]):
track_index, clip_index = int(params[0]), int(params[1])
track = self.song.tracks[track_index]
clip_slot = track.clip_slots[clip_index]

if pass_clip_index:
rv = func(clip_slot, *args, tuple(params[0:]))
rv = func(clip_slot, *args, tuple(params[0:]), **kwargs)
else:
rv = func(clip_slot, *args, tuple(params[2:]))
rv = func(clip_slot, *args, tuple(params[2:]), **kwargs)

self.logger.info(track_index, clip_index, rv)
self.logger.info("clip_slot %s,%s -> %s", track_index, clip_index, rv)
if rv is not None:
return (track_index, clip_index, *rv)

return clip_slot_callback

methods = [
"fire",
"stop",
"create_clip",
"delete_clip"
]
properties_r = [
"has_clip",
"controls_other_clips",
"is_group_slot",
"is_playing",
"is_triggered",
"playing_status",
"will_record_on_start",
]
properties_rw = [
"has_stop_button"
]
methods = {
"fire": {"alias": 0, "caller": 1},
"stop": {"alias": 0, "caller": 1},
"create_clip": {"alias": 0, "caller": 1}, # Back-compat
"create/midi_clip": {"alias": 1, "caller": "create_clip"},
"create/audio_clip": {"alias": 1, "caller": "create_audio_clip"},
"delete_clip": {"alias": 0, "caller": 1}, # Back-compat
"delete/clip": {"alias": 1, "caller": "delete_clip"},
"duplicate_to": {"alias": 0, "caller": "clip_slot_duplicate_to"},
"set/fire_button": {"alias": 1, "caller": "set_fire_button_state"},
}

for method in methods:
self.osc_server.add_handler("/live/clip_slot/%s" % method,
create_clip_slot_callback(self._call_method, method))
properties = {
# TODO: returns objects, needs serialization
# "canonical_parent": {"get": 0, "set": 0, "listen": 0},
# "clip": {"get": 0, "set": 0, "listen": 0},

for prop in properties_r + properties_rw:
self.osc_server.add_handler("/live/clip_slot/get/%s" % prop,
create_clip_slot_callback(self._get_property, prop))
self.osc_server.add_handler("/live/clip_slot/start_listen/%s" % prop,
create_clip_slot_callback(self._start_listen, prop, pass_clip_index=True))
self.osc_server.add_handler("/live/clip_slot/stop_listen/%s" % prop,
create_clip_slot_callback(self._stop_listen, prop, pass_clip_index=True))
for prop in properties_rw:
self.osc_server.add_handler("/live/clip_slot/set/%s" % prop,
create_clip_slot_callback(self._set_property, prop))
# All clip slots
"has_clip": {"get": 1, "set": 0, "listen": 1},
"has_stop_button": {"get": 1, "set": 1, "listen": 1},
"is_group_slot": {"get": 1, "set": 0, "listen": 0},
"is_playing": {"get": 1, "set": 0, "listen": 0},
"is_recording": {"get": 1, "set": 0, "listen": 0},
"is_triggered": {"get": 1, "set": 0, "listen": 1},
"will_record_on_start": {"get": 1, "set": 0, "listen": 0},

# Group Track slots only
"color": {"get": 1, "set": 0, "listen": 1},
"color_index": {"get": 1, "set": 0, "listen": 1},
"controls_other_clips": {"get": 1, "set": 0, "listen": 1},
"playing_status": {"get": 1, "set": 0, "listen": 1},

def duplicate_clip_slot(clip_slot, args):

}

def clip_slot_duplicate_to(clip_slot, args):
target_track_index, target_clip_index = tuple(args)
track = self.song.tracks[target_track_index]
target_clip_slot = track.clip_slots[target_clip_index]
clip_slot.duplicate_clip_to(target_clip_slot)

self.osc_server.add_handler("/live/clip_slot/duplicate_clip_to", create_clip_slot_callback(duplicate_clip_slot))
# Add Handlers
local_funcs = locals()
for method, spec in methods.items():
alias = spec.get("alias")
caller = spec.get("caller")
if not caller:
continue
if not alias and isinstance(caller, str):
caller = local_funcs[caller]
self.osc_server.add_handler("/live/clip_slot/%s" % method,
create_clip_slot_callback(caller))
else:
if not alias:
caller = method
self.osc_server.add_handler("/live/clip_slot/%s" % method,
create_clip_slot_callback(self._call_method, caller))

for prop, spec in properties.items():
getter_func = spec.get("get")
if isinstance(getter_func, str):
getter = local_funcs[getter_func]
self.osc_server.add_handler("/live/clip_slot/get/%s" % prop,
create_clip_slot_callback(getter))
elif getter_func:
self.osc_server.add_handler("/live/clip_slot/get/%s" % prop,
create_clip_slot_callback(self._get_property, prop))

setter_func = spec.get("set")
if isinstance(setter_func, str):
setter = local_funcs[setter_func]
self.osc_server.add_handler("/live/clip_slot/set/%s" % prop,
create_clip_slot_callback(setter))
elif setter_func:
self.osc_server.add_handler("/live/clip_slot/set/%s" % prop,
create_clip_slot_callback(self._set_property, prop))

observable = spec.get("listen")
if isinstance(observable, str):
getter = "bang" if observable == "bang" else local_funcs[observable]
self.osc_server.add_handler("/live/clip_slot/start_listen/%s" % prop,
create_clip_slot_callback(self._start_listen, prop, pass_clip_index=True, getter=getter))
self.osc_server.add_handler("/live/clip_slot/stop_listen/%s" % prop,
create_clip_slot_callback(self._stop_listen, prop, pass_clip_index=True))
elif observable:
self.osc_server.add_handler("/live/clip_slot/start_listen/%s" % prop,
create_clip_slot_callback(self._start_listen, prop, pass_clip_index=True))
self.osc_server.add_handler("/live/clip_slot/stop_listen/%s" % prop,
create_clip_slot_callback(self._stop_listen, prop, pass_clip_index=True))
12 changes: 9 additions & 3 deletions abletonosc/handler.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,8 +61,13 @@ def _start_listen(self, target, prop, params: Optional[Tuple] = (), getter = Non
def property_changed_callback():
if getter is None:
value = getattr(target, prop)
elif getter == "bang":
value = 1
else:
value = getter(params)
try:
value = getter(target, params)
except TypeError:
value = getter(params)
if type(value) is not tuple:
value = (value,)
self.logger.info("Property %s changed of %s %s: %s" % (prop, self.class_identifier, str(params), value))
Expand All @@ -80,9 +85,10 @@ def property_changed_callback():
self.listener_functions[listener_key] = property_changed_callback
self.listener_objects[listener_key] = target
#--------------------------------------------------------------------------------
# Immediately send the current value
# Immediately send the current value (skip for bang-only listeners)
#--------------------------------------------------------------------------------
property_changed_callback()
if getter != "bang":
property_changed_callback()

def _stop_listen(self, target, prop, params: Optional[Tuple[Any]] = ()) -> None:
listener_key = (prop, tuple(params))
Expand Down
Loading