macOS

Native digital signage player for Mac. Optimized for Apple Silicon and Retina displays.

About this platform

Obscreen Player for macOS is a native app designed for Apple computers. Whether you repurpose a Mac mini as a signage controller or an iMac as a lobby screen, the macOS player takes full advantage of Apple Silicon and Retina displays for ultra-smooth content rendering. Kiosk-like behavior is supported through macOS' built-in single-app mode.

Technical specifications

Operating System	macOS 12 Monterey or later
Architecture	Apple Silicon & Intel
RAM	2 GB minimum
Resolution	Up to 6K (Retina)
Storage	100 MB free space
Devices	Mac mini, iMac, MacBook

How to install

1. Download the app from the Mac App Store or directly from obscreen.io/players/macos.
2. Launch and pair: open the app, enter your Obscreen Studio URL, the device registers automatically.
3. Assign content: from your Obscreen dashboard, assign a playlist to the Mac screen and content starts playing.

Platform features

• Apple Silicon optimized: natively built for M-series chips. Efficient power usage and smooth playback even with high-resolution content.
• Retina display support: full-resolution rendering on Retina and ProMotion displays for pixel-perfect signage.
• Auto-launch on login: configure the app to start automatically at login, turning any Mac into a dedicated signage player.
• Silent background mode: runs quietly in the background without pop-ups or notifications.

Host Identification Configuration

To help you identify and locate your device, you can set the following metadata in url's query parameters

Example:

https://<STUDIO_PLAYLIST_URL>/?hostname=My%20Device&icon=auto&longitude=48.8566&latitude=2.3522`

Screen Flags

These are information about the screen resolution and rotation.

rotate=normal # normal, left, right, inverted
resolution=auto # 1920x1080, 1920x1080, 1920x1080, 1920x1080

Name & Icon

hostname="My Device"
icon=auto # any font-awesome icon name (i.e. fa-desktop, fa-laptop, fa-tablet, fa-mobile, fa-tablet-alt, fa-mobile-alt)

Search for icons

You can browse the free icon catalog here.

Positioning

Choose one of the following options from more precise to less precise location:

1. Precise positioning

longitude=
latitude=

2. Structured address-based positioning

street=
city=
state=
country=
postal_code=

3. Query address-based positioning

address_query= # (e.g. "1600 Pennsylvania Avenue NW, Washington, DC 20500")

See more about customizing the player's URL here.