C IRMMT L ive E lectronics F ramework

Copyright © Marlon Schumacher (DCS/CIRMMT/McGill University), 2009-2014.

Contributions by Sean Ferguson, Geof Holbrook, Graham Boyes.
Thanks to Eliot Britton for the Getting-Started.pdf

CLEF project page: https://sourceforge.net/projects/clef/
CLEF mailing list: https://lists.sourceforge.net/lists/listinfo/clef-users

---

CLEF is a modular framework for composition and performance of live-electronic music. It is based on the concept of classes of Modules for media generation/processing which can be instantiated and connected to each other. Temporal data is organized into Events, which serves as data containers or small sub-programs which be organized in time, sequentially (e.g. as cue lists), or following any other logic. CLEF is implemented according to the Model-View-Controller (MVC) design pattern. CLEF can be controlled textually (similar to a scripting language) or using the provided (or custom-made) graphical user interfaces.

All communication is handled via OpenSoundControl messages on a shared bus. CLEF uses Max dictionaries for module description (meta data) and the pattr-system for preset management of run-time data.

Features:

• more than 50 DSP Modules
• All modules automatically connected in a centralized dsp-matrix
• All parameters exposed to pattr (storage, interpolation, etc.)
• Full OSC pattern-matching on shared message bus
• Use of Graphical Inspectors for run-time control and persistent data storage
• Use of Graphical Widgets for specification of (temporal) control data
• Electronic Score organized into Cues and Events. Events are containers for control-data, visual programs or temporal data

---

CLEF is distributed under GNU Lesser General Public License (GPL) Version 3.
For more information see http://www.gnu.org/licenses/gpl.html.

Dependencies:
Cycling 74's MAX software: http://cycling74.com/products/max/
[OSC-route] Max external (64Bit version), developed at the Center for New Music and Audio Technologies (CNMAT) at the University of California, Berkeley. It can be downloaded from http://cnmat.berkeley.edu/max

DISCLAIMER:
This software is provided 'as-is', without any express or implied warranty.
It has been tested on MacOS > 10.6 and requires MaxMSP > 6.1.

---

Installation:

• copy CLEF folder into ~/Documents/Max/Packages
• add the [osc-route] external to Max's search path

---

Version History

Release version : 0.31
Release Date : 2013/11/03

• Fixed minor bugs in clef.osc-lane.absolute and clef.osc-lane.relative (menus for osc-address selection will not loose their contents when closing)
• clef.osc-lane will be in "read" mode by default (i.e. output its data) without the need of selecting it manually from the menu
• Added more clippings for module inspectors
• Added clipping "gui.pattr" for graphical access a module's pattr interface

---

Release version : 0.3
Release Date : 2013/10/13

• CLEF is now distributed as a Max package (introduced in Max6.1)
• Added clippings and prototypes for common inspectors and widgets
• clef.tactuator module for tactile notifications to a performer
• miscellaneous improvements

---

Release version : 0.25
Release Date : 2013/01/30

• new modules:
  • clef.nodes module
  • clef.spat~ inspector module
  • clef.libMapper module
  • clef.osc-lane.absolute
  • clef.osc-lane.relative
• updates:
  • clef.routing.wgt
  • clef.event-top-panel
• misc. fixes and improvements

---

Release Version : v0.24
Release Date : 2012/10/28

• removed ejies dependency
• new graphical connections inspector

---

Release Version : v0.231
Release Date : 2011/10/28

• soundfile player guis now have a cue-bar and power buttons
• improved Modules-tester

---

Release Version : v0.23
Release Date : 23/02/2010

• player guis now work for Players of any number of channels
• improved guis for Cues
• introduced instances-files for saving/loading a collection of instances
• introduced CLEF projects, saving Cues, Instances, and Settings
• introduced menubar (switchable between 'performance' and 'composition' modes)
• VIEWs: Performance, Modules, Events
• Surround Meters (a window showing all outputs)
• Input Meterbridge : monitor all the available inputs in the dsp-network with in-level-control and power-switches
• Output Meterbridge : monitor all the available outputs in the dsp-network with out-level-control and power-switches
• introduced Floating Inspectors:
• Connections Inspector (new)
• Instances Inspector (new)
• Window properties for the GUI:
  • Floating Windows
  • Transparent Windows
  • Always on Top
  • introduced keyboard shortcuts for fast access of Views, Meterbridges, floating inspectors and setting of Window properties
• new Modules:
  • 5bandEQ: biquad-based 5-band EQ (Lowshelf, 3 parametric mids, Hishelf)
  • Aux-Bus: a generic aux-bus for mixing/routing purposes

---

Release Version : v0.2
Release Date : 02/12/2010

• changed the default vectorsizes for audio settings to 256 samples
• player guis now work for both tereo and Mono-Players
• corrected the clef.ngverb~
• included ejies in distr. as a .zip file.