Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


You will need to install Qt development packages.

For Qt5, on the Raspberry Pi,run:

sudo apt-get update
sudo apt-get install qtbase5-dev qt5-default

and then, in the rpiclock source directory:


For Qt4, on the Raspberry Pi, run:

sudo apt-get update
sudo apt-get install qt4-dev-tools

and then, in the rpiclock source directory:


You need ntpd running and synchronised, unless you disable checking of the time. Make sure that /etc/ntp.conf allows ntp queries via the local interface:

restrict ::1

Setting up a Raspberry Pi

If X is not started automatically (eg Debian 7 systems) you will need to do the following.

Assuming the user pi is running rpiclock:

/etc/inittab needs the line

1:2345:respawn:/sbin/getty --noclear 38400 tty

changed to

1:2345:respawn:/bin/login -f pi tty1 </dev/tty1 >/dev/tty1 2>&1

so that pi is automatically logged in on tty1

/etc/rc.local needs the line

su -l pi -c startx

to automatically start X-windows

In pi's home directory you need the file


which contains

[Desktop Entry]

to automatically run rpiclock. You may need to create the autostart directory.

Startup on system boot is a bit slow. The kernel will not declare "synchronised" until about 15 minutes after boot so the time will not be displayed during this period. This is a bit pernickety but I have an aversion to displaying the wrong time.

Power management

The tvservice tool is used on the Raspberry Pi. This has worked fine for me on an LCD monitor. The display and the backlight go off.

On other Linuxen+x386, YMMV. I tried dpms and vbetool but there were problems. With xset, the backlight would go off briefly and then come back on. With vbetool, there were occasional freezes of up to 30s before the monitor turned off. Unfortunately there is no standard way of controlling the monitor in Linux so power management may not work for you.

On Debian systems, vbetool needs to run via sudo so to disable the password for just vbetool you need to edit /etc/sudoers:

user_name ALL=(ALL) NOPASSWD: /usr/sbin/vbetool

Configuration file

rpiclock uses a configuration file rpiclock.xml. The comments in the sample file should be enough to get you going. The search path for this is ./:~/rpiclock:~/.rpiclock:/usr/local/etc:/etc All other paths are explicit.

Known bugs/quirks

The power on/power off logic assumes on < off.


There's a bit more information and screenshots at


A clock display program for the Raspberry Pi




No packages published
You can’t perform that action at this time.