Quickstart

Three paths, depending on how you got your device.

A — Device bought from Promotienda

If you bought the device through Devices → Buy device, it arrives plug & play: the playlist and (optionally) WiFi are already loaded.

1. Unbox the device.
2. Connect it to a display (HDMI) and to power.
3. Get it online:
   • If you ordered preconfigured WiFi, it connects on its own.
   • Otherwise, plug in an Ethernet cable or open the admin menu to configure WiFi.
4. Done. The agent boots, identifies itself on the server with its RDSXXXX ID and starts downloading your playlist. The first download may take several minutes depending on the size.

In the meantime go to the web panel, open Devices and you'll see the status icon move from "Download not started" → "Downloading" → "Playing".

B — Your own Android device

Supports Android 5.0 (Lollipop) or higher.

1. Create a device in the panel: Devices → Add. If your plan has free slots it's created at no cost; otherwise you'll be asked to extend the plan. Write down the RDSXXXX code assigned to it.
2. Download and install the APK (promotienda.rds.apk). More details here.
3. Open the app. Tap 4 times on the background to bring up settings and log in as Admin.
4. In Server URL enter the server URL (https://rds.digitalsignagerds.com) and the Device ID (RDSXXXX).
5. Exit settings — the agent authenticates, downloads playlist.txt, the files referenced and starts playing.

C — Your own Linux box (PromoBrowser)

Supports Debian 12+, Ubuntu 22.04+ — with or without a desktop.

1. Create the device in the panel as in option B.
2. SSH into the Linux machine and run as root:

   curl -fsSL https://rds.digitalsignagerds.com/install.sh | bash

3. Start the service:

   systemctl start kiosk-browser
   chvt 7

4. The first time, the browser opens blank. Tap the top-left corner 5 times (or type 12345) to open Settings → Server tab, enter the Server URL and Device ID, and click Test Connection.

Full detail in Linux agent → Installation.

Your first playlist

Regardless of which path you took, you now need content.

1. Upload your videos: Videos → Upload video. Supported format: MP4 (H.264). After uploading, you must verify it yourself on a test device (Videos → row → Verify → pick a screen → physically check it → Validate). Until verified you can't add it to a production playlist. Detail.
2. Upload images optionally: Images → Upload image. JPG / PNG.
3. Create the playlist: Playlists → New. Give it a name and drag the videos/images you want from the left panel. Reorder by dragging rows. For images, set the time in seconds.
4. Assign the playlist to the device: Devices → device row → "Actions" menu → Edit kiosk → Playlist mode → pick your playlist → Save.

On the next heartbeat (≤1 min) the agent will pick up the new assignment and start downloading. Once the download is complete it will start playing.

Verification