Skip to content GitHub
Guide contents
English View source

FAQ

English · Español

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, relaxation module, and independent floating time tools 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.

What is the CRT scanlines effect?

A retro CRT monitor overlay that simulates the look of old cathode ray tube displays. Toggle in Settings → Mini Mode.

Calendar

Can I add notes to specific days?

Yes. Select a day in the calendar and click to add a note.

What is shown in the agenda?

The agenda displays upcoming events, scheduled items, and notes for specific days.

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 preset buttons or set a custom duration.

What happens when the timer reaches zero?

An audible alert plays (if enabled) and a visual notification appears.

Can I open a timer or stopwatch without opening the full window?

Yes. Choose New Timer or New Stopwatch from the system tray menu or Mini Mode context menu. Each floating window keeps its own state.

Do floating timer presets start the countdown?

No. The 30s, 1m, 5m, 10m, and 15m presets add time to the armed total. Press Start when you are ready.

Stopwatch

How do I record laps?

Press the Lap button or use the L key while the stopwatch is running.

Can I export lap data?

Yes. Click "Copy to clipboard" 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.

What breathing patterns are supported?

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

Are the sounds pre-recorded?

No. Sounds are procedurally synthesized using the Web Audio API, no loops, infinite variation.

Alarms

Can I set custom alarms?

Yes. The Alarms view holds as many alarms as you need: once, every day, weekdays, weekends, or selected days, with a message, a sound, and a repeat count.

Can I use my own sound files?

Yes. In the alarm designer, choose Use your own sound and pick an MP3 or WAV. Hourly chimes still accept their own file from Settings → Time → Hourly Chimes.

How do I silence chimes at night?

Set a schedule window in Settings → Time with start/end times.

Mini Mode

What is Mini Mode?

A compact always-on-top clock bar whose dimensions vary by skin and zoom, staying visible over other windows.

How many skins are available?

15 unique skins including Titanium Mech, Holo Display, Glass Orb, Sunset Pulse, and Quantum.

Can I personalize the welcome greeting?

Yes. Enter your name under Settings → General → Welcome. CyberClock uses it in the time-aware greeting shown beside the brand when Full Mode opens.

Can I lock the position?

Yes. Right-click Mini Mode → Lock position.

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

  • Ensure Tauri dependencies are installed
  • Try running as Administrator
  • Check Windows Event Viewer for errors

No sound from relaxation module

  • Check system volume
  • Verify volume slider in relaxation module
  • Ensure audio drivers are working

Chimes not playing

  • Check if chimes are enabled
  • Verify schedule window settings
  • Check volume settings

Mini Mode not staying on top

  • Enable "Always on top" in settings
  • 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.

How can I donate?

See the Donate section on the main README.

← All documentation