# DualFloatingClock

A menu-bar-first, dual-timezone floating clock for macOS, Windows and Linux — built with Qt6.

> **Fork provenance:** this project is a fork of [clouck](https://github.com/ivaquero/clouck)
> by [ivaquero](https://github.com/ivaquero) — a cross-platform floating clock.
> DualFloatingClock extends it with dual time zones, a flat tray menu, glyph outlines,
> per-element font sizing and a menu-bar-only presence (no Dock icon on macOS).

## What it does

A borderless, always-on-top clock that shows **two configurable time zones**
side by side — each with its own time and city name — plus a menu bar tray icon
for quick access to all settings. Designed for people working across time zones
who want the second (or third) clock glanceable, not hidden in world-clock widgets.

## Features

- **Dual time zones** — pick any IANA zone for each clock (`Europe/Bucharest`, `America/Los_Angeles`, …)
- **Floating clock** — frameless, always-on-top, drag anywhere, resizable from the corner; visible even in fullscreen spaces (macOS)
- **Menu-bar tray** — icon adapts to light/dark mode; flat context menu with every setting (no submenus, no clicking on the clock itself)
- **Text outline** — configurable glyph outline (color) under the text fill, so the clock stays readable on any wallpaper
- **Per-element fonts** — separate font sizes for the time and the city name (up to 200pt)
- **Colors via HTML/hex** — type `#00ff00`, `#80000000` (with alpha) or `transparent`; falls back to the native color picker
- **Start at Login** — toggle in the tray menu (macOS LaunchAgent)
- **Menu-bar-only on macOS** — no Dock icon, no ⌘Tab entry; lives in the menu bar
- **XML config** — persisted in the OS config location (e.g. `~/Library/Preferences/DualFloatingClock/DualFloatingClock/config.xml`)

## Build

Requires Qt6 (Core, Widgets, Test) and CMake ≥ 3.16.

```bash
cmake -S . -B build
cmake --build build

# macOS — run
open build/DualFloatingClock.app
# install to /Applications
cp -R build/DualFloatingClock.app /Applications/
```

qmake is also supported (legacy): see `build.sh` / `DualFloatingClock.pro`.

## Tests

```bash
cd build && ctest
```

Qt Test suites: `ConfigManagerTest` (XML round-trip, default path), `AutoStartManagerTest` (LaunchAgent contents, enable/disable round-trip).

## Usage

- **Move**: drag the clock · **Resize**: drag the bottom-right corner
- **Settings**: right-click the **tray icon** (the clock itself has no menu — dragging-friendly)
- Colors accept `#RRGGBB`, `#AARRGGBB` or `transparent`

## License

Same as upstream clouck — see [LICENSE](LICENSE).