Skip to content

About

A simple, self-hosted digital signage manager for TVs, kiosks, lobby displays, and marquees.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

12 Commits

Folders and files

Repository files navigation

Marquee-Manager

A simple, self-hosted digital signage manager for TVs, kiosks, lobby displays, and marquees.

Upload an image or video, select the screen(s), and hit Publish. Each display updates automatically and continues showing its last content even if the server temporarily goes offline.

Designed to be simple enough for staff to use without touching the server.

Quick Start — Windows

  1. Install Docker Desktop

Download and install Docker Desktop for Windows.

After installation, open Docker Desktop and make sure it is running.

  1. Download Marquee

Download the latest Marquee release and extract the folder to:

C:\Docker

You should end up with:

C:\Docker\marquee-v2

  1. Start Marquee

Open PowerShell and paste:

cd C:\Docker\marquee-v2

docker compose up -d --build

The first launch may take a few minutes while Docker downloads and builds everything it needs.

  1. Open Marquee

On the computer running Marquee, open:

http://localhost

From another device on the same network, use the server computer’s IP address:

http://192.168.1.100

Replace 192.168.1.100 with the IP address of the computer running Marquee.

That’s it.

⸻

Setting Up Displays

Marquee includes four displays by default:

http://SERVER-IP/screen/screen1 http://SERVER-IP/screen/screen2 http://SERVER-IP/screen/screen3 http://SERVER-IP/screen/screen4

Point each kiosk or display’s fullscreen browser to its corresponding URL.

Marquee works with any device capable of displaying a webpage in fullscreen, including:

  • Android + Fully Kiosk Browser
  • Raspberry Pi
  • Windows PCs
  • Repurposed laptops
  • Commercial signage players

Using Marquee

From the main dashboard:

  1. Drag in an image or video.
  2. Select one or more displays.
  3. Click Publish.

Marquee automatically prepares the media for a 1080×1920 vertical display.

Images and videos do not need to be manually resized beforehand.

Changing Your Displays

Open:

docker-compose.yml

Find:

SCREENS=screen1:Screen 1,screen2:Screen 2,screen3:Screen 3,screen4:Screen 4

Each display follows:

slug:Display Name

For example:

SCREENS=lobby:Lobby,entrance:Main Entrance,cafe:Cafe

After making changes, run:

docker compose up -d

Your display URLs would then be:

http://SERVER-IP/screen/lobby http://SERVER-IP/screen/entrance http://SERVER-IP/screen/cafe

Avoid changing a screen’s slug after it has been put into use.

Customization

Basic branding can also be changed in docker-compose.yml:

APP_NAME=Marquee TAGLINE=

Change APP_NAME to rename the dashboard.

TAGLINE can contain an optional subtitle or remain blank.

Media Support

Images

JPG, PNG, WEBP, HEIC and HEIF

Images are automatically resized and cropped to 1080×1920.

Video

MP4, MOV, MKV, WEBM and AVI

Videos are automatically converted to 1080×1920 H.264 MP4, muted, and looped on the display.

Reliability

Displays check for new content automatically.

New media is downloaded before replacing the currently displayed content. If the Marquee server or network connection goes down, the display continues showing its last successfully loaded image or video.

Uploaded media and display state are stored in:

\data

Restarting or rebuilding the Docker container will not erase your content.

Rollback

Each display remembers its previous item.

Rollback returns to the previously displayed content.

Clear removes the current content while retaining it as the rollback option.

Stopping Marquee

From PowerShell:

cd C:\Docker\marquee-manager-oss docker compose down

To start it again:

docker compose up -d

Updating

Download the newer version, replace the application files, and run:

docker compose up -d --build

Your media and database are stored separately in the data folder.

Back up the data folder before performing major updates.

Remote Access

Marquee v1 is designed for use on a trusted local network and does not include user authentication.

Do not expose the container directly to the public internet.

Remote access through services such as Cloudflare Tunnel or Tailscale is possible, but authentication should be added before allowing untrusted access.

Current Scope

Marquee v1 intentionally keeps things simple:

one current image or video per display.

Future development is planned around reusable media libraries and multi-item display playlists.

License

Released under the MIT License.

About

A simple, self-hosted digital signage manager for TVs, kiosks, lobby displays, and marquees.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages