rofi-clockify

Access clockify via rofi prompt using clockify-cli.

This project is still under heavy development.

Project is inspired by the only similar project clfy.

Installation

See INSTALL.md for detailed installation instructions using Nix flakes.

Quick Start with Nix

# Run directly without installing
nix run github:k11m1/rofi-clockify -- init

# Or install to your profile
nix profile install github:k11m1/rofi-clockify

# Or enter a development shell
nix develop

usage

Usage: rofi-clockify [init|start|start-dmenu]
Commands:
  init                      Perform database initialization
  start|start-dmenu         Select and start-dmenu clockify entry
  stop                      Stop current entry with clockify-cli out

For better use consider having start and stop mapped to some shortcut.

Tip: After installation, rofi-clockify appears as a system application. You can bind its start-dmenu and stop actions to custom keyboard shortcuts for fast time tracking control. See INSTALL.md - Application Integration for more details.

initialization

You need to first initialize the database to properly use it. For initialization of the internal database run init or start and press ALT+1 to get into admin menu and choose init.

The database file is stored at ~/.cache/rofi-clockify.db (or $XDG_CACHE_HOME/rofi-clockify.db if set).

Dependencies

• clockify-cli - Provided via clockify-cli-flake
• rofi
• libnotify (for desktop notifications)
• Perl with DBI, JSON, and SQLite support

All dependencies are automatically managed by the Nix flake.

Changes Made with AI

This project was edited with AI to include a Nix flake for easier installation on NixOS.

Perl Dependency Updates

• notify-send replaces Desktop::Notify.
• Compatible with DBI, JSON, and SQLite modules.

(Note: Not all dependency changes were tested.)