Skip to content

lionfire/hudclock

Repository files navigation

HudClock

HudClock Icon

Build Status Latest Release Total Downloads License Platform .NET 8

A transparent, always-on-top clock overlay for Windows that provides unique time visualization options including 24-hour analog, metric time, and minimalist designs.

Overview

HudClock is a WPF application designed to provide an unobtrusive yet constantly visible time display. It offers multiple clock styles including traditional analog/digital formats as well as alternative time systems like metric time (10-hour days) and 24-hour analog displays.

Key Features

  • Multiple Clock Types: Analog (12/24-hour), Digital (12/24-hour), Metric time
  • Transparency & Click-through: Adjustable opacity with optional click-through mode
  • Customizable Appearance: Various styles, shapes, and visual options
  • Always-on-top Display: Persists above other windows
  • System Tray Integration: Minimize to tray with configurable visibility
  • High Performance: Configurable update rates up to 120fps for smooth animations

Screenshots

See HudClock in action in our features gallery.

Download & Installation

Download the latest release from the Releases page.

Available Versions

  • Self-contained (Recommended) - Single ~90MB executable with everything included
  • Framework-dependent - Smaller ~5MB executable (requires .NET 8 Desktop Runtime)
  • Portable - Traditional multi-file portable application

Security

The framework-dependent and portable builds are automatically scanned with VirusTotal when released. Scan results are included in each release's notes. The self-contained build exceeds VirusTotal's free API size limit (32MB) but uses the same verified source code.

Technical Details

  • Platform: Windows (WPF/.NET 8.0)
  • Architecture: MVVM pattern with data binding
  • Settings: JSON-based configuration stored in %APPDATA%/HudClock/
  • UI: Custom clock controls with hardware-accelerated rendering

Building

dotnet build

Running

dotnet run

Project Structure

  • /src/wpf/ - Main WPF application
    • Clock controls (Analog, Digital, Metric variants)
    • Settings management
    • Window management with transparency/click-through support