A KDE Plasma widget for tracking patient consultation time.

• Displays elapsed time in minutes:seconds format (MM:SS)
• Starts automatically from 0:00
• Click anywhere on the timer to reset to 0
• Works both as panel widget and desktop widget
• Configurable time thresholds with color warnings (yellow/red)
• Configurable update interval
• Multilingual support (English, German)
• Lightweight QML-based interface

• KDE Plasma 6.0+
• Qt 6.0+
• CMake 3.16+ (for building from source)
• Extra CMake Modules (ECM)

1. Right-click on your panel or desktop
2. Select "Add Widgets..."
3. Click "Get New Widgets" → "Download New Plasma Widgets"
4. Search for "Patient Timer"
5. Click "Install"

Alternatively, download the .plasmoid file from the KDE Store and install it manually:

kpackagetool6 --type Plasma/Applet --install ptimer-1.0.0.plasmoid

mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/usr
make
sudo make install

If kpackagetool6 is not installed yet, install it (on Debian 13+/Ubuntu 24.04+) with:

sudo apt install kpackagetool6

kpackagetool6 --install package/

kpackagetool6 --upgrade package/

kpackagetool6 --remove org.nerdocs.ptimer

1. Right-click on your panel or desktop
2. Select "Add Widgets..."
3. Search for "Patient Timer"
4. Click on it to add it to your panel or desktop
5. Click the timer display to reset it to 0:00

Right-click the widget and select "Configure Patient Timer" to adjust:

• Update interval: How often the timer updates (default: 1000ms)0
• Warning threshold: Time in seconds before background turns yellow (default: 600s / 10 minutes)
• Warning color: Color for warning state (default: #FFEB3B - yellow)
• Critical threshold: Time in seconds before background turns red (default: 900s / 15 minutes)
• Critical color: Color for critical state (default: #F44336 - red)
• Flash when paused: if enabled, time flashes when paused.

The widget supports multiple languages through KDE's i18n system:

• English (default)
• German (Deutsch)

To add a new language:

1. Copy package/translate/de.po to package/translate/YOUR_LANG.po
2. Edit the translations in the new file
3. Update build_translations.sh to include your language
4. Run ./build_translations.sh

For in-place development, symlink the package directory:

mkdir -p ~/.local/share/plasma/plasmoids
ln -s /path/to/ptimer/package ~/.local/share/plasma/plasmoids/org.nerdocs.ptimer

After making changes, restart the widget or run:

killall plasmashell && plasmashell &

ptimer/
├── package/
│   ├── contents/
│   │   ├── ui/
│   │   │   ├── main.qml           # Main QML interface
│   │   │   └── configGeneral.qml  # Configuration UI
│   │   ├── config/
│   │   │   ├── main.xml           # Configuration schema
│   │   │   └── config.qml         # Config registration
│   │   └── locale/
│   │       └── de/                # German translations
│   ├── translate/
│   │   └── de.po                  # German translation source
│   ├── metadata.json              # Widget metadata
│   └── metadata.desktop           # Desktop entry
├── install.sh                     # Installation script
├── build_translations.sh          # Translation build script
└── README.md                      # This file

MIT