Everything you need to master Smart-Signage.

Smart-Signage is a SaaS platform. You access it from any modern browser. No installation needed for managers. On the screen side, you install the player suited to your hardware (web, Android APK, Tizen coming soon).

1. 1

   Create your account

   On my.smart-signage.app, create your free account. Your workspace is ready immediately.

2. 2

   Upload your first media

   Image, video, PDF, or web feed. Drag and drop, that's it.

3. 3

   Build a playlist

   Drag media into order, adjust the duration per item, add transitions.

4. 4

   Pair your screen

   Open the player, scan the 6-digit PIN, it's linked to the tenant.

5. 5

   Publish

   Assign the playlist to the screen, broadcasting starts within the minute.

Six entities structure the platform. Understand them once, they're used everywhere.

Tenant

A client. Fully isolates media, playlists, screens, and users. An operator (e.g. Smart-Signage) manages multiple tenants from the admin console.

User & role

Owner, Admin, Editor, Operator, Viewer. Roles determine what you see and what you can change.

Media

Image, video, PDF, URL, or HTML template. Stored on the CDN with auto-detected thumbnail and duration.

Playlist

An ordered sequence of media with duration, transition, rotation, and zoom per item.

Schedule

Assignment of a playlist to a screen, over a time range or a given day. Multiple schedules = dayparting.

Device (screen)

A connected player. Identified by a PIN then a token. Reports heartbeat + screenshot.

Multi-tenant

Each tenant has its own media, playlists, and screens. A user belongs to one or more tenants. Operators (resellers, integrators) access every tenant in their portfolio through the admin console.

Roles

Authentication

Email / password by default, with email reset. Single sign-on (SSO) available in the Premium plan.

Supported formats

Organization

Folders, tags, full-text search. A media file is versioned: replacing the file propagates the new version to every playlist that uses it. No need to reassign.

Studio IA generates an HTML/CSS template from your brief. You edit the visual result, the code stays accessible for technical profiles.

Available variables

<div class="promo">
  <h1>{{ title }}</h1>
  <p>{{ description }}</p>
  <span class="price">{{ price }} 
lt;/span>
  <small>Valid until {{ end_date | date:"MMM d" }}</small>
</div>

Variables are defined per playlist or per broadcast. You can also feed them via the API (Premium plan) — useful for real estate agencies, restaurants, dynamic pricing.

Studio IA limits

• No non-whitelisted external scripts (security).
• Fonts via Google Fonts or tenant upload.
• 2 generations / month on Free, 20 / month on paid plans.

A playlist is an ordered sequence of items. Each item has a duration, a fit mode (cover / contain / fill), a rotation, a zoom, and a transition.

Available transitions

• CUT — hard cut (default, the smoothest).
• FADE — 500ms crossfade.
• SLIDE — 800ms horizontal slide.

Best practices

• Image duration: 6 to 10 s on average. Too short = incomplete read. Too long = fatigue.
• Video: keep the default duration (= file duration).
• Mix 70% stable content + 30% promo / seasonal.

A schedule assigns a playlist to a screen over a time range. Multiple schedules can coexist, ranked by priority.

Time range types

• Hourly — e.g. Monday–Friday 8am-11am: "Croissants" playlist.
• Dated — e.g. Jan 1 to 6: "King Cake" playlist (high priority).
• Permanent — default playlist, played outside any special range.

Priority

When several schedules are active at the same time, the highest priority wins. The seasonal promo overrides the weekly schedule, which overrides the permanent playlist.

Pair a screen

1. 1

   Open the player

   On the screen, launch the Smart-Signage app or open https://player.smart-signage.app.

2. 2

   Note the PIN

   A 6-digit code appears, valid for 10 minutes.

3. 3

   Add the screen

   In Smart-Signage → Screens → Add, enter the PIN and the screen's name.

4. 4

   Assign a playlist

   Select the playlist or schedule. Broadcasting starts.

Screen properties

• Name, location, tenant, tags.
• Detected resolution and orientation (1920×1080, 1080×1920, 4K…).
• Scheduled sleep window (e.g. 10pm-6am).
• Audio volume.

Heartbeat

Each player sends a heartbeat every 30 seconds: version, status, current playlist, position in the playlist, temperature (if available), uptime, OS version, last media played.

Screenshot

On demand or scheduled every 5 minutes. Great for visually confirming a screen is showing what it should. Stored encrypted, expires after 30 days.

Alerts

• Screen offline > 5 min (configurable).
• Storage quota near the limit.
• Broadcast failure (corrupted media, unsupported format).
• Player update available.

Channel: email. Webhooks available with the Premium plan's API.

Available in the Premium plan: a REST API + webhooks to automate things — create a media file, trigger a playlist, receive an event. Access provided on request, Bearer token scoped per tenant.

Example: push a flash promo

curl -X POST https://my.smart-signage.app/api/v1/playlists/flash-promo/activate \
  -H "Authorization: Bearer $SMARTSIGNAGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "maison-dupont",
    "duration": 1800,
    "devices": ["bellecour-storefront", "confluence-wall"]
  }'

Webhooks emitted

• device.offline — screen with no heartbeat > threshold.
• device.online — screen back online.
• playlist.started / playlist.ended.
• media.uploaded.
• billing.threshold — billing tier crossed.

• Hosting — OVHcloud Roubaix & Strasbourg, data stored in France.
• Encryption — TLS 1.3 in transit, AES-256 at rest, instantly revocable screen tokens.
• GDPR — DPA available on request, processing register kept up to date.
• Backups — daily, retained 30 days.
• Audit — log of every admin action, exportable.

The player is the app that runs on the screen. Three variants to cover 95% of existing hardware.

Web Player — installation

1. 1

   Open the URL

   https://player.smart-signage.app — works without an account.

2. 2

   Enable full screen

   F11 or the browser's "Kiosk full screen" option.

3. 3

   Disable sleep mode

   System → Power → Never sleep (display).

4. 4

   Install as PWA

   Optional: address bar icon → Install. The screen reopens the app on reboot.

5. 5

   Pair

   Enter the PIN shown in Smart-Signage.

Android Player — installation

1. 1

   Download the APK

   From Smart-Signage → Screens → Download the Android player (signed).

2. 2

   Allow unknown sources

   Settings → Security → Unknown sources, just for the install.

3. 3

   Install

   Open the APK from the file manager or via ADB.

4. 4

   Kiosk mode

   The app locks the screen onto Smart-Signage at startup. To exit: 6-digit admin code.

5. 5

   Pair

   The PIN shows on screen. Enter it on the Smart-Signage side.

Offline mode

Web and Android players cache the active playlist and its media. If the network drops:

• Broadcasting continues as long as the media is cached.
• The heartbeat is queued and sent once the network is back.
• A discreet banner reports "offline for Xmin" (dashboard only, never on the screen itself).

Updates

Recommended hardware specs