The owner renamed the product and moved the repository to the self-hosted Gitea (https://gitea.encke-hake.ts.net/BalboSoft/Chronos) for more control, and asked for Actions and a first automatic release with the server package and the Windows exe (docs/requests/2026-10-23-chronos-gitea.md). - Chronos everywhere: a byte-exact rename of contents and paths, then a per-language review of the forms the old name's ending had dictated. - Gitea instead of GitHub: the update check, licence, issue and support links read ChronosReleasesUrl; the update check takes the highest stable version, offers a pre-release build its final release and reports a repository it cannot see as a failed check. EULA, security policy and Gitea issue forms live at the repository root. - Gitea Actions for the Linux act_runner (.gitea/workflows): CI, release, nightly image and performance gates in the .NET SDK container with git checkout and the system SQLite. The release cross-compiles the Windows programs, checks their icon, version and DPI manifest, packs installers and zips, publishes the Gitea release and pushes the server image (REGISTRY_TOKEN). Windows-only tests run in an opt-in job on a Windows runner (WINDOWS_RUNNER). - New Chronos.Tools commands: zip, gitea-release, postgres-ci (replaces the docker-exec script, which Gitea's service containers do not allow; the throw-away server runs without durability) and pe-check. - Timed tests take their budget from TestTiming (CHRONOS_TEST_TIME_FACTOR, 3 on the shared runner; the weekly performance gates keep theirs). BREAKING CHANGE: programs, settings, data folders, file types, environment variables and the Docker image use the new name; nothing is migrated from Titano, which never had a release. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Alberto Balbo <alberto.balbo.96@gmail.com>
Screenshot baselines
The approved look of every screen, one PNG per --capture screenshot (<screen>-<theme>.png, as Chronos.exe,
Chronos.Uploader.exe and Chronos.Setup.exe --capture <dir> write them). CI compares each new screenshot with the
file of the same name here (BRIEF §20.2, visual regression with a pixel-diff tolerance):
dotnet run --project src/Chronos.Tools -- screenshots diff out/screenshots --out out/screenshot-diff
- A pixel differs when one of its channels moves by more than
--tolerance(default 8 of 255); a screen fails when more than--max-diffof its pixels differ (default 0.0005, that is 0.05 %), when its size changed, or when a baseline here has no screenshot any more. - A screenshot without a baseline fails as soon as this folder holds any PNG: a pull request that adds a screen adds its baselines too.
- While this folder holds no PNG nothing is compared: the step passes, with a warning in the log saying that no visual change can fail it.
out/screenshot-diffgets<screen>-diff.pngfor every screen with differing pixels (the baseline faded to grey, the differences magenta) andsummary.md; they stay in the work folder of the Windows runner (Gitea Actions keeps no artifacts here), and the job log lists every screen that failed.
The pictures are reproducible
The capture runs on sample data whose clock stands at SampleData.Now (2026-10-02 10:18 UTC), in English with English
formats and with animations off, so the same code draws the same pixels on any day. Two things still come from the
machine:
- the time zone: times are shown in local time, and the baselines are made on the Windows runner of CI's
windowsjob (WINDOWS_RUNNER), which compares them in its own time zone; - a few measured values: the server's response time and the time and duration of the last sync comparison. They change a few dozen pixels, well inside the allowed fraction.
Adding or updating baselines
Take them from CI, never from another PC (fonts, scaling and the time zone differ). On the Windows runner, every
same-repository pull request pushes its screenshots to the ci-screenshots branch (one commit, the PNGs at its root).
After checking them:
git fetch origin ci-screenshots
git worktree add ../ci-screenshots origin/ci-screenshots
dotnet run --project src/Chronos.Tools -- screenshots accept ../ci-screenshots
git worktree remove ../ci-screenshots
screenshots accept <dir> copies every PNG of <dir> here. Commit only the screens whose change is intended, and delete
the baseline of a screen that no longer exists.
The first baselines
None is committed yet. Screenshots captured before the capture was made reproducible cannot serve: their times and
dates follow the moment they were taken (a job finished at "12:18 AM", sample sequences dated from that day). The first
baselines are accepted, all at once, from the ci-screenshots commit of the first green windows job run whose code
captures at SampleData.Now; from that commit on, every screen is gated.