bsesh-0.6.21

Usage

Overview

bsesh is a guile(1) based scheme shell for BSE, the Bedevilled Sound Engine.

bsesh provides a shell interface to all procedures exported by the BSE library, so scripts are able to access the full range of functionality provided by it, from simple playback of a .bse file to full fledged automated creation or editing of synthesis networks.

Alternatively to the linked in BSE library, the bsesh language interface can also talk to a remotely running BSE library host, for instance beast(1). By operating on a remotely running BSE core, bsesh can be used to script arbitrary BSE programs. The shell is also used directly by the BSE library to execute procedures on its behalf, this allows BSE procedures to be written in scheme.

When started, bsesh tests whether the first non-option argument is a .bse file and if the test succeeds, attempts to play the command line arguments as .bse files.

Options

bsesh follows the usual GNU command line syntax, with long options starting with two dashes (`-').

--bse-pipe INFD OUTFD

Provide the input and output communication filedescriptors for remote operation.

--bse-eval STRING

Execute (eval-string STRING) instead of going into interactive mode.

--bse-enable-register

Allowes registration of procedures with the BSE core.

--bse-no-load

Prevent automated loading of plugins and scripts at startup time in interactive mode.

--bse-no-play

Prevent automated detection and playback of .bse file command line arguments.

--g-fatal-warnings

Make runtime warnings fatal (abort).

--help

Describe command line options and exit.

--version

Display version and exit.

Guile Options:

-l FILE

Load scheme source code from file.

-e FUNCTION

After reading script, apply FUNCTION to command-line arguments.

-ds

Do -s SCRIPT at this point (note that this argument must be used in conjuction with -s).

--debug

Start with debugging evaluator and backtraces enabled (useful for debugging scripts).

--emacs

Enable emacs protocol for use from within emacs (experimental).

The remaining Guile options stop argument processing, and pass all remaining arguments as the value of (command-line):

--

Stop argument processing, start in interactive mode.

-c EXPR

Stop argument processing, evaluate EXPR as a scheme expression.

-s SCRIPT

Load Scheme source from SCRIPT and execute as a script.