Linutop TV Documentation

Linutop TV is an online Digital Signage Service available on the internet or in local private server.

More info on

Linutop Documentation Index

Table of Contents
1. User interface layout linutop TV
2. Library
Add Medias to the Library
Edit a template
Visual Mode
HTML Mode (for advanced users)
Creating templates
View and save your template
3. Playlist
Set up a playlist
Add and Organize medias in your Playlist
View the playlist or an item in a browser
Modify your Playlist
Loop execution order
4. Broadcast your Playlist
Configure your broadcast
Monitoring the broadcast via the player status
Broadcast via the online player
5. Connect your Player to your Linutop TV account
Player connexion to Linutop TV online
Player connexion to Linutop TV private server
Other method
Private playlist server
6. Local installation of your Linutop TV private server
Choose server location
Network Configuration
Installing the private server in linutop OS
Installation of your Linutop TV private server on a VM (Virtual Machine)
Offline Internet installation (maximum security)

Chapter 1. User interface layout linutop TV

Display your medias on your screens in 3 steps:

This tutorial will help you configure your own Playlist.

Chapter 2. Library

The Library is an online space where you can upload and stock your files (pictures, videos, musics, urls and templates). Upload your files in your Library by clicking on the "Add" button (located at the top of the Library).

Add Medias to the Library

Add a picture or a movie: Upload it from your computer.

Add an Internet website or video stream: Type the website that you would like to display.

Add a HTML page: Select a template, edit and name it.

Once the fields have been filled, click on "Submit" to upload data to your Library.

Note: The upload can take a few minutes depending of the size of your files.

The Library "Total Size" is limited to 1Gb (listed on the top of the Library panel).

To modify a template, click on the reading glass just opposite to the file. To remove a file from the Library, click on the cross just opposite to the file.

