Lightberry Guide

What is Lightberry

Lightberry is plug-and-play, easy to use RGB LED kit for Raspberry Pi. Everything you need is in the box (except for Rpi), ready to set up without soldering. Lightberry can be used in number of ways, but primarily it is used behind TV to produce ambient light, adjusting to what is displayed on TV.

Lightberry works with every video you play from Raspberry Pi (i.e. MKV files, video streams like youtube).

Lightberry can be also used with external HDMI source (blu ray player, game console, etc.) – in such setup it requires additional component – HDMI Converter, which is sold separately.

Upon arrival, our Lightberry system has to be assembled and configured. But! Do not fear, as we‘ve done all the hard work for you for a hassle-free first experience!

For the OS configuration, we provide you with a smart Plugin that takes you through a simple question based procedure so that everything is configured easily with just your remote control and the required HDMI cable!

Furthermore, we have at your disposal step-by-step installation guides to unleash your inner wiz-kid and get everything up and running in no time!

The Lightberry team has been in the high-tech business for quite a long time. Having already thousands of satisfied customers under our belt, you can rest assured that we’ll provide you with all the answers you need and of course, with state-of-the-art entertainment.

Plus, if you run in any trouble, we’ve already done all the troubleshooting for you!

Simply pay a visit to our blog for detailed tutorial & installation instructions, troubleshooting, configuration and customization for your convenience!

Raspberry Pi requirements

Lightberry primarily works with Raspberry Pi. You can buy it at many places (including Amazon) – regular Raspberry Pi kit consists of:
  • Raspberry pi 3
  • Raspberry pi case
  • Raspberry pi power supply
  • HDMI cable
  • Micro SD card

What's in the box?

High quality led strip – APA102 – 30 LEDS/m
Led converter – interface box to connect leds to Raspberry Pi and USB Cable
Power supply (EU/UK/US/AU plug, depending on ship-to country)
Plastic hooks with double-sided self-adhesive tape
Rubber stoppers (to keep the strip in place on hook)

Which Lightberry is right for me?

There are two lengths of Lightberry HD

  • 4m version fits TVs up to 55inch
  • 5m version fits TVs up to 70inch

And four lengths of Lightberry

  • 48LED version fits TVs up to 47inch
  • 52LED version fits TVs up to 55inch
  • 56LED version fits TVs up to 60inch
  • 64LED version fits TVs up to 70inch
I have
There is no TV in this size.
TV -

Frequently Asked Question

Can I buy longer set for smaller Tv?

5m version will also work on smaller TVs – simply some leds will remain unused, so if you plan to buy bigger TV in the future, 5m will be smart choice.


Frequently Asked Question

What's difference between Lightberry HD and Lightberry?

Lightberry uses 12LEDs/m bubbly type, Lightberry HD uses 30LEDs/m LED stripe. Generaly Lightberry is better when wall is more than 15cm from the TV.


Do I need a kit? Which one?

Now with Lightberry 4K kit, you can have your amazing 4k resolution movies and games, accompanied by an awesome LED lightshow that is in full sync with the colors of your movies and games thus providing you with the complete immersive experience that a 4K TV should stand for!

The Lightberry recognizes the color value and intensity of what’s been projected on your TV screen, and recreates them in value and intensity allowing you to fully experience any movie you’re watching and game you’re playing!

Lightberry kit is required to use Lightberry with external sources.

Software setup

The simplest way to set up software for Lightberry is to buy SD card from us. If you did that, just skip the rest of this section.

  1. Go to Download section and download the system image which is marked as [RECOMMENDED] and unzip it to your hard drive
  2. Go to and download Win32DiskImager.
  3. Install and run software from step 2. Window as shown below should appear (please note that you will have labels in different language :) )
  4. Select drive corresponding to your SD card
  5. Click folder icon and select the file you unzipped in step 1
  6. Click "Write"
  7. When writing to SD card finish, close the window and safely remove SD card safely from the system
  8. Finally, put SD card into Raspberry



Before the led strip is mounted on TV or in other place, it is recommended to connect all parts together and see if everything seems to be working fine. We test every single kit before it is shipped, but it happens that hardware gets broken during transportation. It will be easier to put everything back to the box if the strip was not mounted on TV yet.



