explaingit

shinigami1231111/lumalarm

Analysis updated 2026-05-18

★ 0QMLAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

Lumalarm is a Linux alarm clock that wakes your sleeping PC before your alarm and challenges you afterward to make sure you actually get up.

Mindmap

mindmap
  root((Lumalarm))
    What it does
      Suspend to wake
      Anti oversleep checks
      Timer and stopwatch
    Tech stack
      QML
      Qt 6
      CMake
      C plus plus
    Use cases
      Overnight suspend wake
      Snooze limiting
      Desktop theming
    Audience
      Linux desktop users
      Ricing enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Suspend your Linux PC overnight and have it automatically wake before your alarm fires.

USE CASE 2

Force yourself awake with a typing or math challenge instead of an easy snooze button.

USE CASE 3

Limit or disable snoozing so you cannot sleep through an alarm indefinitely.

USE CASE 4

Use built-in themes or import pywal colors to match the app to your desktop setup.

What is it built with?

QMLQt 6CMakeC++

How does it compare?

shinigami1231111/lumalarmhparadiz/yomantaqsblaze/notched
Stars000
LanguageQMLQMLQML
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Building from source needs Qt 6, CMake, and a C++ compiler, rtcwake is optional but needed for suspend-to-wake.

GPLv3: you can use and modify this freely, but if you distribute a modified version, you must share its source code under the same license.

In plain English

Lumalarm is an alarm clock application for Linux that solves a problem most alarm apps ignore: your computer has to already be awake for them to work. Lumalarm instead puts your machine to sleep for you and automatically wakes it back up shortly before your alarm is due to go off, using a low level Linux feature called rtcwake, so you do not have to leave your computer running all night just to hear a beep in the morning. Once the alarm actually wakes you, Lumalarm also tries to make sure you get out of bed rather than sleepily silencing it and drifting back off. It can require you to solve a typing or math challenge, ask a still awake confirmation question, and escalate through steps like ramping up screen brightness and sound before forcing a challenge if you keep ignoring it. You can also limit how many times an alarm may be snoozed, attach a short note to remind you why the alarm was set, and let a quiet ambient soundscape fade in before the main alarm tone plays. Beyond alarms, the app includes a countdown timer with lap support and a stopwatch, along with a sound manager for importing and previewing your own alarm tones in common audio formats. The interface is built to be fully themeable, aimed particularly at people who customize their desktop environments, supporting real window transparency so that compositors on tools like Hyprland or Sway can blur the desktop behind it, plus several built in color themes and the option to import colors generated by a tool called pywal. Lumalarm is built with the Qt framework and QML, and building it from source requires Qt 6, CMake, and a C++ compiler, with an optional dependency for nicer blur support under the KDE desktop environment. It is also available prebuilt through the Arch Linux user repository. The project is licensed under the GNU General Public License version 3, and configuration such as themes, alarms, and general behavior is stored in plain, human readable files that can be hand edited and reloaded live without restarting the app.

Copy-paste prompts

Prompt 1
Help me build Lumalarm from source on my Linux distribution.
Prompt 2
Explain how rtcwake lets Lumalarm suspend and wake my PC automatically.
Prompt 3
Walk me through setting up the anti-oversleep challenges and snooze limits.
Prompt 4
Show me how to enable compositor blur behind Lumalarm on Hyprland or KDE.

Frequently asked questions

What is lumalarm?

Lumalarm is a Linux alarm clock that wakes your sleeping PC before your alarm and challenges you afterward to make sure you actually get up.

What language is lumalarm written in?

Mainly QML. The stack also includes QML, Qt 6, CMake.

What license does lumalarm use?

GPLv3: you can use and modify this freely, but if you distribute a modified version, you must share its source code under the same license.

How hard is lumalarm to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is lumalarm for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos