hjLabs.in

Made in India

Official User Guide  ·  v1.0

VibeClock

VibeClock

The LED desk clock that keeps your AI usage in sight — plus the time, news, weather and markets.

Why VibeClock exists

So you never get cut off by a usage limit by surprise, and the things you glance at all day live in one bright, quiet display on your desk.

VibeClock shows how much of your Claude and ChatGPT Codex limits are left, live, with the time until they reset. Around that it rotates whatever else you choose: the clock, date, weather for your PIN code, news from the publishers you pick, markets, live cricket and football, festivals, reminders and countdowns. Everything is set from a web page on your phone or laptop — no account, no cloud, no subscription.

AI usage at a glance

Claude and Codex session and weekly limits, with reset countdowns.

19 panels

Clock, weather, news, markets, sports, calendar, reminders and more.

Set up from your phone

The free app finds the clock on your WiFi. Any browser works too.

Free updates

New features arrive over WiFi. Nothing to install, no subscription.

Guide edition
v1.0
17 November 2026
Documents firmware
1.9.2
phone app 1.0.0
Check your version
The admin page shows it at the bottom, and under Settings → Firmware update.
QR code to the online guide
Online guide
hjlabs.in/vibeclock/guide

VibeClock receives free updates, so a screenshot may differ slightly from your clock. A no-warranty / no-liability notice appears on page 2.

Get the free VibeClock app — scan the one for your phone
QR code: arm64 APKAndroid — most phones
every phone from the last 6 years
…/vibeclock-app-1.0.0-arm64.apk
QR code: armv7 APKOlder phones (32-bit)
if the first one will not install
…/vibeclock-app-1.0.0-armv7.apk
QR code: x86_64 APKEmulators & Chromebooks
x86 Android devices
…/vibeclock-app-1.0.0-x86_64.apk
hjLabs.in
VibeClock · Official User Guide · v1.0

00 · Contents

How to read this guide

Every figure is a real screenshot

Every Figure is a screenshot of the VibeClock admin page running on a real clock, captured at 2× so it stays sharp when printed. Numbered balloons sit on the exact control described, and each one has a row in the key under the figure.

On screen: hover a balloon or its key row to highlight the pair. Click a figure to open it full-screen. The ① button on the right-hand rail hides the balloons. The printed copy always keeps them.

Conventions

BoldA control you press or a value you type — Save changes, admin123.
monoAn address or command — vibeclock-name.local.
①②③A balloon on a figure; the same number is in the key.
§04A cross-reference. Click it on screen to jump there.
Orange boxUseful to know — a tip or a shortcut.
Yellow boxRead it: something here can lock you out or lose settings.
§Section
01Quick start — from the box to your first panel
02The admin page — anatomy of the screen
03Panels & rotation — all 19 panels
04Clock, date & weather
05Claude & Codex usage
06News — publishers, sections, filters
07Sports — scores, sounds, tournaments
08Settings — look, sound, displays, updates
09Phone app & network
10Text API, agents & arcade
11Troubleshooting & support

What you need

2.4 GHz WiFi — home or office. 5 GHz-only networks are not supported.
A USB power adapter — 5 V, 1 A or more, and the supplied cable.
A phone or computer on the same WiFi, with any modern browser — or the free Android app (§09).

The words you need

MatrixThe LED display: 32 × 8 dots per module, up to 4 modules side by side.
PanelOne thing the matrix shows — the clock, the weather, the news…
RotationThe order the switched-on panels play in, one after another.
MarqueeText that scrolls across the matrix from right to left.
Admin pageThe clock's own web page where you change everything.
HotspotThe WiFi network the clock creates itself, named VibeClock, for first setup.
OTA updateNew firmware installed over WiFi, without a cable.
KeyYour admin password, also used by scripts and AI agents.
⚠ IMPORTANT — NO WARRANTY & NO LIABILITY. The VibeClock firmware, the phone app and this guide are provided “as is”, without warranty of any kind, express or implied, including merchantability and fitness for a particular purpose. Information shown on the clock (AI usage, scores, prices, news, weather, holidays) comes from third-party services and may be late, incomplete or wrong; do not rely on it for financial, medical or safety decisions. Power the clock only from a 5 V USB supply, keep it dry, and do not leave it where it can overheat. To the maximum extent permitted by law, neither hjLabs.in nor its proprietor is liable for any loss arising from the use of, or inability to use, the product, the software or this guide. Hardware warranty, if any, is as stated on your invoice.
VibeClock · Official User Guide v1.0hjLabs.in
hjLabs.in
VibeClock · Official User Guide · v1.0