Please connect all parts together with power supply of Raspberry and leds unplugged from wall socket.


Together with Lightberry you should have receive connection schema for all elements, but even without it, connecting all parts together is very easy. We design all elements in a way that there is only one possibility to connect, i.e. you wont be able to put a plug in a place where it doesn’t belong.

Starting up for the first time

Once Lightberry components are connected, connect PSU cable into AC wall socket

Power on Raspberry Pi

Shortly after powering on, startup sequence of the leds should be displayed – all leds should turn red, then green and blue (each color for about half a second). If that works, move on to the next step. If not, contact us.

Lightberry configuration plugin

The software, which drives Lightberry is Hyperion. It has dedicated HyperCon tool to configure it, but most of the users do not require such level of details, thus we provide Kodi plugin to configure Lightberry in the easiest way possible.

Once Raspberry is started, KODI menu should apear on the TV screen (make sure you have right HDMI input selected on TV to the one where raspberry is connected to).

Use your TV remote (make sure you swich it to CEC mode (aka Anynet+ (Samsung); Aquos Link (Sharp); BRAVIA Link and BRAVIA Sync (Sony); Kuro Link (Pioneer); CE-Link and Regza Link (Toshiba); SimpLink (LG); VIERA Link (Panasonic); EasyLink (Philips))) and navigate to „Programs” section

When list of plugins shows up, select „Hyperion Config Plugin” and start it by pushing ok/enter on the remote.

Configuration wizard will start and guide you through the setup. Few important sections are described later in this document.

In first step you will be asked to provide type of Lightberry you have. You can check the type of your Lightberry on the order receipt which you received over email after purchasing Lightberry (most likely you purchased Lightberry HD USB (APA102)). Select right type and move to the next steps.

In the next steps you provide number of leds you have in horizontal and vertical direction (count only one edge per direction). If you configure for test (before mounting on tv), put 35 for horizontal and 35 for vertical direction. It will be enough to light up the whole strip. Once done, continue to the next step.

You will be prompted if you’d like to download recommended settings for the type of leds you selected. By default, the config plugin should have best settings for APA102.

If you select yes, then the settings will be downloaded and any settings you could have made via plugin settings, will be overwritten. Settings include things like color balance, smoothing and a few other parameters.


Your pi must be connected to the internet if you want to download the defaults.


Next, you can select direction of how the leds are mounted on TV (when standing in front of tv). Recommended way is „Right/bottom corner and goes up”. For testing, it is safe to select the recommended option.

Last step worth to mention here is grabber detection. If you want to use Lightberry with external video source ( i.e. via HDMI Kit), the plugin should report that grabber has been found and it will ask you whether appropriate section should be added to the config file. Select „yes” in such case.

Screenshot shows the message when grabber was NOT connected, thus not detected. If that’s expected, continue by clicking ok – if not, contact us.

Now Hyperion will be restarted and rainbow swirl effect should appear on the leds strip. If that happens, confirm you saw it and continue to the „calibration image”. For 10 seconds, 4 color rectangles will show iup on the screen. You can check if your leds are properly aligned. If everything was fine, select „yes” to have config saved as default one.

Mounting the strip


If you’re mounting the strip on TV, we strongly advice to take of the TV from the wall or TV stand and place it screen downwards on soft and flat Surface and then proceed with next steps. Mounting the strip/hooks on TV attached to the wall or on TV stand may cause injury and/or damage of your TV and potentially other unpleasant side-effects which one should avoid at all cost.


We recommend that you use 2 hooks on each corner – one for vertical part of the strip, the other one for horizontal.

Once you know the place where the strip will be bended (do not bend it on sharp edges!), use the rubber block to keep the strip in place (no need to peel of silicone paper from the led strip).

Repeat the same steps for all corners. Use remaining hooks to support the strip, especially on horizontal edges. Make sure that the hook’s top does not interfere with the light from the led (place the hook between the leds)

When mounting, make sure that the strip is not too tense – tension may cause the hooks to fall off

Final effect

Contact us