Getting Started

System Requirements

Lambda Music Sequencer (hereinafter abbreviated as Lamu) can run any operating systems that can run the following systems: - Java 8

Lamu has been developed and tested in Ubuntu 16.04. It runs under Windows 10 successfully. Running under OS X is still not tested; it should work as well operation systems.

Lamu uses following libraries :

These are statically linked and packed to lamu.jar.

How to Install

Prerequisites

Lamu requires Java8 and JACKAudio Connection Kit. These libraries should have properly installed on your environment before executing lamu.jar.

After the libraries are installed, download the lamu.jar from lamu.jar on the MASTER branch

Lamu is packed into an executable JAR file and no installation is required.
Just place the file any directory; preferably, it has better to be placed on a directory which is on the $PATH list.

How to Run

In a shell command prompt, execute

> java -jar /the-path-to-the-file/lamu.jar

In most platforms, you can also execute the application by double-clicking on the file in your file-browser.

Command-line Parameter

Specifying a path to an arbitrary file as command-line parameter causes the Lamu editor to open the specified file.

> java -jar lamu.jar any-scheme-program.scm

Or if your distribution has a support for binfmt_misc kernel module, (which is most likely available in modern distributions in 2020) you can simply:

> chmod 755 ./lamu.jar
> ./lamu.jar any-scheme-program.scm

Environment Variable

Some setting is configured via environment variables. For further information, please read Lamu Environment Variable Specification.

Advanced Command-line Parameter

Lamu is composed by several components. And Lamu’s command-line parameter can specify which of these components to be instantiated on at the start-up.

For further information, please read Lamu Command-line Parameter Specification

Execute Scheme Commands from Your Editors

If you are a VIM user,

:xmap <Return> :!curl -sSd "`cat`" http://localhost:8192/vim

this command effectively turns your VIM into a Scheme interactive editor. Select the specific text and hit your enter-key then the text will be executed in the Lamu application instance.

Lamu listens the port 8192 as a HTTP server, and executes any text which comes via POST request from a client on localhost. It denies all requests from hosts other than localhost.

Such kind of trick should easily be implemented in Emacs or other editors, too.

Disclaimer

Running Lamu in a public computer which has a network interface with any global IP assigned or a running production server etc. causes great security risks. Do not run Lamu in such situations.