Starting the App

Run the Web application with the following command.

sudo java -jar pixel.jar

In the above command, 'pixel.jar' should be replaced with the actual name of the JAR file copied to the Raspberry Pi.

There are some command line switches to configure the application.  See below for details.

Once the Java application is running from the command line, a bunch of lines scroll on the terminal showing connection messages.  If it is the first run, then image resource extraction messages are also shown.

Next, visit the following URL.


The 'raspberrypi' in the above URL should be replaced with the host name (or IP address) of computer running the Pixel Web applicaton.

At the above URL, a user interface is presented with a drop down menu to change between Pixel modes.

Scrolling Text

The scrolling text mode lets you enter some text, change scroll speed, and specify text color.

Displaying Stills and Animations

Still image mode presents the various images available for drawing on the Pixel.

Animations mode similarly presents the various animations available.

On the user interface for still and animated images, a 'Display' button is used to select what is shown on the Pixel's RGB LED matrix.

Uploads for User Supplied Animated GIFs and Still Images

The user can upload their own still images and animated GIFs.  The file chooser button is used to select a still or animated GIF, on the filesystem.  Then click the upload button and it should appear in the corrosponding animated or still image list.

Save Animations to SD Card

In offline mode, an animation can be played from the SD card onboard the PIXEL.  This means you can still have an animation play even if the Web enabled application is not running.

Use the 'Save' button to write an animation to the SD card for offline use.

Clock Mode

Clock mode presents an analog clock.

Command Line Switches

The applicaton has these command line swithces:


show help.


Sets the LED matrix type. Default = 3

0=32x16 Seeed

1=32x16 Adafruit,

2=32x32 Seeed


4=64x32 Seeed,

5=32x64 Seeed,

6=Seeed 2 Mirrored

7=Seeed 4 Mirrored (does not work),

8=128x32 Seeed,

9=32x128 Seeed 

10=SUPER PIXEL 64x64,

11=32x32 Adafruit,

12=32x32 Adafruit Color Swap

13=64x32 Adafruit,

14=64x64 Adafruit,

15=128x32 Adafruit

16=32x128 Adafruit,

17=64x16 Adafruit


The official list of supported LED panels is here:


Sets the LED matrix type, same as l option


Listening port. Default Port = 8080

This guide was first published on Jan 03, 2015. It was last updated on Jan 03, 2015.

This page (Usage) was last updated on Dec 10, 2014.

Text editor powered by tinymce.