Self-hosted digital signage

Your screens.
Your server.
No subscription.

Narancs Signage is a complete signage system: an admin panel, a player that runs on any ARM or x86 box, and installers for Linux, Windows, macOS and Raspberry Pi. Slideshows, calendars, forms, touch menus — managed from one place, running even when the network is down. Programmed entirely by Claude, Anthropic's AI.

  • 15 content types
  • 0 dependencies
  • 1 command per screen
  • ARM + x86
  • Windows
  • macOS
  • Linux
  • Raspberry Pi
  • Docker
  • Any browser
Narancs Signage Click through the five steps

Install the player

One command on any Ubuntu Server or Raspberry Pi. No desktop, no window manager — just a locked-down Chromium kiosk.

curl -fsSL http://192.168.1.10:8080/install-player.sh | sudo bash

Waiting…

Pairing code482 913

Pair the screen

After the reboot the display shows a 6-digit code. Type it into the admin panel.

Content preview

Live preview, coloured by your branding. 15 types in total.

Schedule the day

Different playlists by time, weekday and date range. Drag the needle.

off
Breakfast menu
Lunch specials
Events & calendar
screen off
0610141822

Welcome to the lobby · Today 14:00 team meeting in room 2 · Lunch: goulash soup · Wi-Fi: Guest / scan the QR code ·

It plays

Fades, slides, Ken Burns. Cached offline. Remote reload, restart and emergency alerts from the admin.

Everything a screen needs

Fifteen content types, all editable in the browser with a live preview.

Show anything

Pictures, videos and announcements in your own colours, or any web page, PDF or HTML you already have.

  • Image slideshow

    Fade, slide, Ken Burns, captions and a blurred background.

  • Video

    Play to the end or for a set time, with or without sound.

  • Announcement

    Title, text, background image or video, gradients, logo.

  • Website

    Embed a page or dashboard, with zoom and timed reload.

  • PDF

    Show a document.

  • Custom HTML

    Your own HTML/CSS/JS in an isolated frame.

Announcement with the organisation logo

Live information

Content that updates itself: the time and weather, your calendars, news feeds and countdowns.

  • Clock & weather

    Digital or analogue, 5-day forecast, no API key needed.

  • Calendar

    List, week, month; your events plus Google/Outlook iCal, recurring events too.

  • News feed

    Any RSS or Atom source, with images.

  • Countdown

    Time left until an event.

  • QR code

    Built-in generator for links and Wi-Fi login.

Calendar with this week’s events

Let people interact

On a touch screen, visitors find their way around, browse your services and fill in forms.

  • Interactive menu

    Touch buttons, back/home, auto-return after inactivity.

  • Cards

    Tiles with icons and badges; a tap opens other content.

  • Form

    Surveys and sign-ups with a virtual keyboard and CSV export.

Interactive touch menu

Several things at once

Split the screen into zones: the menu on the left, the clock on the right, the news along the bottom.

  • Split screen

    Several items at once in zones: sidebar, bottom bar, L-shape, grids.

Split screen: meetings next to the clock and weather
Reports

Proof of play

Reports of what played where and how often, by content and by screen, with CSV export for advertisers.

Branding: 10 themes

Branding

10 built-in themes in dark and light mode, custom colours and fonts, shareable theme files, logo watermark and header bar. A different theme per screen.

Emergency alerts

Emergency alerts

An instant full-screen message on all or selected screens, with templates and expiry.

Users, roles and API keys

Roles and API

Administrator, editor and viewer roles, plus API keys so other systems can send alerts or content.

Scheduling

Playlists per screen by day, time window and date range. Scheduled screen off turns the monitor off too (DPMS).

Remote control

Live screenshot of the real display, identify, previous/next, reload, restart the player or reboot the device — from the admin.

Works offline

The player caches its configuration and media and keeps running if the server goes down.

Polished kiosk

Boot splash with a progress bar instead of console text, touch or mouse mode per screen, no translate pop-ups.

Programmed by Claude

Every line — server, admin panel, player, installers and docs — was written by Claude, Anthropic's AI, in Claude Code. New features arrive the same way.

Templates in the admin panel

10 ready-made templates

Install a complete content pack in one click – in your own colours – or export your own as a .narancs.json file and import it anywhere.

  • 🍽️ Restaurant
  • 🏢 Office
  • 🛍️ Shop
  • 🩺 Clinic
  • 🎓 School
  • 🏨 Hotel
  • 💪 Gym
  • 🎤 Conference
  • 🍹 Bar
  • 💇 Salon

How does it compare to Yodeck, Screenly, ScreenCloud and Xibo? →

See it

Up and running in minutes

1 Server Ubuntu / Debian, amd64 or arm64 · macOS: same without sudo

curl -fsSL https://github.com/mzzg-bazsi/narancs-signage/releases/latest/download/install.sh | sudo bash

Installs Node.js, a systemd service and daily backups. Open http://SERVER-IP:8080/admin/ and create your account.

2 Each display Ubuntu Server or Raspberry Pi OS Lite

curl -fsSL http://SERVER-IP:8080/install-player.sh | sudo bash

Reboot, then enter the 6-digit code shown on the screen under Screens → New screen. No install? Open /player/ in any browser.

Windows — a setup wizard for the server, a kiosk display, or both on one PC. Node.js is included; the display-only mode turns the PC into a kiosk that signs in by itself.
Download for Windows

Using a Raspberry Pi? Flash a ready-made image instead – it installs everything on the first start, as a display, a server, or both in one.

Read the full documentation →