Shaidin
Digital Clock
Clock Application

Clock is an application based on SDL2.
Date and time are shown in full-screen mode.
Multiple alarms can be set and next coming alarm time is shown.
Hourly chime can be turned on or off.
The brightness changes according to the time (more light during the day and less light during the night).

Steps to run on Linux:
  1. Download "clock-x86_64.deb".
  2. Install it: "sudo apt install <the-deb-file>".
  3. Run "clock".
  4. Check the time occasionally.
Steps to run on Windows:
  1. Download "clock-AMD64.msi".
  2. Install it.
  3. Run "clock.exe" from "bin" folder at installation path.
  4. Check the time occasionally.
Help
Keyboard
  • F1: Open the help file
  • Enter: Read the configuration
  • R: Ring the bell
  • SPACE: Stop current ring
  • ESC: Exit
Mouse
  • Click: Exit
Touch
  • Touch: Exit
Configuration:
Create a file named ".clock.conf" in your home directory.
  • To choose the display index - for example 1 - add the line "display 1" to ".clock.conf".
  • To set the volume from 0 to 100 - for example 75 - add the line "volume 75" to ".clock.conf".
  • To set the text color by RGB - for example black - add the line "color 0 0 0" to ".clock.conf".
  • To set the background color by RGB - for example white - add the line "background 255 255 255" to ".clock.conf".
  • To make cursor visible, add the line "hide-cursor false" to ".clock.conf".
  • To exit fullscreen mode, add the line "fullscreen false" to ".clock.conf".
  • To disable the 24-hour format, add the line "24-hour false" to ".clock.conf".
  • To hide seconds, add the line "seconds false" to ".clock.conf".
  • To turn dimming off, add the line "dim false" to ".clock.conf".
  • To turn whisper off, add the line "whisper false" to ".clock.conf".
  • To turn hourly chimes on, add the line "chimes true" to ".clock.conf".
  • To turn alarms on, add the line "alarms true" to ".clock.conf".
  • To hide chimes and alarms status, add the line "sound-info false" to ".clock.conf".
  • To set the weekday format - for example Sun - add the line "weekday %a" to ".clock.conf".
    Supported specifiers:
    • %A - Full Weekday
    • %a - Abbreviated Weekday
    • %w - Weekday As Number, Sunday As 0 (0-6)
    • %u - Weekday As Number, Monday As 1 (1-7)
    Use ? to hide the weekday line.
  • To set the date format - for example 04-25-2024 - add the line "date %m-%d-%Y" to ".clock.conf".
    Supported specifiers:
    • %m - Month Number [01-12]
    • %b - Abbreviated Month Name
    • %d - Day oh Month [01-31]
    • %y - Short Year [00-99]
    • %Y - Full Year
    Supported separators:
    • -
    • .
    • /
    • :
    Use ? to hide the date line.
  • To add an alarm, optionally with days of week - for example "06:30" on monday and tuesday - add the line "alarm 06:30 monday tuesday" to ".clock.conf".
    Additional supported terms:
    • weekend - Adds Saturday and Sunday.
    • weekdays - Adds Monday, Tuesday, Wednesday, Thursday, and Friday.
    • never - The alarm won't trigger.
  • To disable padding with a zero - for example hour - add the line "pad-hour false" to ".clock.conf".
    Supported fields:
    • pad-hour
    • pad-minute
    • pad-second
    • pad-year
    • pad-month
    • pad-day