Skip to main content
Nguyen Ngoc Han
ProfileProjectsActivityContact
← All projects
horune

horune

In development

A local-first sleep timer and creative floating clock for your desktop. English · Tiếng Việt

Technologies

TypeScriptRustCSSPowerShellHTML

Role

Chủ kho mã trên GitHub

Problem

Quản lý lịch tác vụ desktop và hiển thị thời gian bằng đồng hồ nổi có thể tùy chỉnh.

Details

A local-first sleep timer and creative floating clock for your desktop. English · Tiếng Việt

Horune schedules Sleep, shutdown, screen lock, or a reminder while showing the remaining time in a customizable floating clock. It is designed for people who want a calmer end-of-session ritual without making a network connection part of a safety-critical timer. Scheduling, persistence, recovery, and countdown calculation stay on the device; the web experience shares the same declarative theme model and renderer.

Horune is preview software. There is no downloadable release yet, real system actions have not been validated on this machine, and simulation mode is the default. Contents

  • Current status
  • Screenshots
  • Features
  • Run locally
  • Use Horune
  • Architecture and safety
  • Testing and performance
  • Roadmap
  • Contributing and security
  • Author and license Current status
AreaStatusEvidence / limitation
Windows desktop UI and local scheduler sourceAvailable in sourceReact/Vite build and browser preview pass; Rust adapter is implemented
Windows native buildVerified in CIRust tests and the NSIS bundle pass; real power actions still need hardware validation
macOS native buildVerified in CI / hardware unverifiedRust tests and the DMG bundle pass; no physical Mac action test yet
LinuxPlannedReminder-only capability placeholder; no release target
Bilingual landing (/vi, /en)Available in sourceStatically generated and tested at desktop, tablet, and mobile sizes
Theme Studio coreAvailable in sourceShared web/desktop editor, renderer, draft storage, undo/redo, scoped shortcuts, Command Palette, and validated JSON import/export
Shared Horune AccountPlanned / provider ADR proposedNo active sign-in form; OIDC provider must pass the desktop PKCE and session proof gate
External image/GIF/SVG importPlanned nextLimits and security policy are documented; no UI button claims support today
Accounts, community, sharing, and remixPlannedRequires the shared API milestone
Marketplace and paymentsPlannedNo payment or paid-entitlement logic exists in clients

“Available in source” means the feature is implemented and covered by the checks listed below; it does not mean a signed public release exists. Screenshots

These are Playwright captures of the running local applications, not design mockups.

Landing pageDesktop scheduler preview

The last image is explicitly the running browser preview, not native-release evidence. The transparent native overlay is implemented, but no desktop-through overlay screenshot is presented because the host could not produce a Tauri executable. Responsive captures are available in docs/screenshots. Features

FeatureWhat works now
Local schedulingDuration or exact date/time; Sleep, shutdown, lock, or reminder; warning; pause/resume; +5 minutes; cancel; retained local history
Safe recoveryOne Rust scheduler; durable due/dispatching states; interrupted or overdue actions require confirmation and are never repeated automatically
SimulationEnabled on first launch; automated tests never invoke a real operating-system action
Floating clockShared renderer, truly transparent resizable Tauri surface, persisted position/DPI, Home, icon mode, native pin/unpin, idle controls, terminal result, and configurable auto-hide
Theme StudioDigital, analog, flip, word, and hybrid faces; colors and gradients; size, opacity, effect, date/seconds/action toggles
LayersAdd text or built-in stickers; select, drag, position, scale, rotate, hide, lock, reorder, and delete
Editing workflowZoom, grid, snap, up to 50 undo states, redo, duplicate/delete/nudge shortcuts, searchable Command Palette, local draft save/restore, reset, strict Theme JSON import/export, validated desktop apply/fallback
Motion and accessstatic, subtle, and full; reduced-motion support; visible focus; responsive web layout

See Theme Studio for the exact current/next/long-term boundary. Run locally Requirements

  • Node.js 24 or newer
  • pnpm 11
  • Rust stable
  • Windows: MSVC C++ Build Tools and WebView2
  • macOS: Xcode command-line tools

Run every workspace command from the repository root (the directory containing the root package.json). On Windows, if pnpm or Cargo is installed but the current PowerShell cannot find it, refresh PATH for that session:

If pnpm is not installed globally, use npx pnpm@11.19.0 install—there is no backslash before @. See development.md for permanent PATH setup and troubleshooting.

Open http://localhost:3000 (redirects to English), http://localhost:3000/vi, or the corresponding /studio route. There is no public release download yet. For testing, CI run #8 contains the unsigned horune-windows artifact (nsis/Horune_0.1.0_x64-setup.exe) and horune-macos artifact (dmg/Horune_0.1.0_aarch64.dmg). GitHub may require sign-in to download workflow artifacts.

Build and te

GitHub ↗Reference ↗

About the author

Avatar Nguyen Ngoc Han
Nguyen Ngoc Han

Software Engineer

Explore my experience, projects and source code.

View profile →GitHub →
—
ProfileProjectsActivityContact