电子鼓合成器Hydrogen

Hydrogen是一款跨平台，基于QT 4开发的开源电子鼓合成器，界面直观，可方便合成音乐创作、整理各种乐谱。支持导入 .wav, .au， .aiff 以及无损压缩格式FLAC , 支持导出格式wav, aiff, flac ogg, midi等。

----------------------

The git repository of the advanced drum machine

www.hydrogen-music.org

Hydrogen drum machine

Hydrogen is an advanced drum machine for GNU/Linux, Mac and Windows. Its main goal is to bring professional yet simple and intuitive pattern-based drum programming.

Official Website: http://www.hydrogen-music.org

Features

General

• Very user-friendly, modular, fast and intuitive graphical interface based on QT 5.
• Sample-based stereo audio engine, with import of sound samples in wav, au and aiff formats
• Support of samples in compressed FLAC file.
• Separate command-line interface (h2cli)

Sequencer and mixer

• Pattern-based sequencer, with unlimited number of patterns and ability to chain patterns into a song.
• Up to 192 ticks per pattern with individual level per event and variable pattern length.
• Unlimited instrument tracks with volume, mute, solo, pan capabilities.
• Multi layer support for instruments (up to 16 samples for each instrument).
• Sample Editor, with basic cut and loop functions.
• Time-stretch and pitch functions via rubberband cli.
• Playlist with scripting support
• Advanced tap-tempo
• Director Window with a visual metronome and song position tags
• Timeline with variable tempo
• Import/Export single patterns
• Midi-Learn functionality for many gui elements
• Multiple patterns playing at once.
• Ability to import/export song files.
• Unique human velocity, human time, pitch and swing functions.

Other features

• JACK, ALSA, PulseAudio, PortAudio, CoreAudio and OSS audio drivers.
• ALSA MIDI, JACK MIDI, CoreMidi and PortMidi input with assignable midi-in channel (1..16, ALL).
• Import/export of drumkits.
• Export song to wav, aiff, flac or file.
• Export song to midi file.
• Export song to LilyPond format.

Installation

More details in the INSTALL.md file.

Packaging Status

Expand to see the status of Hydrogen in the package ecosystem

 

from https://github.com/hydrogen-music/hydrogen

 

 from https://github.com/hydrogen-music/hydrogen

-----------------------------------------------------------------------------------------------

BUILDING AND INSTALLING HYDROGEN

Content:

1. System Requirements
2. Binary Packages
3. Build and Install from Source
4. Generate the Documentation

System Requirements

Hydrogen is supported on the following operating systems:

• Linux/Unix/BSD
• Mac OS X
• Windows 10 (maybe 7)

Binary Packages

Mac OS X and Windows

Hydrogen can be downloaded as a binary package, source distribution, or you can check out the current development version.

Binary packages can be accessed on the project's Github page:

• https://github.com/hydrogen-music/hydrogen/releases

If you are interested in older versions or installers, you can check out the Hydrogen home page:

• http://www.hydrogen-music.org/

To get the latest version with the latest features on Mac OS X, you can install Hydrogen using Mac Ports.

• Installing on Mac OS X with MacPorts

Linux

Please check your package management system for the package called hydrogen. In Debian (GNU/Linux)-based distributions this can be done with apt

$ sudo apt-get install hydrogen

Build and Install from Source

Mac OS X

If you intend to build Hydrogen from source on Mac OS X, please read the relevant wiki pages for more information:

• Building Hydrogen from source on Mac OS X

Windows

For building Hydrogen on Windows, please check out the following wiki page:

• Packaging Hydrogen for Windows

Linux

Prerequisites

The source code for the current development version can be checked out via git:

$ git clone git://github.com/hydrogen-music/hydrogen

In order to build Hydrogen from source, you will need the following libraries and development header files installed on your system:

Required

• Qt 5 Library
• Qt 5 SDK (moc, uic, etc.)
• GNU g++ compiler (>=4.0, 3.x might work)
• cmake (>=2.6)
• libsndfile >=1.0.18
• zlib and libtar OR libarchive
• OS X: Xcode
• At least one of the following audio and midi driver

Audio and Midi Drivers

• JACK Audio Connection Kit (>=0.103.0)
• ALSA (Advanced Linux Sound Architecture)
• OSS
• PortAudio (v18, not v19)
• PortMIDI
• CoreAudio (OS X)
• CoreMidi (OS X)

Optional Support

• liblo for OSC (Open Sound Control)
• LASH (Linux Audio Session Handler)
• NSM (Non Session Manager)
• liblrdf for LADSPA plugins
• librubberband2 (Rubberband support is experimental)

