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 or Windows PC

Linux: 64-bit (x86_64) Debian 12 or 13, or Ubuntu 22.04 or 24.04. Windows: 64-bit Windows 10 or 11.

1. Create the device in the panel as in option B.
2. Download the agent from Downloads: the .deb package (Linux) or the .exe installer (Windows).
3. Install it:
   • Linux: sudo apt install ./rds-agent_<version>_amd64.deb, then sudo systemctl start rds-agent (or restart the machine).
   • Windows: run the installer and restart the PC when it finishes.
4. The screen shows Link this screen with a QR code: scan it with your phone to link it. See Pair by QR.

Full details in Linux agent → Installation and Windows 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 → Device panel → Content → 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