molok is a speedrun tracker for Linux which supports vertical and horizontal layouts.
(Note: The transparency effect was done by OBS. By default, molok has a solid black background.)
The mailing list for this project is ~raphi/public-inbox@lists.sr.ht.
Qt 5 core, widgets, and xml. Can be installed with
# Debian / Ubuntu
sudo apt install build-essential pkg-config qtbase5-dev libqt5core5a libqt5widgets5 libqt5xml5
# Arch Linux
sudo pacman -S base-devel qt5-base
Copy config.default.hpp
to config.hpp
, and then edit
config.hpp
to your liking.
Run make && sudo make install
to build and install.
When started, molok will ask for a .lss file. These can be created and edited at https://one.livesplit.org. The path to the .lss file can also be passed as a command line argument.
There are three ways to control molok: Global hotkeys, POSIX signals, and keyboard.
Global hotkeys: Hotkeys must be set in your desktop environment. For example, on KDE open the system settings, navigate to "Shortcuts", click "Add Application", and select "molok". You will be offered to set hotkeys for start/split, skip, undo, and reset.
Keyboard: If and only if molok is focused, it will respond to the following key presses:
Space
: Start/Splits
: Skip splitu
: Undo splitr
: Resetp
: Pause/UnpauseCtrl+S
: Save .lss fileCtrl+O
: Open .lss fileRight
or Down
: Scroll splits forwardLeft
or Up
: Scroll splits backwardPOSIX Signals: molok recognizes the following signals:
SIGRTMIN+0
: Start/SplitSIGRTMIN+1
: Skip splitSIGRTMIN+2
: Undo splitSIGRTMIN+3
: ResetSIGRTMIN+4
: Pause/UnpauseThis is best combined with a tool like sxhkd, which can set global hotkeys. For example, using this configuration file:
F1
pkill -SIGRTMIN+0 molok
F2
pkill -SIGRTMIN+1 molok
F3
pkill -SIGRTMIN+2 molok
shift + F4
pkill -SIGRTMIN+3 molok
Signal handling is implemented in signals.cpp
, keyboard handling is implemented in main.cpp
.
Goals:
Non-goals:
molok - Qt-based speedrun tracker
Copyright (C) 2021 Raphael Robatsch
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 3 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. If not, see https://www.gnu.org/licenses/.