Currently it is recommended that you disable the rubberband config option (done by default) to ensure backwards compatibility with songs created under 0.9.5 which use rubberband. Install the rubberband-cli package beside librubberband2. Rubberband works properly even if this option is disabled. If available, Hydrogen locates the installed rubberband-cli binary.

Packages Required on Debian-based Systems

In order to build Hydrogen on Debian-based Systems, you can use the following command to install all basic and some optional requirements.

$ sudo apt-get install cmake qtbase5-dev qtbase5-dev-tools  \
	qttools5-dev qttools5-dev-tools libqt5xmlpatterns5-dev  \
	libqt5svg5-dev libarchive-dev libsndfile1-dev libasound2-dev  \
	liblo-dev libpulse-dev libcppunit-dev liblrdf0-dev  \
	librubberband-dev

In addition, either the libjack-jackd2-dev or libjack-dev package must be present to enable the support of the JACK audio driver. Which one to pick depends on whether JACK2 or JACK1 is installed on your system. If none is present, either package will work.

Building and Installing Hydrogen

After you have installed all the prerequisites, building and installing will look like this:

$ git clone git://github.com/hydrogen-music/hydrogen
$ cd hydrogen
$ mkdir build && cd build
$ cmake ..
$ make && sudo make install

Running Hydrogen

After installation, Hydrogen's binaries can be found in CMAKE_INSTALL_PREFIX/bin. If this path is not in your PATH environment variable, consider adding it to it.

If Hydrogen doesn't start, and you have the above message :

… error while loading shared libraries: libhydrogen-core-1.1.0.so …

it's because Hydrogen's shared library is not found. You can verify this with the following command

ldd CMAKE_INSTALL_PREFIX/bin/hydrogen | grep 'not found'

To fix it, you can use LD_PRELOAD or LD_LIBRARY_PATH environment variables, or configure ldconfig (see man ldconfig, man ld.so).

Another option is to set the cmake option -DCMAKE_INSTALL_PREFIX=/usr, recompile, and reinstall Hydrogen. But be aware that you will certainly overwrite Hydrogen files that you might have installed with your distribution's package manager.

see issue#677

Build Script

Alternatively you could use our custom build script ./build.sh. This is the recommended way if you are actively developing new features or bug fixes for Hydrogen (all characters in squared brackets are optional and do not have to be included in the command).

Command	Functionality
r[m]	Remove all build, temporary, and cached files.
c[lean]	Remove all cached files.
m[ake]	Launch the build process.
mm	Launch the build process using ccache.
d[oc]	Build the documentation of Hydrogen.
g[raph]	Draw the dependency graphs of the Hydrogen code using graphviz.
h[elp]	Show all supported build options.
[e]x[ec]	Execute the Hydrogen binary.
t[est]	Run the unit tests.
p[kg]	Build a source package.
z	Build Hydrogen using ccache and execute the resulting binary.

Using ccache to build Hydrogen, ./build.sh mm, will result in a compilation, which takes a little longer than the one with the usual make command. But in all further runs, only the recently-modified components will be recompiled. This can marginally speed up development.

Additional Build Features and Uninstall

All the following cmake commands should be executed in a build directory :

If you wish to configure features like LADSPA plugins, or debugging symbols, get more information like this:

$ cmake -L ..

For possible make targets:

$ make help

To change the directory Hydrogen will be installed in, you have to provide the -DCMAKE_INSTALL_PREFIX option during the configuration of your custom build (the default path is /usr/local/).

$ cmake -DCMAKE_INSTALL_PREFIX=/opt/hydrogen ..
$ make && sudo make install

Uninstalling Hydrogen is done like this:

$ sudo cmake uninstall

Note that cmake is a build system and not a package manager. While we make every effort to ensure that Hydrogen uninstalls cleanly, it is not guaranteed.

cmake macros should detect the correct Qt settings and location of your libraries, but sometimes it needs a little help. If Hydrogen fails to build, some environment variables could help it.

$ QTDIR=/opt/lib/qt4 OSS_PATH="/usr/lib/oss/lib" OSS_INCLUDE="/usr/lib/oss/include" cmake ..

Generate the Documentation

Apart from the official manuals and tutorial, Hydrogen does also feature an extended documentation of its code base.

After installing the requite Doxygen package

$ sudo apt-get install doxygen

run the following command

$ ./build.sh d

It will produce two folders, build/docs/html/ and build/docs/latex, containing the documentation as HTML and LaTeX, respectively. The HTML version is recommended since it provides a more friendly way to navigate through the set of created files. You can view them using your favorite browser, e.g.

$ firefox build/docs/html/index.html

from https://github.com/hydrogen-music/hydrogen/blob/master/INSTALL.md