Flavio's app supportAll guides · Sign in

← All guides

How to use Keynote Kiosk Runner

Keynote Kiosk Runner

Play a Keynote deck unattended during opening hours, start it again when it stops, and show a closed screen after hours.

Bought Keynote Kiosk Runner? Sign in with the email you bought it with to download the latest version or ask me a question.

On this page

Install

Keynote Kiosk Runner requires macOS 14 Sonoma or later, on Apple silicon or Intel, and Keynote, which is free on the Mac App Store. Download the ZIP from the order page or your Creem receipt. Unzip it and move the app to Applications.

The first time the kiosk plays a deck, macOS asks to let Keynote Kiosk Runner control Keynote. Click Allow. If you clicked Don’t Allow, turn it on in System Settings › Privacy & Security › Automation.

The app checks for updates once a day. When a new version is ready, click Install and Relaunch. To check anytime, choose Keynote Kiosk Runner → Check for Updates….

Choose and check the deck

Click Choose Deck…, or drop a .key file on the window. Then click Check with Keynote. Keynote opens the deck for a moment, counts the slides and looks at whether each slide starts its transition by itself, then closes it. Nothing in the deck changes.

The result shows the slide count, the skipped slides, Plays by itself, Not self-playing or “N wait for a click”, and Loops or No loop. If slides wait for a click, an orange warning explains that the show would stop there.

Keynote Kiosk Runner with no deck chosen yet: the sidebar with Deck, Slides advance and Outside opening hours, and the four steps Choose or drop the deck (.key), Check it with Keynote and pick how slides advance, Set the opening hours and the closed screen, Click Start Kiosk

How slides advance

Under Slides advance in the sidebar:

Either way the show loops. The kiosk plays a copy of your deck, kept in ~/Library/Application Support/Keynote Kiosk Runner/Playback, set to loop and, for Every few seconds, to move on by itself. Your deck is never opened or changed. If you save changes to it while the kiosk runs, the next check makes a new copy and starts the show again.

Opening hours

Tick each open day and set its opening and closing time. A closing time of 0:00 means midnight. The presets Mon–Sat 9:00–19:00, Every Day 10:00–18:00 and Copy Monday to Open Days fill in the rows. Always on plays day and night. Impossible hours show a red line that says what’s wrong.

Outside opening hours

Under Outside opening hours:

With several displays, choose which one shows the black screen or the picture. Keynote shows the slideshow itself on the display chosen in Keynote › Settings › Slideshow, and Keynote doesn’t let other apps pick it.

Start the kiosk

Click Start Kiosk. The bar above it tells you what happens now, for example “Open now: the show starts right away and stops today at 7:00 PM”, or the first problem to fix.

While the kiosk runs, the window shows its state (Playing, Closed, Recovering, Paused or Needs attention), a line with the slide number or the next opening time, and What happened: every start, opening, closing, pause and restart, with the time and the reason.

The Watchdog checks every 15 seconds by default (5 to 300). If the slideshow stopped, another document is in front, or Keynote quit, it opens the deck again and plays from the first slide. If Keynote doesn’t answer three checks in a row, it quits Keynote and starts again. Outside opening hours, a show started by hand is stopped at the next check. During opening hours the app keeps the display awake.

Pause and stop

Pause for 15 Minutes stops the show so you can use the Mac, and it starts again by itself when the pause ends. Resume Now ends the pause early. Stop Kiosk stops it for good, and ⌃⌥⌘K does the same from anywhere, even during the slideshow.

The same actions are in the menu bar item, which shows the state, the deck and the number of restarts, and in the Kiosk menu.

The menu bar item reads Paused, with its menu: Paused until 9:30 PM, Deck: Shop Window.key, Recoveries: 0, Resume Now, Stop Kiosk, Open Keynote Kiosk Runner… and Quit Keynote Kiosk Runner

After a restart or a power cut

Under When the Mac starts, turn on Open at login and Resume the kiosk when the app opens. Turn on automatic login in System Settings › Users & Groups too, so the Mac reaches the desktop without someone typing the password. If macOS asks you to approve the app, do it in System Settings › General › Login Items.

Command line

The app includes a command line tool at Keynote Kiosk Runner.app/Contents/Helpers/keynote-kiosk-runner:

keynote-kiosk-runner check ~/Kiosk/Window.key
keynote-kiosk-runner start --deck ~/Kiosk/Window.key --hours "mon-sat 9:00-19:00" --seconds 8
keynote-kiosk-runner status
keynote-kiosk-runner log --limit 20
keynote-kiosk-runner stop

start saves the settings and starts the kiosk in the app. Hours are always, or text like mon-sat 9:00-19:00, sun 10:00-16:00. Add --json to check, status and log for machine-readable output.

Everything happens on your Mac. The app uses the internet only to check for and download updates.

Keynote Kiosk Runner is $19, a one-time purchase.