An LV2 sampler plugin that (currently) plays hydrogen drum kits
Go to file
2012-03-16 14:20:24 +01:00
.gitignore Add CMakeLists.txt for cmake 2012-02-23 12:54:39 +01:00
CMakeLists.txt Allow setting of sample zero position, and add compiler options to change default 2012-03-16 14:20:24 +01:00
COPYING Add license info (GPL3) 2012-02-07 12:52:59 +01:00
drmr_hydrogen.c Don't keep filename around if only scanning 2012-02-21 13:39:14 +01:00
drmr_hydrogen.h Number of fixes: don't hold mutex while loading, fix ui crash when kit index out of range, don't load negative kit indexes, respond to midi base note port events. 2012-02-15 22:56:08 +01:00
drmr_ui.c Allow setting of sample zero position, and add compiler options to change default 2012-03-16 14:20:24 +01:00
drmr.c No need for activate/deactive. Free when more than one prefix on knob is set 2012-02-25 11:33:22 +01:00
drmr.h Get instrument names during a scan-only parse 2012-02-21 12:53:29 +01:00
drmr.ttl Make midi base note a control 2012-02-14 15:39:53 +01:00
knob.png Track knob.png 2012-02-23 12:54:39 +01:00
Makefile.legacy Update README for cmake, and move Makefile to Makefile.legacy 2012-02-23 12:54:39 +01:00
manifest.ttl initial commit, working basics. 2012-02-06 22:54:18 +01:00
nknob.c No need for activate/deactive. Free when more than one prefix on knob is set 2012-02-25 11:33:22 +01:00
nknob.h Don't use hard coded path for knob image, use bundle-path from lv2 host 2012-02-23 14:12:03 +01:00
README Add README 2012-02-07 12:43:14 +01:00
README.md Allow setting of sample zero position, and add compiler options to change default 2012-03-16 14:20:24 +01:00

DrMr

DrMr is an LV2 sampler plugin. It's main reason to exist is to give a way for lv2 hosts to have a built in drum synth that can save its entire state (i.e. no need to go out to external tools and no need to save extra state). See the wiki (click the wiki tab above) for some screenshots. DrMr currently supports the following:

  • Control via midi
  • Scan for and load hydrogen drum kits (see note 3)
  • Multi-layer hydrogen kits (will pick layer based on that samples set gain)
  • Kit is set via an LV2 control (see note 1 below)
  • LV2 controls for gain on first 32 samples of kit (see note 2 below)
  • LV2 controls for pan on first 32 samples of kit (see note 2 below)
  • GTK ui that can select a kit and control gain/pan on each sample
  • Custom knob widget for GTK ui based on phatknob that is both functional and awesome looking. (see wiki for screenshot)

Hopefully coming soon:

  • Creating / Saving custom kits on a per sample basis using the GTK UI
  • ASDR envelope on samples (Will be automatable and controllable in the UI)

DrMr is a new project, so the code should be considered alpha. Bug reports are much appreciated.

Download

Only via git for now, just check out this repo

Compilation and Install

DrMr is built with CMake.

To build it simply do (from this dir):

mkdir build
cd build
cmake ..    (or "cmake -DUSE_NKNOB=OFF .." if you want old style sliders)

Then do:

make
make install

to install. There are some customizable variables for cmake. To see them do "cmake -L". The important ones are:

USE_NKNOB - Use custom knob widget for controls instead of the default gtk sliders. This defaults to ON. Try turning it off if you are experiencing problems, or just prefer the sliders.

SAMP_ZERO_POS - Controls where sample zero will position itself in the sample table. This is just the default value, and can be changed in the ui when DrMr is running. Valid values are:

0 - Top Left (default)
1 - Bottom Right (This will align with many drum machines and MIDI pads)
2 - Top Right
3 - Bottom Right

Any other value will emit a warning and use 0.

LV2_INSTALL_DIR - The directory to install the DrMr plugin to. To install to your home directory, use "~/.lv2" and clear the CMAKE_INSTALL_PREFIX. This defaults to "lib/lv2" (this is relative to CMAKE_INSTALL_PREFIX, which is usually /usr/local)

You can also use "ccmake .." or "cmake-gui .." for a more interactive configuration process.

A legacy Makefile is included, that will possibly work for you if you don't want to use cmake. To use it just do (from this dir):

make -f Makefile.legacy
make -f Makefile.legacy install

You'll need the following libraries to build and install DrMr:

DrMr scans the following directories for hydrogen drum kits:

  • /usr/share/hydrogen/data/drumkits/
  • /usr/local/share/hydrogen/data/drumkits/
  • /usr/share/drmr/drumkits/
  • ~/.hydrogen/data/drumkits/
  • ~/.drmr/drumkits/

If you want to add others, add them to the default_drumkit_locations array at the top of drmr_hydrogen.c

Note 1

As stated above, a goal of DrMr is to have the host save all the state for you. As such, the current kit needs to be a control. Unfortunately, string controls in LV2 are experimental at the moment, and not supported by many hosts (in particular Ardour doesn't support them). This means the kit needs to be set via a numeric control. DrMr specifies an integer index as a control to select which kit to load. A kits index is the order in which is was found. This means changing, adding, or removing hydrogen kits could mess up your saved index. Sorry.

You can figure out which kit is loaded by looking in the GtkUI at the bottom, or look at the print output from your host, as drmr will print the names of kits as it loads them.

Note 2

DrMr is currently using a static ttl file. This means I have to decide statically how many gain/pan controls to expose. I've settled on 32 for the moment, but that is arbitrary. At some point DrMr will probably move to using the LV2 Dynamic Manifest feature to expose the appropriate number of gain controls for the current sample set, although how force a host update of the manifest when the kit is changed is unclear (if you know how, please let me know)

Note 3

DrMr only currently supports a subset of things that can be specified in a hydrogen drumkit.xml file. Specifically, DrMr will not use gain/pan/pitch/asdr information. DrMr basically only uses the filename and layer min/max information to build it's internal sample representation. Values specified in .xml files will be used as DrMr begins to support the features needed for those values to make sense.