Getting Started

Getting Clepsydre up and running takes two steps: install the app, then follow the setup wizard shown on the very first launch. A few minutes is enough to be ready to track your time.

1. Install the app

Download and install the desktop app for your system (Windows, macOS, or Linux).

The full procedure, package by package, is described on the dedicated page:

2. Complete the onboarding

On the first launch, Clepsydre shows the "Welcome to Clepsydre" wizard, in 3 steps. You can't skip it until the Redmine connection is valid.

Step 1 — Basic configuration

Fill in the Redmine connection and your main preferences:

• Redmine URL (required) — your instance address, for example https://redmine.example.com.
• API key (required) — your Redmine authentication key. You'll find it in Redmine, under My account > API access key. It is stored securely in your system keychain (never in plain text).
• Language — French or English (prefilled from your system).
• Theme — system, dark, or light.
• Launch at startup — open Clepsydre automatically when you log in.
• Minimize to tray — minimize the app to the notification area instead of closing it.

Step 2 — Tracking preferences

These defaults speed up time logging. They are all optional and can be changed later.

• Default activity — the Redmine activity preselected on each time entry (the list comes from the activities synced in step 1).
• Default comment — text prefilled in the comment field of a new entry.
• Daily work target — your daily goal in hours (1 to 24, in 0.5h steps), used by the calendar and statistics.

Step 3 — Browser extensions (optional)

The companion extensions let you start a timer directly from a Redmine issue page. No configuration is required.

Click Finish to save your configuration and enter the app.

3. What's next?

• For the details of all settings (including those not in the onboarding), see the Configuration page.
• To start your first tracking session, see Using the timer.