1.1.1 Scheme sandbox

The LilyPond installation includes the Guile implementation of Scheme. On most systems you can experiment in a Scheme sandbox by opening a terminal window and typing ‘guile’. On some systems, notably Windows, you may need to set the environment variable GUILE_LOAD_PATH to the directory ../usr/share/guile/1.8 in the LilyPond installation. For the full path to this directory see Other sources of information. Alternatively, Windows users may simply choose ‘Run’ from the Start menu and enter ‘guile’.

However, a hands-on Scheme sandbox with all of LilyPond loaded is available with this command line:

lilypond scheme-sandbox

Once the sandbox is running, you will receive a guile prompt:


You can enter Scheme expressions at this prompt to experiment with Scheme. If you want to be able to use the GNU readline library for nicer editing of the Scheme command line, check the file ‘ly/scheme-sandbox.ly’ for more information. If you already have enabled the readline library for your interactive Guile sessions outside of LilyPond, this should work in the sandbox as well.

LilyPond — Extending v2.21.82 (development-branch).