/* * TapTempo.cpp - Plugin to count beats per minute * * Copyright (c) 2026 saker * * This file is part of LMMS - https://lmms.io * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * General Public License for more details. * * You should have received a copy of the GNU General Public * License along with this program (see COPYING); if not, write to the * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA 02110-1301 USA. * */ #include "TapTempo.h" #include #include "SamplePlayHandle.h" #include "Song.h" #include "embed.h" #include "plugin_export.h" namespace lmms { extern "C" { Plugin::Descriptor PLUGIN_EXPORT taptempo_plugin_descriptor = {LMMS_STRINGIFY(PLUGIN_NAME), "Tap Tempo", QT_TRANSLATE_NOOP("PluginBrowser", "Tap to the beat"), "saker ", 0x0100, Plugin::Type::Tool, new PluginPixmapLoader("logo"), nullptr, nullptr}; PLUGIN_EXPORT Plugin* lmms_plugin_main(Model*, void*) { return new TapTempo; } } TapTempo::TapTempo() : ToolPlugin(&taptempo_plugin_descriptor, nullptr) { m_intervals.fill(std::chrono::milliseconds::zero()); } void TapTempo::tap(bool play) { using namespace std::literals; if (play) { const auto metronomeFile = m_beat == 0 ? "misc/metronome02.ogg" : "misc/metronome01.ogg"; Engine::audioEngine()->addPlayHandle(new SamplePlayHandle(metronomeFile)); } m_beat = (m_beat + 1) % Engine::getSong()->getTimeSigModel().getNumerator(); if (m_lastTap.time_since_epoch() == 0ms) { m_lastTap = clock::now(); return; } const auto delta = std::chrono::duration_cast(clock::now() - m_lastTap); constexpr auto resetTime = 2000ms; if (delta >= resetTime) { m_bpm = 0; m_taps = 0; m_beat = 0; m_lastTap = clock::now(); return; } m_intervals[(m_taps++) % MaxIntervals] = delta; constexpr auto millisecondsPerMinute = 60000.0; if (m_taps >= MaxIntervals) { // calculate the median of the stored intervals to reject outliers std::nth_element(m_intervals.begin(), m_intervals.begin() + m_intervals.size() / 2, m_intervals.end()); const auto newBpm = millisecondsPerMinute / m_intervals[m_intervals.size() / 2].count(); // use an adaptive EMA to smooth out jitter when in the ballpark and update quickly when moving to a new BPM const auto error = std::abs(newBpm - m_bpm); const auto alpha = std::clamp(error / 100.0, 0.2, 0.8); m_bpm = alpha * newBpm + (1.0 - alpha) * m_bpm; } else { // calculate the instant BPM for now until we have enough taps m_bpm = millisecondsPerMinute / delta.count(); } m_lastTap = clock::now(); } void TapTempo::sync() { Engine::getSong()->setTempo(std::round(m_bpm)); } void TapTempo::reset() { m_bpm = 0; m_taps = 0; m_beat = 0; m_lastTap = std::chrono::time_point{}; } QString TapTempo::nodeName() const { return taptempo_plugin_descriptor.name; } double TapTempo::bpm() const { return m_bpm; } } // namespace lmms