https://github.com/alarm-clock-applet/alarm-clock
Alarm Clock is a fully-featured alarm clock for use with an AppIndicator implementation.
https://github.com/alarm-clock-applet/alarm-clock
alarm-clock alarms countdown gtk3 linux timer
Last synced: 18 days ago
JSON representation
Alarm Clock is a fully-featured alarm clock for use with an AppIndicator implementation.
- Host: GitHub
- URL: https://github.com/alarm-clock-applet/alarm-clock
- Owner: alarm-clock-applet
- License: gpl-2.0
- Created: 2016-12-23T21:09:18.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2025-05-22T11:35:35.000Z (5 months ago)
- Last Synced: 2025-09-08T21:24:05.881Z (27 days ago)
- Topics: alarm-clock, alarms, countdown, gtk3, linux, timer
- Language: C
- Homepage: https://alarm-clock-applet.github.io
- Size: 2.92 MB
- Stars: 133
- Watchers: 9
- Forks: 30
- Open Issues: 65
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: COPYING
- Authors: AUTHORS
Awesome Lists containing this project
- Awesome-Linux-Software - 
## Installation
Installation instructions can be found on the [project website](https://alarm-clock-applet.github.io/#install).
## Requirements
This program requires the following packages:
```
cmake >= 3.10
gettext >= 0.19.8
glib-2.0 >= 2.56.4
gtk-3.0 >= 3.22.30
gio-2.0 >= 2.56.4
libnotify >= 0.7.7
gstreamer-1.0 >= 1.14.5
ayatana-appindicator3 >= 0.5.3
gnome-icon-theme
pod2man
gzip
```
This software has been tested with the specified version of each dependency as written above. It might function with older versions of these packages, however there is no support for them.
**NOTE: pod2man and gzip are optional and only needed during build time to generate the manpage**
The dependency to GConf can be removed by passing `-DENABLE_GCONF_MIGRATION=OFF` to cmake.
**WARNING: Doing so disables migration of old alarms.**
### Debian/Ubuntu-specific dependency packages
All the dependencies on a Debian/Ubuntu system can be installed with:
```
sudo apt install build-essential cmake libxml2-dev libgtk-3-dev libgstreamer1.0-dev libnotify-dev libayatana-appindicator3-dev gettext gnome-icon-theme perl gzip
```
## Building from source
Download and extract the source code with:
```
wget --content-disposition https://github.com/alarm-clock-applet/alarm-clock/archive/refs/tags/.tar.gz
tar zxvf alarm-clock-.tar.gz
cd alarm-clock-
```
And compile - install with the usual:
```
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make
sudo make install
```
## Usage
### Start applet
```
alarm-clock-applet
```
### Start applet with main window hidden
```
alarm-clock-applet --hidden
```
### Stop all alarms
```
alarm-clock-applet --stop-all
```
### Snooze all alarms
```
alarm-clock-applet --snooze-all
```