DTimer

This is a countdown timer application built using the GTK# library in C#. It supports counting down from a specified duration, pausing, resuming and resetting the timer, and providing an optional simple alert sound at the end (if the user provides a .wav sound file. Other formats untested).

Current Stable Version: 2.1.6 (Main Branch) Current Dev Version: 2.1-dev.6 (Dev Branch)

Note: Main branch is theoretically stable. Development happens on the dev branch and contains latest updates but may break! Expect breakage and rapid iteration espectially on dev.

Installation

To install DTimer, follow these steps:

Install Dependencies

Arch Linux: pacman -S mono gtk-sharp-3

Ubuntu: sudo apt install mono-devel gtk-sharp3

Install DTimer

1. Clone the repository: git clone https://github.com/metalxxhead/dtimer.git

2. Navigate to the project directory: cd dtimer/

3. Make scripts executable (if required): chmod +x ./scripts/build.sh chmod +x ./scripts/run.sh

4. Build the project: ./scripts/build.sh

5. Run the application: ./scripts/run.sh --name "Your timer name" --duration "00:05:00"

Note:
--name "the timer name" and --duration "hh:mm:ss" are required --sound-file allows you to specify the path to a sound to play when the timer ends --start immediately starts the timer on launch

5. Optionally, create your own scripts launch the program:

#!/bin/bash

/your/path/dtimer/scripts/run.sh --name "Timer Example" --duration "01:30:00" --sound-file "/path/to/sound.wav" --start

If needed, the compiled binary can be moved from the build/ directory anywhere you like and called directly with mono:

mono /path/to/dtimer.exe --name "Timer Example" --duration "01:30:00"

Features

• Launch multiple timers with custom configurations direct from command line or scripts
• Start, pause, and restart timers
• Specify soundfile path to play when timer is complete
• Use start button or start automatically with --start flag during launch
• Progress bar shows percentage of time elapsed at a glance

Contributing

Contributions are welcome! Please submit bug reports, feature requests, or pull requests.

License

DTimer - A simple linux timer launched from the command line Copyright (C) 2026 http://github.com/metalxxhead

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero 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 Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Acknowledgments

• Mono
• MCS
• GTK# 3

Contact Information

Damien's website: internalstaticvoid.dev

Damien's Github: github.com/metalxxhead