Linutop TV formats:

  • Videos (.avi, .mov, .mpg, .wma, .mp4, .flv)
  • Pictures (.png, .jpeg, .gif)
  • Audio (.mp3, .wav, .ogg, .flac)
  • URLs (http://, https://, ftp://, rtsp://)
  • HTML templates

Note: Multiple files can be ubloded at once as a .zip

Edit a template

A template is a html page which can be edited. You can place a picture or a text. Linutop TV offers some pre-edited models.

To add a Template, click on one of the pre-edited templates, then "Submit"

You are now able to configure the template according to two different methods.

Note: Templates allows you to keep an HTML page on the screen even in case of network failure. Unlike a url, which is reloaded each time.

Visual Mode

This mode let you display and edit your template

The bottom area let you edit the text with regular text edit interface.

HTML Mode (for advanced users)

Click on the button. The HTML code of your template is now accessible. The edition of the code results in the automatic update of the preview.

Creating templates

There are several ways to create a template. Either by starting from a template or by creating your template (HTML page) and then putting it online as a .html document (thanks to the "add" button in the library menu)

Example of template structure:

      .text {text-align: center;  font-size: 6em; }
      img   { max-width: 50%;  max-height: 500px; }
    <div class='text'> <img src="" 
alt="image"> <br/> Hello! </div>

This mode allows to create a local HTML page with, possibly animations in javascript

To be able to edit the template without going through the HTML code, just add these tags:

For the text boxes (a place in the <div class='text'> so as not to alter the HTML edit mode)

<div class="editable-block">
  <div class="content"> </div>
  <div class="editor">
    <textarea name="editable" id="" cols="30" rows="10" class="editable" style="display: 
None;"> </textarea>

For images

<img src="" alt="image" 

Note: These two pieces of code let you edit the template using the visual mode.

View and save your template

You can preview your template by clicking the button then the button to return to editing your template.

Once your modifications are done, you can save them by clicking (do not forget to name your template, or it will not be possible to save it).

Chapter 3. Playlist

A Playlist is a list of different medias, which are present in your Library.

Set up a playlist

  • Click on the drop-down list "Playlist / Create a Playlist"
  • Name it (only alphanumeric characters)
  • Your Playlist will appear in the drop-down menu

Add and Organize medias in your Playlist

Drag a media from your Library and drop it on the loop of your Playlist or an item in the loop to add it, or use the green arrows to move the elements (touchscreens).


  • The Display time with the hh / mm / ss format for each media
  • The Display order (using drag and drop)

Delete a file from your Playlist by clicking on the red cross associated with the file (at the end of its line). It will be the same process to delete a Playlist or a loop.


The loops are used to organize the Playlist. They allow for example to:

  • Start to display a Playlist at a specified time
  • Choose to display your Playlist only the monday
  • Stop to display the Playlist and shut down the screen
  • ...

Add a loop by clicking on the "New loop" button.

  • From/To: Enter the loop starting and ending dates. If none, the loop will always be displayed.
  • Time/Duration: Enter the loop starting time (HH:MM format) and duration (HH:MM format).
  • Repeat: The Playlist will be displayed only on selected days.
  • Shuffle : Click this button to shuffle the loop. By default it will be played in the order and when you click on the button, the reading will be done in random order.
  • OFF : Click on the button to turn off the player's screen. When extinction is activated the loop bar is dimmed.

View the playlist or an item in a browser

To see a playlist in, you must first associate it with a string (in "option - player state") then click on the links that appear next to the playlist name

Note: You can view only the comptenu of the loop 0 in the browser.

You can also view each item individually by clicking its icon, from the library or playlist being edited

Modify your Playlist

The Playlists are saved automatically after each change. The result will not be displayed immediatly on your screens

The displayed Playlist is updated every 30 minutes by default. This can be changed in the Linutop Kiosk configuration.

In addition, it is possible to insert an element belonging to a different loop , setting the time of broadcast.

Note: Between each element, the player checks if another loop should be displayed.

If you need or want to see your modifications sooner:

  • Validate your modifications on Linutop TV
  • Restart the Linutop Kiosk on your Linutop Player

To delete a Playlist, select it and click on the red cross on the right side of the "new loop" button.

Loop execution order

The player executes loop 0 by default if no other time condition in the other loops is valid.

In addition, it is possible to insert an element belonging to a different loop by setting its broadcast time. But for this, it is necessary that the loop to insert is priority. The loop with the lowest number is the loop with the highest priority

Note: The test selection of the next element is performed between each element.

Chapter 4. Broadcast your Playlist

Configure your broadcast

Once the playlist has been edited (files order, display time, loop, etc.), click on "Settings". A menu will allow you to associate a Player (screen) with a Playlist (created online).

  • The "Password" tab allows you to change the password of your Linutop TV account.

  • Channels : Linutop Player number (mini PC Linutop linked to the screen and with the Linutop Tv configuration). The Player could be a PC running a Linutop OS as well.
  • Label : Add a description according to its localization, its function, etc. (example : "waiting room", "London offices", ...).
  • Playlist : Choose the Playlist that you would like to Display on this Player. The playlist "Server_OFF" will shut down the Player screen.
  • Last update : Time of playlist's last update. When you hover over this box, date and time are displayed entirely.
  • Public : By checking this box, the selected playlist becomes public and is visible to all.
  • Preview : By clicking on the blue play button, you can preview your playlist.
  • Player status : This column display player status :

Monitoring the broadcast via the player status

In the menu "Settings - Player Status" (part 3 in Chapter 1), It is possible to watch players status. Several states may appear. They are listed below with their sinifications.

  • If information is "Ok" : Your player has been updated in the last 30 minutes.
  • If information is "Updating..." : Your playlist has been modified but the reader is processing the update.
  • If information is "Delayed" : Your player is outdated for at least 30 minutes (or disconnected from the network).

Note: If the player is "Delayed", it may just be disconnected from the network. It will continue to display the playlist as it was downloaded locally.

Broadcast via the online player

To make a channel public, just check the box opposite its name (in the public column). It is also necessary that his name be unique, that there are no other public chains of the same name.

You can also view all channels from this interface.

Once the channel is made public, you can access it from the url "" (page opposite). This page lists all your public channels.

This feature is also available for private servers, for use on the local network

Note: Restricting the player Online: The online player only broadcasts the loop 0, and the media are compatible images, URLs, templates, MP4 videos. The rest depends on the browser to use.

Chapter 5. Connect your Player to your Linutop TV account

Player connexion to Linutop TV online

To access your playlist, you must now configure the Kiosk. Go to the Linutop Kiosk Setup menu : "Linutop" - "Linutop Kiosk - Setup".

The Kiosk Configuration window opens. Click on "Linutop TV Server" and enter your id (invoice number and email address) and then sign in using the "Connect" button.

Player connexion to Linutop TV private server

If you use a private server you need to select Linutop TV server and to check Private then enter the url or ip address of your server. once done you need to use your login and password to access the playlist (by default admin/linutop). Then choose the playlist you want to diplay and hit the OK button.

To quit the kiosk application hit Esc. If a password is set, use Ctrl+q and enter your password instead.

Other method

On your player, start "Linutop" - "Configuration Panel".

On the "Install" tab, type your invoice number and email adress. Validate with the "Login" button.

A list of available configurations will appear in the frame bellow. Select the Linutop TV configuration in the list. Validate with the "Apply" button.

A message will confirm that the configuration has been applied. Leave the Configuration panel by clicking on "OK". The Linutop Kiosk software is now configured to display your online Playlist.

To see it, start the Linutop Kiosk : "Linutop" - "Linutop Kiosk - Launcher".

Private playlist server

On the Linutop Player web browser, log in Linutop TV and open the "Settings" window, click on the screen number.

Then you arrive on the page below. Copy the address thereof.

Go to "Linutop" - "Linutop Kiosk - Setup"

Paste the address in the "Private playlist server".

Validate by clicking the "Ok" button.

Go back in the "Linutop" - "Linutop Kiosk - Launcher" menu. Your Playlist will be displayed on your Player.

Chapter 6. Local installation of your Linutop TV private server

For maximum privacy, a Linutop TV Server can be installed on your local network.

Choose server location

The server must be installed in Linutop OS, which can work in different locations:

  • In a virtual machine (VM) detail below
  • On a PC
  • On a Raspberry Pi
  • In a Linutop player. In this case, the Linux kiosk works in parallel with the server on the same machine.

Network Configuration

The server must be configured as a fixed IP, so that the players can connect to the same IP address

Linutop OS can be configured as a fixed IP using the /etc/network/interfaces file.

auto lo
iface eth0 inet static


Example of file configuration: /etc/network/interfaces

The communication between the server and the player is done via the standard http protocol

Note: It is recommeded to use a wired connection for stability

Installing the private server in linutop OS

Go to the Panel Configuration : "Linutop" - "Panel Configuration".

In the "Install" tab, enter your invoice number and address email and confirm by clicking the "Login" button.

A list of available configurations appears in the bottom frame. Select "Linutop TV private server setup installation" in this list. Click "Apply".

A message will confirm the installation. Exit Configuration Panel by clicking the "Ok" button.

Your server Linutop TV is now ready to use.

It is accessible with a web browser on your local network by typing the IP address of your computer, available in the "About" tab of the Configuration Panel

Now you can create your playlists.

Installation of your Linutop TV private server on a VM (Virtual Machine)

Process :

Create 2 storages in your MV, install ISO linutop OS, boot and install full linutop OS on second storage. And then, remove the first storage and reboot on the full OS to install private server

Open VM VirtualBox Manager

Select button New


  • Name and operating system Name : 'Linutop' - Select Linux and Select Ubuntu (32-bits) and press "Next".
  • Hard disk: Select Create a virtual hardisk now and press "Next"
  • Hard disk file type : Select VDI and press "Next"
  • Storage on physical hard disk : Select dynamically allocated and press "Next"
  • File location ans size : Select 1GB or more and press "Create"

Now you Virtual machine is ready to receve the Iso Image

  • Press "Settings" button

  • Press "Storage" button

  • Press the small disk next to Controller IDE

  • Choose disk and select the iso image

Your VM is ready to boot the Iso Image Just press start. You can now test linutop OS demo in your VM

To install the full version just use the install menu and install it on the second device :

Once installed, you can removed the installed demo iso device and boot on the full version and then install your Linutop TV Private Server and proceed like a private local private installation (Chapter 6).

Offline Internet installation (maximum security)

This option is available by installing a DHCP server and an NTP server to support an offline network of players while managing the IP connection and time synchronization (ntp) of the players.

This configuration provides maximum security.