Skip to content
This repository has been archived by the owner on May 30, 2024. It is now read-only.
/ ghemx Public archive

Bash based alarm/timer built for tiling window managers

License

Notifications You must be signed in to change notification settings

csmertx/ghemx

Repository files navigation

ghemx

Bash based alarm/timer built for tiling window managers.

Screenshot

ghemx.webm

Dependencies

  • Bash

  • libnotify (Required)

    Ubuntu: libnotify-bin

  • kdialog (Required)

    KDE Desktop

  • mplayer (Optional)

    Notification sounds

  • dunst (Optional)

    Tiling WMs

  • Bash shell friendly bar (Optional)

    Tiling WMs

  • mutt (Optional)

    Send alarm/timer notifications through email

Installation

cp ~/Downloads/ghemx ~/.local/bin/ghemx
echo "alias ghemx='/home/$USER/.local/bin/ghemx'" >> ~/.bashrc

Add timer_monitor (i3blocks folder) to bar configuration for realtime alarm/timer monitoring

Sync with KDE Connect

This synces all KDE Plasma Desktop notifications to paired device

  • Android

    • KDE Connect > Three Dots (Top Right) > Plugin Settings > Toggle On: Receive Notifications
  • KDE Plasma Desktop

    • KDE Connect Settings > Paired Device > Toggle On: Send Notifications > Gear Icon (First Icon to the right) > Check: Include Body + Icons

      Uncheck: Persistent notifications only

  • iOS?

    • github/kdeconnect-ios : "Notification syncing doesn't work because iOS applications can't access notifications of other apps"

Usage

  • Run with your favorite launcher (Gnome 3: ALT+F2, dmenu, rofi, etc.)

  • Tested with Gnome 3, KDE Desktop, i3wm, & bspwm, etc.

  • First saved timer creates dir ~/.config/ghemx & ghemx_timers.conf if not found

ghemx is a distraction fueled timer with notifications
usage: ghemx [-ahlxztrms] [--help] [--list]
-h|--help     Read me
-l|--list     List directory of ghemx tmp & save files
              and list saved timer entries
-x            Save timer (e.g. -x 'seitan' -m 10)
              (becomes current title)
-z            Restore timer (e.g. -z 'tendies')
-t            Timer title (defaults to: ????)
-r            Timer hours
-m            Timer minutes
-s            Timer seconds
-a            Send alert email (e.g. -t 'example' -s 15 -a y)

DE Screenshots

Gnome 3 (Ubuntu 20.04)

Screenshot

KDE Plasma (Kubuntu 20.04)

Screenshot

i3-gaps + Lemonbar (Orange text) (Arch Linux 2018)

ghemx_on_i3-gaps

About

Bash based alarm/timer built for tiling window managers

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages