Open-source project
hydrogen-music/hydrogen avatar
hydrogen-music/hydrogen

Hydrogen drum machine setup, features, and limitations

The advanced drum machine for Linux, macOS, and Windows

1,343 stars184 forksC++GPL-2.0

At a glance

What is it?
Hydrogen is an open source C++ drum machine for Linux, macOS, and Windows. Its pattern sequencer, drum synthesizer, MIDI support, and OSC or MIDI automation fit musicians who need a configurable standalone rhythm instrument.
Who is it for?
Hydrogen is a reasonable adoption choice for musicians who want a standalone drum machine with editable patterns, samples, instrument properties, and automation. It is less suitable if the official documentation does not cover a required production workflow or if deployment depends on a distribution package that differs from the documented releases.
Can I use it commercially?
Yes, with conditions. GPL-2.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
Is it still maintained?
Yes. The repository last received commits 7 days ago.
What is it written in?
Mainly C++, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on October 23, 2026, and from our analysis. They are not legal advice.

Editorial analysis

Hydrogen's scope for pattern-based drum production

Hydrogen addresses the problem of programming and performing repeatable drum parts without restricting the workflow to a fixed kit or a narrow hardware sequencer. According to the README, it serves as both a drum sequencer for pattern-based programming and a drum synthesizer. That combination makes it relevant to home practice, studio drum-machine work, and live looping. The same application therefore has to serve several levels of use, from quickly constructing a basic rhythm to adjusting instrument, sample, and note properties in greater detail.

The intended users are musicians who need direct control over drum programming rather than a narrow library playback tool. Hydrogen accepts external control through MIDI or OSC, which is important when the drum part needs to interact with another sequencer, controller, or performance system. The README also identifies MIDI as a first-class feature. That does not mean every possible MIDI or OSC workflow is documented in the repository overview, so buyers should not assume broad compatibility without checking the manual.

The project's scope is a complete desktop drum workstation, not just a sound library. It advertises customizable behavior, numerous available drumkits, and detailed control over instruments, samples, and notes. These features matter because a usable drum machine must handle both the musical structure of a pattern and the sound assigned to each step. Hydrogen treats those concerns as part of one application.

Based on the repository layout, the implementation is primarily C++ and organized around `src/`, with platform-specific files under `linux/`, `macos/`, and `windows/`. A `CMakeLists.txt`, `build.sh`, `cmake/`, and `tests/` are present at the top level. This is the structure of a native desktop project with explicit build support and platform packaging, rather than a browser-based sequencer.

Hydrogen's sequencer and drum synthesis model

Hydrogen's central mechanism is pattern-based sequencing combined with synthesis and sample-based drum playback. The README describes Hydrogen as a drum sequencer and a drum synth, so the application can represent programmed rhythm material while exposing sound properties for the instruments and samples that produce it. Its stated controls cover instrument, sample, and note properties, which gives users several levels at which to alter a drum part.

The available feature set also includes time-stretching and pitch shifting. Those operations belong to the audio-handling portion of a drum machine because changing timing or pitch can affect how existing samples behave without requiring the entire pattern to be redrawn. The README describes these capabilities at a high level and does not document their algorithm, quality settings, or limits. Their exact behavior should therefore be checked in the manual before a musician relies on them for a specific processing task.

Hydrogen supports both MIDI and OSC automation. MIDI is presented as a primary input and control mechanism, while OSC provides another route for automating the application. The repository overview does not include a message map, port configuration, or example controller session, so the precise control surface cannot be determined from the README. This is an important boundary when integrating Hydrogen into an existing studio system: the project clearly intends to be automated, but this documentation does not provide the API details needed to configure an integration.

The presence of `data/`, `docs/`, and `doxygen/` indicates separate resources for bundled data, documentation, and generated developer material. The repository also includes formatting and static analysis configuration such as `.clang-format` and `.clang-tidy`. These files suggest a native C++ development process, but they do not by themselves establish the internal module boundaries or guarantee particular behavior.

Installing Hydrogen on the documented desktop platforms

Hydrogen publishes a Windows 64-bit installer for Windows Vista or later, a macOS disk image for macOS 10.14 or later, and a Linux x86_64 AppImage for version 1.2.7. These are the clearest installation paths documented by the repository. The README also directs Linux users to their distribution's package repositories through Repology when that option is preferable.

For a release-based installation, select the artifact that matches the target operating system. The repository lists these direct downloads:

bash
https://github.com/hydrogen-music/hydrogen/releases/download/1.2.7/Hydrogen-1.2.7-win64.exe
https://github.com/hydrogen-music/hydrogen/releases/download/1.2.7/Hydrogen-1.2.7.dmg
https://github.com/hydrogen-music/hydrogen/releases/download/1.2.7/Hydrogen-1.2.7-x86_64.AppImage

The first URL is for Windows, the second is for macOS, and the third is for Linux x86_64. The README does not give command-line installation instructions for these files, so it would be inaccurate to add an invented `curl`, package-manager, or installer command. Users who need an older operating-system build are directed to the Download section of the Hydrogen homepage.

