A sleek, frameless desktop clock built with .NET 10 + Avalonia 11. Runs natively on Windows and Linux. Track time across any number of cities simultaneously, visualise a full-day 24-hour timeline across all your timezones at a glance, and customise every detail — from accent colours to transparency.
| Feature | Description |
|---|---|
| Multi-city clocks | Live, ticking clocks for as many cities as you need, each with a unique accent colour |
| UTC card | Always-present UTC card is editable (rename, recolour), searchable in the city picker, and its state persists across restarts |
| Home location | Mark one city as home — all other cards show their time difference relative to it |
| Time Visualizer | WTB-style 24-hour grid that shows the full day (00:00 – 23:30) across every timezone simultaneously |
| +1 day detection | The visualizer automatically highlights cells that belong to the next calendar day in orange |
| City search backed by airports | Thousands of cities searchable by name, country, or IATA code — including UTC / Z / UCT |
| 11 built-in themes | Dark Default, Light Default, One Dark, Monokai, Solarized, Nord Dark, Tokyo Night, Catppuccin Mocha/Latte, Ariake Dark, and more |
| Transparency | Live opacity slider — see your desktop through the window |
| Edit & Delete mode | Always-visible mini-settings icons in the clock panel header |
| Stateful | All cities, home location, theme, and opacity persist across restarts |
| Cross-platform | Runs on Windows 10/11 and Linux (Debian/Ubuntu .deb package) |
- Debian / Ubuntu (or any distro with
dpkg) - .NET 10 SDK — download
- ImageMagick (only for regenerating icons) —
sudo apt install imagemagick
# 1. Clone
git clone https://github.com/david8128/worldclock.git
cd worldclock
# 2. Run directly
dotnet run --project WorldClock/WorldClock.csproj -c ReleaseThe window is frameless — drag anywhere to move it. Use the ⚙ gear icon to open Settings.
Requires Inno Setup 6 and PowerShell 7+.
# Build and optionally upload to GitHub Releases
.\scripts\Build-WindowsInstaller.ps1
.\scripts\Build-WindowsInstaller.ps1 -Upload -GitHubRepo david8128/worldclock
# Regenerate icons before building (needs WSL + ImageMagick)
.\scripts\Build-WindowsInstaller.ps1 -GenerateIcons -Upload -GitHubRepo david8128/worldclockThe installer is written to installer/Output/WorldClockSetup.exe.
Run inside WSL2 (or any Debian/Ubuntu shell):
# Build and optionally upload to GitHub Releases
bash scripts/build-linux-deb.sh
bash scripts/build-linux-deb.sh --upload --repo david8128/worldclockThe .deb is written to publish/linux-deb/.
Icons are pre-generated from WorldClock/Images/Logo.png and committed. To regenerate after changing the logo:
bash scripts/generate-icons.shThis produces:
WorldClock/Images/hicolor/<sz>x<sz>/worldclock.png— 13 freedesktop hicolor sizesWorldClock/Images/Logo.ico— multi-resolution Windows ICO (16 / 32 / 48 / 64 / 128 / 256 px)
Requires ImageMagick (convert).
The city catalogue is derived from a global airports dataset (IATA / ICAO codes, timezone, GPS coordinates) published on Kaggle by samvelkoch.
Because every commercial airport has an authoritative IANA timezone assignment, airports make an excellent proxy for "cities with known timezones". The Python pipeline at WorldClock/citiesdb/generate_world_cities_timezones.py downloads the raw dataset, deduplicates by city, resolves DST-safe UTC offsets, and writes world_cities_timezones.csv.
Tip: You can search by city name or by IATA code. Typing
BOG,LAX, orNRTjumps straight to Bogotá, Los Angeles, or Tokyo Narita.
Right-click (or use edit mode) on any clock card and choose Set as Home. The home card gains a highlighted border and all other cards show a +Xh / -Xh badge relative to it. The Time Visualizer also re-anchors its column headers to your home timezone.
- Each column is a 30-minute slot (48 columns = full 24 hours).
- Orange vertical bar on a cell means that slot crosses midnight into the next day (
+1dshown on the row header). - Click any slot to pin the selection marker and see translated times for all cities in the result panel below.
Open Settings → Appearance and pick from 11 curated themes. Changes apply live — no restart needed.
Drag the Opacity slider in Settings. At low values the window blurs the desktop behind it using Windows acrylic composition.
The window has no title bar. Double-click anywhere on the background to toggle maximise. Right-click the header area for a context menu with Minimise / Close options.
worldclock/
├── WorldClock/ # Main Avalonia application
│ ├── Data/ # City search & airport CSV loader
│ ├── Helpers/ # Value converters, theme helpers
│ ├── Models/ # ClockLocation, AppTheme, TimeGrid*
│ ├── Services/ # ThemeService, SettingsService
│ ├── ViewModels/ # MainViewModel, TimeTranslatorViewModel
│ ├── Images/ # Logo.png, Logo.ico, hicolor/ icon tree
│ ├── Assets/ # Fonts (NotoColorEmoji)
│ ├── citiesdb/ # Python pipeline to regenerate the city CSV
│ ├── Program.cs # Avalonia app entry point
│ ├── App.axaml / App.axaml.cs # Application definition
│ ├── MainWindow.axaml/.cs # Shell window
│ ├── SettingsWindow.axaml/.cs # Settings panel
│ ├── DiagnosticsWindow.axaml # Diagnostics / debug panel
│ └── Styles.axaml # Shared control styles
├── WorldClock.Tests/ # xUnit test suite
├── Features/ # Gherkin feature files (living spec)
├── scripts/
│ ├── build-linux-deb.sh # Builds Linux .deb + optional GitHub upload
│ ├── Build-WindowsInstaller.ps1 # Builds Windows installer + optional GitHub upload
│ └── generate-icons.sh # Generates hicolor PNGs + Logo.ico from Logo.png
├── installer/
│ └── WorldClock.iss # Inno Setup script
├── images/ # Screenshots and reference images
└── README.md
dotnet test WorldClock.Tests/WorldClock.Tests.csproj --filter "Category!=UI"205 unit and integration tests covering view-models, settings persistence, city search, and time translation logic.
| Document | Contents |
|---|---|
| docs/architecture.md | WPF design canvas, MVVM wiring, scale modes |
| docs/city-database.md | Airport dataset pipeline, CSV schema, how to regenerate |
| docs/themes.md | All built-in themes with their accent colours |
| docs/time-visualizer.md | Time Visualizer deep-dive: grid model, selection, +1d logic |