01 · Quick start

From the box to your first panel

Five steps, about five minutes. Nothing to install on a computer.

1 · Power it

Plug the USB cable into a 5 V adapter. The matrix plays the hjLabs intro, then looks for WiFi.

2 · Join its hotspot

First time only: on your phone, join the WiFi called VibeClock. A setup page opens; if not, open 192.168.4.1.

3 · Give it your WiFi

Pick your home network, type its password, press Connect. The clock joins and the hotspot switches off.

4 · Open the admin page

Open the VibeClock app, or the address the matrix scrolls, such as vibeclock-fancy-reef.local.

5 · Sign in

Factory password: admin123. Tick Remember me. Change the password soon (§08).

6 · Choose panels

Switch panels on, set their seconds, press Save changes. The matrix follows at once.

Finding the clock's address

EasiestThe VibeClock app lists every clock on your WiFi by name. Tap one. (§09)
Read the matrixSwitch on the Network info panel: it scrolls the clock's IP address and name.
By namehttp://vibeclock-<two words>.local works on most computers and iPhones.
By IPYour router's list of connected devices shows the clock as vibeclock-….

Your first five minutes — a good set-up

  1. ① Open Clock → pick your time zone and 12/24 hour.
  2. ② Open Weather → type your city or PIN code and tap the right result.
  3. ③ Open Claude usage → Open sign-in and follow the steps (§05).
  4. ④ Open News → tick two or three publishers and your sections.
  5. ⑤ Press Save changes, then watch the Live display mirror the matrix.
The hotspot comes back by itself. If the clock cannot reach your WiFi (new router, changed password), it raises its VibeClock hotspot again and the matrix scrolls the steps. Join it and enter the new details.
Only 2.4 GHz. Dual-band routers usually broadcast both under one name; that is fine. A 5 GHz-only network will not appear in the list.
Keep the password safe. Anyone on your WiFi with the password can change the clock. Change the factory password in Settings → Admin password. Forgot it? See §11.
LOCKED on the matrix? The clock needs its one-time activation. Send the device id it shows to hjLabs and enter the code you receive on the admin page.

Meet your clock

Front of VibeClock

Front — a 32 × 8 red LED matrix behind a clear acrylic face.

Back of VibeClock with the buzzer

Back — the buzzer for alerts and tunes; the USB power cable enters at the side.

VibeClock on a shelf

Placement — stands on a desk or shelf; the top tabs let you hang it on a wall.

Stuck in the first five minutes? Start here

What you seeWhyWhat to do
No VibeClock hotspotThe clock already joined a saved WiFi.Read its address from the matrix or use the app. To start over, use Settings → WiFi → Forget network.
The .local name does not openSome Android phones and routers do not support .local names.Use the app, or the IP address the matrix scrolls.
Password is refusedIt was changed.Reset it to admin123 by restarting the clock four times in a row (§11).
Matrix is blank or dimBrightness 0, or a weak USB adapter.Raise Brightness in Settings; use a 5 V / 1 A adapter.
VibeClock · Official User Guide v1.0§01 Quick start
hjLabs.in
VibeClock · Official User Guide · v1.0

02 · The admin page

Anatomy of the screen

One scrolling page: a live mirror of the matrix at the top, then every panel in the order it plays.

VibeClock admin page 1 2 3 4 5 6 7 8 9 10 11 12 13
  1. 1Brand — your clock's admin console. The firmware version is at the foot of the page.
  2. 2Network — WiFi name, signal, address, name. Green dot = connected. §09
  3. 3Text API — push messages from scripts and AI agents. §10
  4. 4Arcade — the one-button games and high scores. §10
  5. 5Settings — look, sound, displays, WiFi, updates, password. §08
  6. 6Live display — exactly what the matrix shows right now.
  7. 7LIVE badge — the mirror is updating. If it says otherwise, the clock is busy or offline.
  8. 8Panel preview — a small live preview of how the panel will look.
  9. 9Panel name — tap it to open the panel's own settings.
  10. 10Seconds — how long the panel stays. A scrolling line always finishes first.
  11. 11On / off — switched-on panels join the rotation.
  12. 12Preview — show this panel on the matrix for 12 seconds, right now.
  13. 13Open — the panel's own settings: sources, fonts, speed and more.

