Hourglass Linux

The simple countdown timer originally for Windows, now on Linux.

Visit chris.dziemborowicz.com to learn more about the original project.

Requirements

• .NET 10 SDK. This repository is pinned to SDK 10.0.108 in global.json with rollForward set to latestFeature.
• Linux desktop runtime dependencies required by Avalonia.
• Network access for the first NuGet restore.

Build And Test

Use the modern Linux solution for current Linux development:

dotnet restore Hourglass.Linux.sln
dotnet build Hourglass.Linux.sln --configuration Release --no-restore
dotnet test Hourglass.Linux.sln --configuration Release --no-build --verbosity normal

The legacy Windows solution remains available as Hourglass.sln, but Linux port work should use Hourglass.Linux.sln.

Run Locally

Run the Avalonia Linux app from a graphical Linux desktop session:

dotnet run --project src/Hourglass.Linux.Avalonia/Hourglass.Linux.Avalonia.csproj

Right-click the timer surface to open timer actions and persistent notification, sound, and always-on-top options. Settings are stored in hourglass-linux/app.json under $XDG_CONFIG_HOME, or under ~/.config when XDG_CONFIG_HOME is not set. Always-on-top uses Avalonia's standard Topmost window hint; some Wayland compositors may ignore that hint.

Restricted Environments

If the local environment blocks writes under the default .NET CLI home, prefix the commands with a writable CLI home:

DOTNET_CLI_HOME=/tmp/hourglass-dotnet-home dotnet restore Hourglass.Linux.sln
DOTNET_CLI_HOME=/tmp/hourglass-dotnet-home dotnet build Hourglass.Linux.sln --configuration Release --no-restore
DOTNET_CLI_HOME=/tmp/hourglass-dotnet-home dotnet test Hourglass.Linux.sln --configuration Release --no-build --verbosity normal