chris
/
nymph
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
A Nim library for writing audio and MIDI plugins conforming to the LV2 standard
27 Commits 2 Branches 0 Tags 186 KiB
Nim 100%
Go to file
Christopher Arndt f001184fea feat: add tiltfilter example 2024-09-28 03:02:49 +02:00
examples feat: add tiltfilter example 2024-09-28 03:02:49 +02:00
src Turn atomSequenceClear into a template 2024-05-28 15:48:39 +02:00
tests Add nimble tasks and example 'amp' plugin 2024-04-20 04:16:16 +02:00
.gitignore refactor: some file and object renaming 2024-09-28 03:02:07 +02:00
LICENSE Add stub readme and license file 2024-04-20 04:16:16 +02:00
README.md Update readme to mention miditranspose example 2024-05-21 18:13:42 +02:00
config.nims Initial commit 2024-04-19 12:07:48 +02:00
nymph.nimble feat: add tiltfilter example 2024-09-28 03:02:49 +02:00

README.md

nymph

A Nim library for writing audio and MIDI plugins conforming to the LV2 standard

Examples

Build the amp.lv2 example plugin:

nimble build_ex amp

Check the amp.lv2 plugin bundle with lv2lint:

nimble lv2lint amp

Run the lv2bm benchmark with the amp.lv2 plugin:

nimble lv2bm amp

Install the amp.lv2 example plugin:

cp -a examples/amp.lv2 ~/.lv2

Other example plugins can be found in the examples directory and can be built and tested with similar commands, just changing the example name to the basename of the plugin's LV2 bundle dir.

Currently, there are only two other example plugins, multimode_filter and miditranspose, but more will be added in due time.

How To

  • Install this library:

      nimble install https://git.0x20.eu/chris/nymph

  • Copy examples/amp.lv2 and examples/amp.nim into your project and rename them as you like (also rename amp.lv2/amp.ttl). I'll use myplugin as the base name in the examples below.

  • Edit myplugin.lv2/manifest.ttl:

    • Change the plugin URI.
    • Change the plugin's shared library name defined via lv2:binary to libmyplugin.so.
    • Change file name referenced via rdfs:seeAlso to myplugin.ttl.

  • Edit myplugin.lv2/myplugin.ttl:

    • Change the plugin URI.
    • Define audio, control and atom ports as needed.

  • Edit myplugin.nim:

    • Change the PluginUri constant at the top.
    • Change the PluginPort enum and list the ports in the order defined in myplugin.ttl.
    • Rename and update the definition of the AmpPlugin object type and define its members with the appropriate data type for the plugin port they will be connected to. Update the type name in the instantiate, deactivate, connectPorts and run procs.
    • Update and extend the case statement in connectPort to connect ports to your plugin object instance members.
    • Implement your DSP code in the run proc.

  • Compile the plugin shared library object with:

      nim c --app:lib --noMain:on --mm:arc \
      --out:myplugin.lv2/libmyplugin.so myplugin.nim

    See the definition of the build_ex task in the nymph.nimble file on how to create a nimble task to simplify compilation.

Dependencies

Required:

Optional:

  • lv2bm - For benchmarking and stress-testing plugins
  • lv2lint - For checking conformity of plugin bundles