Figure 02.1 — The admin page, 1180 × 860 logical px, firmware 1.9.2.

Saving. Changes collect until you press Save changes in the bar at the bottom of the page; Discard undoes them. Brightness, invert and full-height text preview on the matrix immediately.
Works on any screen. The page adapts to a phone. On Android the VibeClock app opens it for you; on any phone you can also add it to the home screen from the browser menu.
VibeClock · Official User Guide v1.0§02 The admin page
hjLabs.in
VibeClock · Official User Guide · v1.0

03 · Panels & rotation

What the matrix shows, and in what order

The matrix plays every switched-on panel, top to bottom in the order of the admin list, then starts again.

Order = the list

Exactly the order of the admin page. A panel with nothing set up says so instead of disappearing.

Seconds are a minimum

A scrolling line always finishes before the next panel slides in, so you can read every word.

Per-panel speed

Each panel can scroll faster or slower than the rest. Default follows Settings.

PanelWhat it shows — and where to set it up
NoticeYour own scrolling messages, each line switchable — shop offers, welcome notes.
SayingsOne healthy-lifestyle tip per turn; edit, switch off or add your own (up to 40).
ClockBig digits or text styles, seconds, 12/24 h, AM/PM marker, blinking colon. §04
World clockThe time in the cities you choose, with your own labels.
Date12 formats, scrolling or standing still. §04
WeatherYour city or PIN code; temperature, feels-like, humidity, wind, rain, pressure, in your units; sunrise, UV, air quality, moon. §04
RemindersUp to 6: once, daily or every N minutes within hours; the matrix rings them with beeps.
Social countsYouTube subscribers, GitHub stars and followers, Instagram followers, with milestone celebrations.
CountdownsDays and hours to your dates or festivals, or time since a date.
Market tickerCrypto, stocks, indices and currencies, with price alerts.
Dev statusCI build results, website uptime, commits today — with alerts when something goes down.
NewsHeadlines from 22 publishers by section, with a smart filter. §06
Pixel artYour own drawings and 15 ambient animations: fire, rain, plasma, fireworks…
CalendarPanchang (tithi, nakshatra, choghadiya), Hijri date, festivals and public holidays incl. India.
Queue numberA token number for shops and clinics, with + / − / reset controls and beeps.
Claude usageClaude session and weekly limits, reset times, four looks. §05
Codex usageThe same for ChatGPT Codex. §05
Sports scoresLive cricket, football, NBA and NFL from free feeds, with sounds. §07
Network infoThe clock's IP address and name — handy when you need its address.
Every panel has the same tools when you open it: its own settings, a Font choice (normal, bold, italic, wide) and a Marquee speed slider with a Default button.
Panel changes animate. Pick the animation — slide, slant wipe, dissolve and more — under Settings → Displays. Every tile there plays its own preview.
VibeClock · Official User Guide v1.0§03 Panels & rotation
hjLabs.in
VibeClock · Official User Guide · v1.0

04 · Clock, date & weather

The everyday panels

Weather panel settings 1 2 3 4 5 6 7 8
  1. 1Place — type a city or a PIN / postal code; results show city, region, country and postcode.
  2. 2PINNED / BY NAME — pinned = forecast for exactly the spot you picked.
  3. 3Confirmation — the region, country and postcode of the pinned place.
  4. 4Units — °C/°F, km/h, mph, m/s or knots, mm or inches, hPa, inHg or mmHg.
  5. 5Also show — sunrise & sunset, UV index, air quality, moon phase.
  6. 6Font — normal, bold, italic or wide, for this panel only.
  7. 7Marquee speed — this panel's scroll speed.
  8. 8Default — back to the speed set in Settings.

Figure 04.1 — Weather panel, opened. The matrix reads GANDHINAGAR: SMOKY HAZE TEMP: 26C FEELS: 26C …

Clock

