Support & FAQ
Can’t find what you need? Email us and we’ll get back to you.
General
What is ChronoKit?
ChronoKit is a free, ad-free time and date toolkit. It covers world clocks, timezone conversion, calendars, date calculators, astronomy (sunrise/sunset, moon phases), weather, timers, countdowns, and embeddable widgets — all in one place.
Do I need an account to use ChronoKit?
No. All tools are available without signing in. An account lets you save your favourite locations, create countdowns, store events, and use the developer API.
How do I sign in?
Go to Sign In and choose GitHub or Google OAuth. No password is stored — we only receive your email address and display name from the provider.
Is ChronoKit free?
Yes — the website is completely free. A paid plan is available if you need higher API rate limits or additional AI chat quota for programmatic access.
Account & Data
Where are my saved locations and events stored?
They are stored in your account on our servers (PostgreSQL, hosted in the EU). When you are signed out they fall back to your browser's local storage so nothing is lost.
How do I delete my account?
Email us at support@chronokit.io and we will delete your account and all associated data within 30 days, in line with your GDPR right to erasure.
What data does ChronoKit collect?
See our Privacy Policy for the full picture. In short: email + name from OAuth (account users), anonymous usage counters (API traffic), and strictly necessary session cookies. No tracking pixels, no ad networks.
Can I export my data?
Your saved locations and events are accessible at any time via your account. For a full data export under GDPR Art. 20, email support@chronokit.io.
API & Developer Keys
How do I get an API key?
Sign in, then go to Account → API Keys and click “Create key”. Copy the key immediately — it is shown only once.
What can I do with the API?
The REST API exposes the same data as the website. Current endpoints cover: timezone info & conversion, sunrise/sunset, moonrise/moonset, moon phases, planet positions (altitude & azimuth), sun position, golden hour windows, tidal forecasts, meteor showers, eclipses, seasons, holidays, weather forecasts, date calculations (duration, business days, age, week number), and more. Full documentation with live examples is at /developers and the machine-readable spec is at /api/openapi.json.
What are the rate limits?
| Plan | Requests / day |
|---|---|
| Free | 100 |
| Starter | 1,000 |
| Pro | 10,000 |
| Enterprise | Unlimited |
My API key stopped working — what should I check?
- Check the key status in Account → API Keys. A revoked key shows as “inactive”.
- Confirm you are sending the key in the
X-Api-Keyheader, not a query parameter. - Check your plan’s daily rate limit — it resets at midnight UTC.
- If the key is active and within limits, email support@chronokit.io.
Plans & Billing
How do I upgrade my plan?
Go to Account → Plans & Billing and choose a plan. Payment is handled securely by Stripe — ChronoKit never sees your card details.
Can I cancel at any time?
Yes. Cancel from the billing page and your plan stays active until the end of the current billing period. No questions asked.
Do you offer refunds?
If you are not satisfied within the first 7 days of a new paid plan, contact us and we will issue a full refund.
Is there an annual discount?
Email support@chronokit.io to ask about annual billing — we can arrange it manually while we build it into the UI.
Features & Tools
How accurate is the astronomy data?
Sunrise, sunset, moonrise, and moonset times are computed with astropy — the same library used by professional observatories. Accuracy is within ±1 minute for most locations.
Why is my local time wrong?
ChronoKit reads your browser's reported timezone. If it looks wrong, check your operating system's timezone setting. You can also manually select any timezone in the world clock or timezone converter.
What is the AI chat assistant and what can it do?
The AI Chat assistant is powered by Claude (Anthropic). You can ask it time and date questions in natural language — “What time is it in Tokyo?”, “How many days until Christmas?”, “When is the next solar eclipse?” — and it draws on ChronoKit’s live data. Free accounts have a daily message limit; paid plans get a higher quota.
Are my timers and countdowns saved across devices?
Timers and stopwatches run locally in your browser tab — they are not persisted between sessions or synced across devices. Countdown events (saved via your account) are stored server-side and available on any device when signed in.
How do I create a calendar (.ics) event file?
Go to Create Calendar Event. Fill in the event details, then click Download — you get a standard .ics file compatible with Google Calendar, Apple Calendar, Outlook, and any other calendar app. You can add multiple events to a single file using the batch editor.
How does the Word Clock work?
The Word Clock displays the current time as highlighted words in a letter grid — the same style as the popular physical clocks. It updates every minute and uses your browser’s local time.
How does the Sky Map work?
The Sky Map shows an interactive all-sky polar projection for any location and time. The centre is the zenith (directly overhead) and the edge is the horizon. Planets are fetched in real time from ChronoKit’s astronomy API; bright stars are computed client-side from a built-in star catalogue using sidereal time. Enable Live mode to have the view update automatically, or set a custom date and time to explore the past or future sky.
What is the Golden Hour calculator?
The Golden Hour & Alpenglow calculator shows the exact windows of warm, diffuse light that photographers and filmmakers look for: astronomical and nautical twilight, blue hour, golden hour, and the alpenglow window around sunset. Times are computed for your chosen city and date.
I found a bug or have a feature request — where do I report it?
Open an issue on GitHub or email support@chronokit.io. We read everything.
Widgets & Embeds
How do I embed a ChronoKit widget on my website?
Go to Widgets, configure the type and city, then copy the generated
<iframe> snippet. Paste it into any HTML page — no account required, no JavaScript needed on your end.Which widget types are available?
- Digital Clock — live time for any timezone
- Analog Clock — classic SVG clock face
- World Clock — up to 4 cities side by side
- Countdown — counts down to any future date and time
- Sunrise & Sunset — today’s sun times with a progress arc
Can I customise widget colours and themes?
Yes — each widget supports a light and dark theme, selectable in the widget builder. The builder also previews the widget live before you copy the embed code.
Weather & Tides
Where does weather data come from?
Weather data is fetched from Open-Meteo, a free and open-source weather API using data from national weather services (NOAA, DWD, ECMWF, and others). Forecasts are updated every hour.
How often is weather data refreshed?
The weather forecast is cached for up to one hour. Searching a new city or refreshing the page fetches the latest available data.
Which locations are supported for tide data?
Tide data is available for coastal cities worldwide. Search for any coastal city by name — if tide stations exist near that location, the data will appear. Inland cities will show no tidal results.
How accurate is the tidal forecast?
Tidal predictions are computed from harmonic constituents for the nearest reference station. Accuracy is typically ±15 minutes and ±10 cm for most major ports; less predictable in shallow estuaries or complex coastlines.
Still need help?
Email us at support@chronokit.io. We typically respond within one business day.