Skip to content
CyberGems edited this page Sep 12, 2026 · 6 revisions

Frequently Asked Questions

General questions about CyberClock features, configuration, and troubleshooting.


General

What is CyberClock?

CyberClock is a premium cyber-neon styled desktop clock application that combines a clock, calendar, timer, stopwatch, and relaxation module into a single lightweight app.

Is CyberClock free?

Yes. CyberClock is free and open source under the GPLv3 license. You can help keep it free here.

Does CyberClock work offline?

Yes. CyberClock works fully offline. Only auto-update checks require internet.


Clock

Can I switch between 12H and 24H format?

Yes. Go to Settings β†’ Appearance β†’ Time format.

Can I hide the seconds display?

Yes. Toggle "Show seconds" in Settings β†’ Appearance.

Can I rename the clock?

Yes. Set a custom Clock Name in Settings β†’ Appearance. An inline reset icon restores the default wordmark.

Can I hide the analog clock?

Yes. In Settings β†’ Appearance, hide the analog clock and the calendar takes the full width of the full-mode Home view.

What is the CRT scanlines effect?

A retro CRT monitor overlay. Toggle it in Settings β†’ Display (mini mode).


Calendar

Can I add notes to specific days?

Yes. Select a day in the calendar and open the note editor β€” Ctrl+Enter saves, Esc closes.

Does the calendar show moon phases?

Yes. Moon phase icons are displayed for each day.


Timer

Can I set custom timer durations?

Yes. Use the 9 preset buttons (1m to 2h, including 25m Pomodoro) or set a custom duration.

What happens when the timer reaches zero?

The "Time's up" overlay appears with an audible alert; press Esc or Dismiss to close it.


Stopwatch

How do I record laps?

Press the Lap button while the stopwatch runs.

Can I export lap data?

Yes. Click Copy to copy the lap table for pasting into other apps.

What statistics are shown?

Best lap, worst lap, average lap, and delta vs average.


Relaxation

What soundscapes are available?

Night, Forest, Outer Space, Ocean, Rain, and Fireplace.

Can I play two sounds at once?

Yes. Ctrl+Click any track card to blend it as a layer over the playing one (e.g. Rain + Fireplace). Layers fade in and out independently.

What does Pause do?

A true pause: audio, session timer, breathing pacer and tips freeze in place and resume exactly where they left off. Space toggles play/pause in the Relax view.

What is Zen Flow?

A one-click shuffle that plays all 6 tracks in random order.

There is no sound β€” what's wrong?

If global audio is muted, the Relax view shows a banner with a one-click Enable button. Also check the Relax volume in Settings β†’ General and your system volume.

What breathing patterns are supported?

Box Breathing (4-4-4-4) and 4-7-8 Breathing.

Are the sounds pre-recorded?

The primary source is procedural synthesis via the Web Audio API β€” no loops, infinite variation. Bundled audio files act as fallback.

Can I schedule relax sessions?

Yes. Settings β†’ Alarms β†’ Relax Scheduler: pick a start time, repeat interval, track and duration.


Alarms

Can I set custom alarms?

Yes. Up to 3 custom alarms with day-of-week repetition.

Can I use my own sound files?

Yes. Select "Custom sound" β€” the file is copied into the app data folder so it survives reinstallations.

How do I silence chimes at night?

Enable the schedule window in Settings β†’ Alarms and set start/end times.

What chime sounds are available?

Crystal Bell, Soft Chime, Neon Arp, Zen Gong, Aurora, and Music Box.


Mini Mode

What is Mini Mode?

A compact always-on-top clock bar that stays visible over other windows. Each of the 12 skins has its own dimensions.

How many skins are available?

12: Cyber Bar Pro, Holo Display, Digital Matrix, Glass Orb, Neon Circuit, Zen Minimal, Sunset Pulse, Frost Crystal, Neo Tokyo, Obsidian, Synthwave and Quantum.

What is Real Sun Cycle?

A Sunset Pulse (skin 7) option that follows your local sun position.

Can I lock the position?

Yes. Settings β†’ Mini Mode β†’ Lock position.

The mini clock blocks my clicks β€” can it pass them through?

Yes. Enable Click-through from the tray menu or Settings β†’ Display. (The toggle lives outside the mini window because it stops responding to clicks while on.)

Can I make the mini clock bigger or smaller?

Yes. Use the Zoom control (tray menu or mini context menu): 0.5Γ—, 1Γ—, 2Γ— or 4Γ—.


Startup & Updates

How do I start CyberClock with Windows?

The installer offers it (pre-checked), or toggle Settings β†’ General β†’ Start with Windows. Both manage the same registry entry, and the app reconciles the setting with the real registry at every boot.

How do updates work?

The app checks GitHub Releases on startup (configurable in the About window) and can install updates automatically. Manual check: About window β†’ Check for Update.


Troubleshooting

Windows shows a SmartScreen warning on install

Expected for new releases until Windows builds enough reputation for the file β€” see Installation & Setup: click More info, then Run anyway.

CyberClock doesn't start

  • Reinstall with the latest release
  • Check Windows Event Viewer for errors
  • Report it on GitHub Issues

No sound from relaxation module

  • Check the mute banner in the Relax view
  • Check system volume and the Relax volume in Settings β†’ General
  • Ensure audio drivers are working

Chimes not playing

  • Check if the chime interval is enabled
  • Verify the schedule window settings
  • Check volume settings

Mini Mode not staying on top

  • Enable "Always on top" in Settings β†’ Display
  • Check if another app is forcing topmost

Contributing

How can I report a bug?

Open an issue on GitHub Issues with:

  • CyberClock version
  • Windows version
  • Steps to reproduce
  • Expected vs actual behavior

How can I contribute code?

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request
  4. Describe your changes in the PR description

How can I help with translations?

UI strings are in src/shared/i18n.js. Submit a PR with your translation (all UI strings must exist in both English and Spanish).

How can I donate?

See the Donate section on the main README.

CyberClock Wiki

Core Features

Modes & Customization

Configuration

Reference


Changelog Β· Donate Β· GitHub

Clone this wiki locally