SuperCollider CLASSES


register actions to be taken for a server
Inherits from: AbstractSystemAction : Object


This is an abstract superclass for singletons like ServerQuit, which provides a place for registering functions and objects for events that should happen when something happens in the server. No direct call to AbstractServerAction is required.

NOTE: not fully working on Linux and windows. Setting the computer to sleep on these systems causes the actions to be called. As to date in Linux, JACK does not survive a sleep, it nevertheless behaves correctly for the time being.

Class Methods


Subclasses return specific function selectors for objects that implement this as interface. Selectors are:

not for registry with a server, but analogous are:

*add (object, server)

Add an action or object for registry.



Can either be a Function to be evaluated (as first arg the server is passed in), or an Object that implements the message returned by -functionSelector. One object is only registered once, so that multiple additions don't cause multiple calls.


Server for which to register. If the symbol \default is passed in, the action is called for the current default server. If the symbol \all is passed in, the action is called for all current servers. If server is nil, it is added to \default.

*remove (object, server)

Remove an item or object from registry. If server is nil, remove from default key.

*removeServer (server)

Remove all items that are registered for a given server.

Inherited class methods

Undocumented class methods

*addToAll (object)

*performFunction (server, function)

*run (server)

Instance Methods

Inherited instance methods


// ServerBoot
f = { |server| "------------The server '%' has booted.------------\n".postf(server) };
ServerBoot.add(f, \default);
s.quit; // quit the server and observe the post
ServerBoot.remove(f, \default); // remove it again
s.boot;// no post.
ServerBoot.add(f, Server.internal);
ServerBoot.removeAll; // clear all
// ServerQuit
f = { |server| "------------The server '%' has quit.------------\n".postf(server) };
ServerQuit.add(f, \default);
s.quit; // quit the server and observe the post
ServerQuit.remove(f, \default); // remove it again
s.quit; // no post.
ServerQuit.add(f, Server.internal);
ServerQuit.removeAll; // clear all
// ServerTree
f = { |server| "-------The server '%' has initialised tree.-------\n".postf(server) };
g = { |server| { Group(server).postln } };
ServerBoot.add(f, \default);
ServerTree.add(g, \default);
s.boot; // boot and see how the actions are evaluated in order
// "cmd-period" (or equivalent) resends the groups.

ServerBoot.removeAll; // clear all
ServerTree.removeAll; // clear all