StyleBig digits, or text in normal, bold, italic or wide.
SecondsAdds :SS — in small digits on one display, full size on two or more.
12-hour6:15 instead of 18:15. Also used by the world clock.
AM / PM markerTwo dots beside big digits (top = AM, bottom = PM), letters in text styles. Switch off for just the time.
Time zoneUnder Clock; the clock sets itself from the internet.

Date

Format12 formats, each previewed with today's date — TUE 17 NOV 2026, 17/11/26…
DisplayMarquee scrolls; Static stands still and centred. Static is offered only when the format fits the display — the short formats fit one module.
FontAs for every panel.
VibeClock · Official User Guide v1.0§04 Clock, date & weather
hjLabs.in
VibeClock · Official User Guide · v1.0

05 · Claude & Codex usage

Your AI limits, always in sight

Link your account once. The clock then checks your usage every few minutes, by itself, and shows how much is left.

Claude usage panel 1 2 3 4 5
  1. 1Updated line — show when the reading was taken: time ago, time & date, or both.
  2. 2Session (5 hours) — percentage used and when it resets.
  3. 3Weekly — percentage used and days until reset.
  4. 4Unlink — the clock forgets its sign-in. Link again any time.
  5. 5Look on the matrix — four looks, each with a live preview; shared with Codex.

Figure 05.1 — Claude usage panel, opened, on a linked clock.

Linking Claude

  1. 1  Open Claude usage. Under Link your Claude account press Open sign-in.
  2. 2  claude.ai opens in a new tab: sign in, approve, and copy the code it shows.
  3. 3  Paste the code into the box and press Link.
  4. 4  Done: the first reading appears within a minute.

Linking Codex (ChatGPT plan)

Open Codex usage and press Get code. The clock shows a short code; type it on the OpenAI page it links to. No copy-paste back: the clock links by itself once you approve.

The four looks

Full scrollCLAUDE SESSION 8% WEEK 9% as a marquee.
CompactS:8% W:9% scrolling.
AlternateS, then W, standing still; side by side on 2+ displays.
Progress barsSmall numbers over an animated bar — the default.
It refreshes itself. When Claude's access token expires the clock renews it on its own; the card briefly says TOKEN EXPIRED – REFRESHING. Claude may slow checks down if it rate-limits; the clock waits and retries.
VibeClock · Official User Guide v1.0§05 Claude & Codex
hjLabs.in
VibeClock · Official User Guide · v1.0

06 · News

Headlines from the sources you trust

News panel settings 1 2 3 4 5 6 7 8 9 10 11

Figure 06.1 — News panel, opened.

  1. 1Sources — tick as many as you like; the dots show which sections each offers.
  2. 2Sections — top, world, nation, business, tech, science, health, sports, showbiz, politics, gaming, AI & ML.
  3. 3Headlines kept per section.
  4. 4Refresh every — minutes between checks.
  5. 5How long it stays — its seconds, or a number of headlines (e.g. top 5).
  6. 6Headlines per pass of the marquee.
  7. 7Font for this panel.
  8. 8On the matrix — section tag, BREAKING flag, publisher name.
  9. 9Only real news — skips how-tos, listicles, quizzes, horoscopes, deals and promos.
  10. 10Muted words — any headline containing one is dropped.
  11. 11Headlines now on the clock, with Fetch now.

Publishers

WorldBBC, NPR, CBC, Al Jazeera, DW, NBC News, NY Post, CNBC, CNA
IndiaTimes of India, Economic Times, India Today, Hindustan Times, News18, Mint
Tech & AIHacker News, TechXplore, MIT Technology Review
ScienceScienceDaily, Phys.org
GamingIGN, Polygon
Your ownAny RSS feed URL (Custom RSS)
Whole headlines only. A headline is never cut with “…”, and the panel finishes the line on screen before the next panel comes in. Very long headlines (over 180 characters) are skipped.
Some sites cannot be used. A few large publishers send pages too heavy for the clock's chip; they are left out on purpose. A custom feed that fails shows FEED TOO BIG or CONNECT FAILED.
VibeClock · Official User Guide v1.0§06 News
hjLabs.in
VibeClock · Official User Guide · v1.0

07 · Sports

Live scores, with sound

Sports panel settings 1 2 3 4 5 6 7

