Skip to content
/ obscreen Public

A fancy self-hosted digital signage tool. Free, simple and working.

License

Notifications You must be signed in to change notification settings

jr-k/obscreen

Repository files navigation

Obscreen

Obscreen is a user-friendly self-hosted digital signage tool leveraging chromium browser.

πŸ§‘β€πŸŽ„ Open to feature request and pull request. Cast your vote for your preferred ones on the Canny platform

⭐️ You liked it ? Give this repository a star, it's free :)


πŸ•ΉοΈ Live Demo

Try it!

Demo Server (Location: Roubaix - France): https://demo.obscreen.io

It is a temporary live demo, all data will be deleted after 30 minutes (~30secs downtime).

πŸŽ‰ Features

  • Dead simple chromium webview inside
  • Fancy graphical user interface
  • Very few dependencies
  • Embeddable SQLite database
  • Fleet screen management
  • Playlist management
  • Authentication management
  • Plays content from flashdrive in offline mode
  • Core API & Plugin system to extend capabilities
  • Multi Languages
  • Cast pictures and iframes to Chromecast
  • No costly monthly pricing plan per screen or whatever, no cloud, no telemetry

πŸ‘¨β€πŸ³ How to install

πŸ“Έ More Screenshots

Light Mode:

Content Explorer:

Settings Page:

Add Content Modal:

🫑 Motivation

  • I was searching for a self-hosted monitoring tool similar to "Screenly", but struggled with "Anthias" (formerly Screenly OSE) due to compatibility issues on some webpages. Chromium does a great job at rendering webpages, so I decided to create my own solution based on browsers.
  • Enjoy a beautiful graphical interface
  • My goal was to keep the code as simple as possible, using reliable technology with minimal dependencies.
  • Aim to showcase the power of the Raspberry Pi 5.
  • Deploy my first true Docker image to Docker Hub using a continuous deployment pipeline.

If you value this project, please think about awarding it a ⭐. Thanks ! πŸ™

πŸ›Ÿ Discussion / Need help ?

Join our Discord

Open an Issue

Troubleshoot

Why aren't the videos starting?

This is "normal" behavior. Videos do not play automatically in Chrome because it requires user interaction with the page (a simple click inside the webpage is enough). If you open the console, you'll see the error: Uncaught (in promise) DOMException: play() failed because the user didn't interact with the document first...

To resolve this, you need to use the Chrome flag --autoplay-policy=no-user-gesture-required. When connecting a Raspberry Pi with Obscreen Player autorun, this issue doesn't occur because the flag is handled automatically for you.You need to enable this flag yourself otherwise.


πŸ‘‘ Contributions

Create Pull Requests

We accept all types of pull requests.

Test Beta Version

Check out the latest beta release here: https://github.com/jr-k/obscreen/releases

Translations

If you want to translate Obscreen into your language, please visit Languages Files.

Spelling & Grammar

Feel free to correct the grammar in the documentation or code. My mother language is not English and my grammar is not that great.