- Full rename: CMake target, bundle, LaunchAgent label
  (com.dualfloatingclock.clock), QSettings org/app, tray tooltip,
  icns resource, build scripts, CI workflows, sample config
- Config XML: new root DualFloatingClockConfig; reader accepts legacy
  ClouckConfig root for painless migration of existing settings
- README rewritten: fork provenance (ivaquero/clouck), features, build,
  tests, usage
- Drop stale README-CN.md

2026-08-27 22:36:05 +03:00

2.6 KiB

Raw Permalink Blame History

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 by 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.

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

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.

2.6 KiB Raw Permalink Blame History