Figure 07.1 — Sports panel, opened.

  1. 1Feeds — cricket (internationals or all matches), Premier League, La Liga, ISL, NBA, NFL.
  2. 2Show — live matches only, or also the next 12 hours and recent results.
  3. 3Update every — 60 seconds at the fastest.
  4. 4Sounds for match events — see the table below.
  5. 5Tournament name before each match: ASIA CUP: IND V PAK …
  6. 6My team — its abbreviation (IND, AUS, MCI); its wins and losses get their own tunes.
  7. 7Matches — what the clock currently cycles through, with Refresh.

What you hear

EventSound
WicketThree quick pips, and WICKET! flashes
Goal / touchdownA siren, and GOAL! flashes
Match goes liveA ping, and LIVE NOW
Your team winsA fanfare, and WE WON!
Your team losesA low “nope”, and WE LOST
Other resultsA ding, and RESULT
Quiet hours? Sounds follow Settings → Sound: mute tones there and the sports sounds stay silent too.
Fours and sixes are not announced. The free score feed updates once a minute, so a jump of 4 or 6 runs could be several shots — the clock does not guess.
VibeClock · Official User Guide v1.0§07 Sports
hjLabs.in
VibeClock · Official User Guide · v1.0

08 · Settings

Everything that is not a panel

Open with the gear icon in the top bar. Each row opens with its arrow.

Settings dialog 1 2 3 4 5 6 7 8
  1. 1Look & timing — brightness, scroll speed, invert, full-height text, screen-saver wait.
  2. 2Sound — beeps, tones, buzzer type, test buttons.
  3. 3Displays — how many modules, their order, the panel-change animation.
  4. 4WiFi — change or forget the network.
  5. 5Install as an app — download the Android app (all three versions), or add this page to your home screen.
  6. 6Firmware update — install a file, or let the clock update itself.
  7. 7Admin password — change it here.
  8. 8System — firmware version, uptime, free memory, last restart.

Figure 08.1 — Settings dialog.

Look and timing 1 2 3 4 5
  1. 1Brightness — 0 to 15; previews live.
  2. 2Text scroll speed — the default for every panel.
  3. 3Invert the display — lit background, dark text.
  4. 4Use all 8 rows — taller text; off = classic 7-row font.
  5. 5Screen-saver wait — games mode: seconds before panels return.

Figure 08.2 — Look & timing, opened.

Firmware updates

Under Firmware update, choose what happens when a newer version is published: Do nothing, Tell me here, or Install it automatically. Check now looks straight away. Settings are kept. While updating, the matrix shows a progress bar and ends with an animated tick.

Admin password. Type the current password, then the new one twice (4–31 characters, no spaces). The password is also the key for scripts and AI agents, so update those too. Forgot it? §11.
VibeClock · Official User Guide v1.0§08 Settings
hjLabs.in
VibeClock · Official User Guide · v1.0

09 · Phone app & network

Reach your clock without typing an address

App clock list

Figure 09.1 — The app finds every clock on your WiFi: name first, address and firmware below.

Admin page inside the app

Figure 09.2 — One tap opens the clock's admin page inside the app.

The VibeClock app (Android)

Get itFree: scan the code for your phone below, or open hjlabs.in/vibeclock. Android may ask once to allow installs from your browser.
Finds clocksBy itself, every few seconds, three ways at once. No address to remember.
Add by addressThe link icon: type an IP or .local name; kept only if a clock answers.
New clockSet up a new clock walks you through the hotspot steps of §01.
iPhoneComing soon. Meanwhile use Safari with the clock's address.
QR code: arm64 APKAndroid — most phones
every phone from the last 6 years
…/vibeclock-app-1.0.0-arm64.apk
QR code: armv7 APKOlder phones (32-bit)
if the first one will not install
…/vibeclock-app-1.0.0-armv7.apk
QR code: x86_64 APKEmulators & Chromebooks
x86 Android devices
…/vibeclock-app-1.0.0-x86_64.apk
Network dialog 1 2 3
  1. 1Network details — WiFi name, signal, IP address, name, MAC, hotspot state.
  2. 2Change network — join another WiFi.
  3. 3Device name — rename the clock and its .local address.

Figure 09.3 — The Network dialog (WiFi icon in the top bar).

