Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here


Keep an eye on your Raspberry Pi with zero configuration

Subscribe to updates I use Currant

Statistics on Currant

Number of watchers on Github 226
Number of open issues 4
Average time to close an issue 6 days
Main language PHP
Average time to merge a PR 2 days
Open pull requests 4+
Closed pull requests 3+
Last commit almost 2 years ago
Repo Created over 3 years ago
Repo Last Updated over 1 year ago
Size 1.99 MB
Homepage http://ColinWadde...
Organization / Authorcolinwaddell
Page Updated
Do you use Currant? Leave a review!
View open issues (4)
View Currant activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating Currant for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

Currant Pi

Keep an eye on your Raspberry Pi with zero configuration [if you've already got a web-server running]

Currant Pi will show you current information about your Raspberry Pi's:

  • Board temperature
  • Network status
  • Uptime
  • CPU Load
  • Memory allocation
  • Available storage

Check out the Live Demo →


Currant Pi is a web interface to keep an eye on your Raspberry Pi and is designed to work straight out the box. To install you need to download the latest release either as a zip file, or by cloning the repo and then making it visible to your webserver.

There's a couple of routes to installing this. Follow the one which fits you best.

Method #1: I've already got a webserver and I'm comfortable using Git

  1. Clone this repo somewhere your webserver can see it, i.e.:

    git clone /var/www/html/currantpi
  2. Cross Fingers.

  3. Point your browser at your webserver.

Method #2: I've already got a webserver and I can easily drop some files into its working directory

  1. Download the latest release
  2. Unzip the repository and move its contents to your web-root, or where ever you'd like this to live (i.e. /var/www/html/)
  3. Visiting Currant by popping the address of your Raspberry Pi into a web-browser (i.e. http://raspberrypi)

Method #3: I have no webserver and need full instructions

In the following instructions you can skip step 1 if you already have a webserver running. Please just swap out /var/www/html in the instructions with where you'd like Currant to live on your server. You can skip step 2 if you've no interest in creating a backup of your current web server's content.

Just copy and paste each section into a terminal on your Rasbberry Pi and hit enter. You may be asked for a password depending on your configuration.

  1. First you'll need to have a webserver up and running on your Pi. The following will install and setup lighttp on your Raspberry Pi. I'm assuming you're running an installation which uses the apt distro system.

    sudo apt-get install lighttpd php5-cgi
    sudo lighttpd-enable-mod fastcgi fastcgi-php
    sudo service lighttpd force-reload
  2. Next create a backup of your webserver's current content

    sudo mv /var/www/html /var/www/html_backup
    sudo mkdir /var/www/html
  3. Install Currant.

    cd /tmp/
    wget -O
    sudo cp -r /tmp/CurrantPi-master/* /var/www/html/
    rm -rf /tmp/CurrantPi-master
  4. Visiting Currant by popping the address of your Raspberry Pi into a web-browser (i.e. http://raspberrypi)

Monitoring a wireless connection

If you'd prefer to get network data back for your wireless connection rather than your ethernet, open up content/network/NetworkData.php and change the property $interface as follows:

public $interface = 'wlan0';


You can get all the information about your Raspberry Pi in the form of a JSON request. This allows CurrantPi to be used to supply data to any external service or your own web application by accessing api.php instead of index.php

If you only want data for a specific module then append it to the request:

Available modules are:

  • footer
  • hardware
  • load_average
  • memory
  • network
  • storage


You can contribute to this project by pushing to your fork and submitting a pull request.

I like to try and comment on pull requests as soon as possible, but sometimes real-life gets in the way. I also may suggest some changes or improvements or alternatives. My apologies in advance if I don't automatically accept your submission.

When contributing to CurrantPi keep in mind that the target audience wants to unpack the repo and have it 'just work'. Second to this I'd like the code to feel accessible enough that anyone interested can play with it. People new to programming shouldn't have to deal with fancy design patterns and abstractions. I'd like to keep the code simple but not stupid, clean and as readable as possible.

Code should be simple enough that any eager beginner can follow it.

If you are keen to see Currant Pi implemented using an MVC framework, please see the SlimMVC branch created by github user sio-iago.


© 2017 Colin Waddell under the terms of the MIT License.

Currant open issues Ask a question     (View All Issues)
  • over 3 years Needs properly proofread
Currant open pull requests (View All Pulls)
  • Add dynamic host name to Header view
  • Remove tmpfs file systems from Storage module
  • Added IP address and subnet mask
  • Handling disk names containing a space
Currant questions on Stackoverflow (View All Questions)
  • how currant time image display with extension in android
Currant list of languages used
More projects by ColinWaddell View all
Other projects in PHP