README.md
1# Hydrogen drum machine
2
3[![Travis Build Status](https://travis-ci.org/hydrogen-music/hydrogen.svg?branch=master)](https://travis-ci.org/hydrogen-music/hydrogen)
4[![Coverity Scan Build](https://scan.coverity.com/projects/2965/badge.svg?flat=1)](https://scan.coverity.com/projects/2965)
5[![Packaging status](https://repology.org/badge/tiny-repos/hydrogen.svg)](https://repology.org/project/hydrogen/versions)
6
7Hydrogen is an advanced drum machine for GNU/Linux, Mac and Windows.
8It's main goal is to bring professional yet simple and intuitive pattern-based drum programming.
9
10**Official Website:** http://www.hydrogen-music.org
11
12### Features
13
14#### General
15
16 * Very user-friendly, modular, fast and intuitive graphical interface based on QT 5.
17 * Sample-based stereo audio engine, with import of sound samples in wav, au and aiff formats
18 * Support of samples in compressed FLAC file.
19 * Separate commandline interface (h2cli)
20
21#### Sequencer and mixer
22
23 * Pattern-based sequencer, with unlimited number of patterns and ability to chain patterns into a song.
24 * Up to 192 ticks per pattern with individual level per event and variable pattern length.
25 * Unlimited instrument tracks with volume, mute, solo, pan capabilities.
26 * Multi layer support for instruments (up to 16 samples for each instrument).
27 * Sample Editor, with basic cut and loop functions.
28 * Time-stretch and pitch functions via rubberband cli.
29 * Playlist with scripting support
30 * Advanced tap-tempo
31 * Director Window with a visual metronome and song position tags
32 * Timeline with variable tempo
33 * Import/Export single patterns
34 * Midi-Learn functionality for many gui elements
35 * Multiple patterns playing at once.
36 * Ability to import/export song files.
37 * Unique human velocity, human time, pitch and swing functions.
38
39#### Other features
40
41* JACK, ALSA, PulseAudio, PortAudio, CoreAudio and OSS audio drivers.
42* ALSA MIDI, JACK MIDI, CoreMidi and PortMidi input with assignable midi-in channel (1..16, ALL).
43* Import/export of drumkits.
44* Export song to wav, aiff, flac or file.
45* Export song to midi file.
46* Export song to LilyPond format.
47
48### Screenshots
49<details>
50 <summary>Expand to view Hydrogen screenshots</summary>
51
52#### Hydrogen Main Window
53![main-window][screenshot1]
54
55#### Hydrogen File Browser
56![audio-filebrowser][screenshot2]
57
58#### Hydrogen Sample Editor
59![sample-editor][screenshot3]
60
61#### Hydrogen Sound Library
62![soundlibrary][screenshot4]
63
64[screenshot1]: http://hydrogen-music.org/images/screenshots/main-window.png
65[screenshot2]: http://hydrogen-music.org/images/screenshots/audio-filebrowser.png
66[screenshot3]: http://hydrogen-music.org/images/screenshots/sample-editor.png
67[screenshot4]: http://hydrogen-music.org/images/screenshots/soundlibrary.png
68
69</details>
70
71### Installation
72More details in the [INSTALL.md](INSTALL.md) file.
73
74### Packaging Status
75<details>
76 <summary>Expand to see the status of Hydrogen in the package ecosystem</summary>
77
78 [![Packaging status](https://repology.org/badge/vertical-allrepos/hydrogen.svg?header=Hydrogen)](https://repology.org/project/hydrogen/versions)
79
80</details>
81
82### License
83GPLv2 (more details in the [COPYING](./COPYING) file.)
84
85Happy drumming! :smiley:
86