---
name: "bsesh-0.6.2"
section: "1"
platform: "linux"
package: "beast"
version: "0.6.2-3"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/bsesh"
---

# bsesh-0.6.2(1)

A Guile based scheme shell for BEAST and BSE.

Part of [bsesh(1)](/bsesh/1.md).

## NAME

bsesh - A Guile based scheme shell for *BEAST* and *BSE*.

## SYNOPSIS

**bsesh** \[*OPTIONS*\] \[**--**\] ...

## DESCRIPTION

**bsesh** is a [guile(1)](/guile/1.md) 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)](/beast/1.md). 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.*

## SEE ALSO

*[guile(1)](/guile/1.md), [beast(1)](/beast/1.md), [sfidl(1)](/sfidl/1.md)*

*Document Revised: Wed Jul 7 19:55:34 2004*\