sebastian
45fc172fc8
Build and Release DualFloatingClock / build-linux (push) Failing after 32s
CI Build / build (macos-latest) (push) Canceled after 0s
CI Build / build (windows-latest) (push) Canceled after 0s
Build and Release DualFloatingClock / build-macos (push) Canceled after 0s
Build and Release DualFloatingClock / build-windows (push) Canceled after 0s
Build and Release DualFloatingClock / generate-changelog (push) Canceled after 0s
Build and Release DualFloatingClock / create-release (push) Canceled after 0s
- 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
62 lines
2.6 KiB
Markdown
62 lines
2.6 KiB
Markdown
# 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).
|