Moving to a new WiFi

  1. 1  While the clock is still online: Network → Change network, pick the new WiFi.
  2. 2  If the old WiFi is already gone, the clock raises its VibeClock hotspot by itself — join it and enter the new network.
  3. 3  The app finds the clock again on the new network.
Several clocks? Each has its own two-word name, shown in the app and on the Network info panel. Rename them under Device name (e.g. vibeclock-office).
VibeClock · Official User Guide v1.0§09 Phone app & network
hjLabs.in
VibeClock · Official User Guide · v1.0

10 · Text API, agents & arcade

Let scripts and AI agents use your desk

Anything on your network that can open a web address can put text, a progress bar or a sound on the clock. Open the </> icon for live examples with your clock's address.

Text API dialog

Figure 10.1 — Text API dialog: pick scroll, static or bar, type a message, copy the ready command.

Three ways to show something

ScrollA message scrolls through once, then the panels carry on.
StaticA short value stands still, centred — a build number, a temperature.
BarA label over a 0–100% progress bar — a download, a training run.
curl "http://vibeclock-office.local/api/text?key=PASSWORD&msg=BUILD+PASSED"
curl "http://vibeclock-office.local/api/text?key=PASSWORD&msg=TRAINING&type=bar&value=42"
curl "http://vibeclock-office.local/api/beep?key=PASSWORD&tune=win"
For AI agents. The clock serves a ready-made skill file at /skill.md describing every command and setting. Point Claude Code or another agent at it and the agent can message you, show progress and change settings.
Sounds. /api/beep plays 1–5 beeps, a named tune (win, alert, coin, siren, ding…) or your own melody.
Arcade dialog

Figure 10.2 — Arcade dialog: scores, the game menu, win screen and analytics.

The arcade

Three one-button games live on the clock: Dino Run, Flappy and 11.11, a reaction test where you stop the timer at exactly 11.11 seconds. Press the clock's button to play; the panels return after the screen-saver wait. Switch games on or off, pick a win effect and message, and see scores and play statistics in the arcade dialog.

Kiosk only? Turn games off in the arcade dialog and the clock only ever shows panels — ideal for shops and offices.
VibeClock · Official User Guide v1.0§10 Text API, agents & arcade
hjLabs.in
VibeClock · Official User Guide · v1.0

11 · Troubleshooting

When something is wrong

SymptomLikely cause and fix
Forgot the admin passwordRestart the clock four times in a row: unplug it, plug it back in, and unplug again within 15 seconds — four times. The matrix scrolls ADMIN PASSWORD RESET TO admin123. Sign in with admin123 and set a new one.
Claude usage is oldOpen Claude usage and press Refresh. If it says LOGIN EXPIRED – RELINK, link it again with Open sign-in. If it says network checks paused, the clock is short of memory: turn off panels you do not use (sports downloads are the largest).
News says FETCHING… for longThe first headlines can take a minute with many sources ticked. If it stays, press Fetch now; a source that keeps failing shows its error in the card.
Weather shows N/ANo place set, or not pinned: type your city or PIN code and tap a result so it says PINNED.
Wrong timeSet the time zone under Clock. The clock needs internet once to learn the time.
A panel never appearsCheck its switch is on. Panels play in list order; long marquees make a full cycle longer.
Text reads backwards / displays out of orderWith several modules: Settings → Displays → Reverse display order, then Test.
Can't open the admin pagePhone and clock must be on the same WiFi. Use the app, or the IP from the Network info panel. Guest networks often block devices from seeing each other.
The matrix says LOCKEDThe clock is not activated. Send hjLabs the device id it shows; enter the code you receive on the admin page.
Flickers or resetsUse a 5 V adapter of at least 1 A and the supplied cable; avoid a laptop's USB port on battery saving.
Stuck after an updateUnplug for 10 seconds and plug back in. Settings are kept across updates.

Support

Visit hjlabs.in/vibeclock for the latest guide, the phone app and firmware. When you contact us, include the clock's name (from the Network dialog) and the firmware version from Settings → System.

QR code to the online guide
This guide online
hjlabs.in/vibeclock/guide
Care. Wipe the front with a dry, soft cloth. Keep the clock away from water and direct sun, and out of reach of small children. At end of life, dispose of it as electronic waste, not with household rubbish.
VibeClock · Official User Guide v1.0§11 Troubleshooting