Building from source is the alternative when the current operating system is not supported or the latest development version is required. The repository links to a Linux `INSTALL.md` guide and separate wiki pages for macOS and Windows. Those platform-specific guides are the authoritative source for source-build dependencies and commands. The main README does not list those dependencies, so this review does not reproduce them.

A first Hydrogen session through the official manual

A documented first-use tutorial cannot be reduced to a reliable sequence of editor commands because the README does not describe the main-window controls, menu names, or project creation workflow. It identifies the official manual as the main entry point for learning how to use Hydrogen, with additional information in the FAQ and Wiki. That is a concrete limitation for a new user evaluating the application from repository documentation alone.

The supported first step is therefore installation and launch. After launching the desktop application, use the official manual to locate the controls for pattern programming and drumkit selection. The README does not state whether a default kit is selected, how an empty song is created, or which exact control starts playback. Inventing those details would make the tutorial unreliable. The manual URL supplied by the repository is:

bash
http://hydrogen-music.org/documentation/manual/manual_en.html

For a musician evaluating Hydrogen, the first useful exercise is to choose a drumkit, create or load a pattern, and inspect the sound controls, but only the existence of those capabilities is documented here. The manual must provide the exact sequence and expected interface. If the evaluation depends on live triggering, the user should specifically check the manual's MIDI and automation coverage before committing to it.

Hydrogen release availability and upgrade considerations

Hydrogen is not archived, and its last push was on 2026-10-13. Recent release history includes version 1.2.7 on 2026-10-02, version 1.2.6 on 2025-07-29, and version 1.2.5 on 2025-07-17. The release note for 1.2.5 identifies Qt6 support, LASH deprecation, and bug fixes. These release entries provide evidence of recent project work, but they do not establish compatibility with every plugin, host, operating-system build, or audio configuration.

Upgrade cost is not limited to replacing the application binary. A project that relies on MIDI or OSC automation may need to check whether saved songs, controller mappings, drumkits, and external routing continue to behave as expected. The README does not document migration procedures, session compatibility guarantees, or rollback instructions, so those points must be verified in the changelog and manual for the selected version.

The repository contains `CHANGELOG.md`, `INSTALL.md`, `DEVELOPERS.md`, and platform-specific build resources. This gives contributors and packagers places to inspect, but the README does not summarize their compatibility matrix. Packagers should also distinguish the official release artifacts from packages maintained in a Linux distribution repository. A distribution package may use different build options or dependency versions.

Hydrogen is distributed under GPLv2+, as stated in the README and indicated by the `COPYING` file. The license matters to organizations considering redistribution or integration. This review does not interpret the license or provide legal advice; those obligations should be checked against the actual `COPYING` file and the intended distribution model.

Choosing Hydrogen instead of a simpler or host-based workflow

Hydrogen's clearest alternative is a drum-machine or sampler feature inside a larger music production environment. A host-based workflow can keep arrangement, recording, and drum programming in one application, whereas Hydrogen is designed as a dedicated desktop drum machine with its own sequencer, drum synthesizer, drumkits, and automation options. The choice therefore depends on whether the user wants a focused standalone instrument or a broader production workspace.

Another practical alternative is a hardware or minimal software sequencer with a fixed control surface and a smaller feature set. Hydrogen offers deeper stated customization of instruments, samples, and notes, plus MIDI and OSC automation. In exchange, it introduces a larger application with Qt-based desktop distribution and platform-specific packaging. The README does not provide a formal comparison or resource measurements, so claims about which option is lighter or faster cannot be made from the available evidence.

Hydrogen is the wrong choice when a user needs a workflow whose exact controls, automation contract, or session migration behavior is absent from the documentation. It is also a poor fit for a non-desktop environment, since the listed downloads target Linux, macOS, and Windows desktops. For a musician who only wants a few audio samples triggered by a live controller, the additional sequencer and drum-synth features may exceed the requirement. For a producer who needs editable patterns and a dedicated drum instrument, those same features are the reason to consider Hydrogen.

Editorial conclusion

Hydrogen is a reasonable adoption choice for musicians who want a standalone drum machine with editable patterns, samples, instrument properties, and automation. It is less suitable if the official documentation does not cover a required production workflow or if deployment depends on a distribution package that differs from the documented releases. Verify the available binary for the target operating system, confirm the required MIDI and automation interfaces, and read the manual for the intended setup before adding it to a critical session.

Frequently asked questions

Which operating systems does Hydrogen support?

The README lists Windows, macOS, and Linux releases. Version 1.2.7 provides a Windows 64-bit installer for Windows Vista or later, a macOS image for macOS 10.14 or later, and a Linux x86_64 AppImage.

Can Hydrogen be automated with MIDI or OSC?

Yes. The README lists automation through MIDI or OSC and describes MIDI support as a first-class feature. It does not provide the detailed API or configuration reference for either interface.

Where can I find instructions for building Hydrogen from source?

The README links to `INSTALL.md` for Linux and separate wiki pages for macOS and Windows. It recommends these guides when the operating system is unsupported or when building the latest development version is needed.

Official sources

  1. hydrogen-music/hydrogen on GitHub
  2. License: GPL-2.0
  3. Project website
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/hydrogen-music-hydrogen.svg)](https://hysenlabs.com/projects/hydrogen-music-hydrogen)

Was this useful?