01How Keryka works
Four building blocks, and one rule that decides between them.
Screens
Every TV you pair. Each one runs the Keryka player, and your admin shows a live preview of it.
Designs
The artwork: pages of text, images, video, clocks, countdowns and live products. Build one once and reuse it anywhere.
Campaigns
A placement: which designs play, on which screens, when, and at what priority.
Groups
Sets of screens you target together, by place or by purpose. A screen can belong to several.
A screen plays whatever is placed on it, whether directly, through one of its groups, or on all screens. When more than one campaign wants the same screen at the same moment, Keryka picks one in a fixed order, explained in How a screen chooses.
02What you need
- A screen. Any TV or display with an HDMI input, or a TV with Google TV built in.
- A player. A Google TV or Android TV device (recommended), or any device with a modern web browser. See Set up a player.
- Internet. Wi-Fi or Ethernet. Players only make outgoing secure (HTTPS) connections, so there are no ports to open on your network.
- A Shopify store. Keryka runs inside your Shopify admin.
03Install the Shopify app
- Open apps.shopify.com/keryka and choose Install. Shopify asks you to sign in to your store first if you aren't already.
- Review the access Keryka asks for (products, collections, metaobjects and files) and approve it. Keryka never asks for your customers or orders.
- Keryka opens inside your Shopify admin under Apps→Keryka Digital Signage. Home shows Set up your signage: three steps that tick themselves off as you go (create a design, connect a screen, show your design). Once all three are done it makes way for a live view of your screens.
Plans and prices are on Keryka's Shopify App Store page. You can change plan any time from Screens→Change plan; see Your plan.
04Set up a player
Two players are ready today, Google TV and any modern browser. Both end up in the same place: a screen showing a pair code.
Google TV and Android TV Recommended
The most reliable choice. Keryka Player starts on boot, keeps the TV awake, updates itself through Google Play and stores an offline fallback on the device. It works on TVs with Google TV built in and on streaming boxes or sticks running Android 8.0 or newer, over Wi-Fi or Ethernet.
- On the TV, open Google Play and install Keryka Player (its store page is titled Keryka Digital Signage). You can also install it from the Google Play website on a computer and choose the TV as the device.
- Open Keryka Player. The pair code fills the screen.
- When it asks Start automatically on boot?, press Enable, then switch Keryka Player auto-launch on in the settings page that opens. This uses Android's Accessibility Service for one purpose only: starting the player again after a reboot or power cut. It doesn't read the screen or collect any data.
- Turn off Google TV's shut-off timer: Settings→System→Power & Energy→Shut-off timer, and set both timers to Never. Otherwise the TV switches itself off 4 hours after the last remote press. No app is allowed to change this setting, so it has to be done by hand once on each box.
The player's settings are hidden so passers-by can't reach them. Press BACK five times quickly on the remote (on a touch screen, tap the top-left corner five times). From there you can switch auto-launch on, check for an update and see the device key.
Any browser: smart TV, PC, Mac or Chromebox Works today
Any screen with a modern web browser can be a Keryka screen.
- In the browser, open
app.keryka.com/p. Or, in Keryka, go to Screens→Add screen→Any browser and use Open test screen or Copy URL for your store's own Display URL. - Make the page full screen: F11 in Chrome or Edge on Windows, Ctrl ⌘ F on a Mac.
- Set the device to open that page every time it starts, for example a Chromebox in managed kiosk mode, or a Windows startup shortcut that opens the browser in kiosk mode.
The browser needs a current engine (about Chrome 80 or newer). Many smart TVs more than a few years old don't have one, and their browsers show a blank page. Most consumer smart TVs also can't open a web page by themselves at power-on. A Google TV stick in the HDMI port fixes both. Browser players don't store an offline fallback yet.
Windows, LG, Samsung and Raspberry Pi On the roadmap
Dedicated players for Windows, LG webOS, Samsung Tizen and Raspberry Pi are on our roadmap. Until they arrive, a Windows PC can run Keryka in its browser as above, and any display can take a Google TV stick in its HDMI port.
05Pair a screen
With the pair code showing on the TV:
- In Keryka, open Screens and choose Add screen.
- Type the 6-character code into the boxes (pasting works too). Codes use only letters and digits that can't be mistaken for each other.
- Give the screen a Name you'll recognise later, such as "Front window".
- Under What should this screen play?, choose one:
- An existing campaign. The screen joins it.
- Start from a design. Keryka creates a campaign named after the design, placed on this screen only.
- Nothing yet. You'll place a campaign on it later.
- Press Claim screen. Within seconds your content replaces the code on the TV.
Plan full? You can still pair the screen, but it won't play until your plan has room. The TV shows License required with a QR code that opens your plan page. See Your plan.
Managing screens
Each row on the Screens page has a live thumbnail, what's playing now and a menu. Identify puts the screen's name on the TV so you can tell which is which, Restart screen reloads it, and Disable stops playback without touching what's placed on it. Open a screen to rename it, set Screen rotation to 90° or 270° for portrait, choose its groups and campaigns, and check its offline fallback.
06Create your first design
Designs are your artwork. Open Designs and create one, or start from Home→Create a design.
- Name the design, then start from a template or a blank canvas.
- Add layers from the toolbar: Text, Image, Shapes (rectangle, line, ellipse, icon) and Video. Under More you'll find Clock, Countdown, Ticker, Embed, QR code and Metric.
- For images and video, Browse picks straight from your Shopify Files library. To add new files, upload them under Content→Files in your Shopify admin.
- Add more pages for a slideshow. Each page has its own duration in seconds, and the pages play in a loop.
- Save.
Show live products
Select a page and open its Data section. Choose products, then Pick collection or Pick products. The page now repeats once per product: bind text and image layers to fields such as title, price, image, vendor or sku, and every product gets a page of its own, with prices that follow Shopify within about a minute.
- Status limits it to active products by default; Limit caps how many play.
- Only show in-stock products drops sold-out items within about a minute and brings them back when you restock. Products that don't track inventory always show.
- Choose metaobjects instead to drive pages from your own content types, such as a menu or a price list.
Handy shortcuts
07Put it on air with a campaign
A campaign decides where and when your designs play. Open Campaigns, create one, and fill in:
- Name
- For you. Screens never show it.
- Plays
- One or more designs. With several, they play one after another as a playlist.
- Plays on
- All screens, one or more groups, or individual screens.
- Plays when
- Always on — no schedule, or a repeat (every hour, every week on the days you pick, or every month on a set day), each with a start and end time in your store's timezone.
- Plays between
- Optional first and last dates.
- Priority
- One of four tiers, below.
Save from the save bar at the top of the page. Next to every place you pick, a preview shows what each affected screen will play this week, before anything changes on air.
Priority tiers
Everyday content. Even here, a scheduled campaign already wins over always-on content.
Wins over Standard when two campaigns want the same screen.
Wins over Promotion and Standard.
Wins over everything, scheduled or not.
How a screen chooses
When several campaigns want the same screen at the same moment, Keryka settles it in this order:
- The higher priority tier wins.
- At the same tier, scheduled beats always-on. A campaign with a repeat or an end date cuts into your everyday content while its window is open, then hands the screen back.
- Still tied, the place decides: the highest-ranked group first, then the screen's own placement, then all screens.
To keep that order clear, a place can hold only one campaign per tier at any moment. If a save would break that rule, Keryka stops and tells you which campaign clashes, where and when. Choose a different tier or a window that doesn't overlap.
Screens playing the same campaign turn their pages on the same beat. Sync screens in the campaign's menu restarts all of them on page one together.
08Group your screens
- Open Groups, create a group and name it after a place ("Front window") or a purpose ("Portrait totems").
- Open the group and add its screens. A screen can belong to several groups.
- Under Plays here, tick the campaigns the group should play. Choosing the group under Plays on in a campaign does the same thing from the other side.
- Mind the order. The list is ranked: when two of a screen's groups disagree, the higher group wins. New groups start at the bottom, so move a group up when it should win.
09Check what plays
- Screens. The Now playing column shows what each screen is playing and, in one sentence, why: "Promotion beats Standard", or "Scheduled, so it cuts in … until 18:00". If a paired screen has nothing to play, every page warns you.
- Schedule. A TV guide of the week, or of a single day, with one lane per screen showing what actually wins it, in your store's timezone. Click a block to open its campaign.
- Identify. In a screen's menu, puts the screen's name on the TV so you can match the row to the hardware.
10Offline fallback
The offline fallback is what a screen plays when it starts up and can't reach Keryka, for example after a power cut during an internet outage. A screen that loses its connection while playing simply carries on with what it has and reconnects by itself. The fallback is the safety net underneath.
- By default, every screen gets a card with your store's name.
- To use your own, open Screens→Offline fallback and set a Media URL and Type (image, video or PDF) for all screens. A screen's own page can override it.
- Each screen's page shows when its fallback has downloaded and is ready. Wait for that before you test by pulling the network cable.
The fallback is stored on Google TV and Android TV players. Browser players don't keep one yet.
11Your plan
- Plans and prices are on Keryka's Shopify App Store page. Shopify bills your plan with your store's invoice.
- The Screens page shows how many screens your plan covers and how many are in use. Change plan opens Shopify's plan page.
- If you move to a smaller plan, the screens you paired first keep playing and the rest show License required until there's room. Upgrade, and they're back within seconds.
- Uninstalling the app pauses your screens. Reinstall within 30 days and everything resumes as it was. After that, your store's data is erased.
12Troubleshooting
A paired screen shows "Nothing playing"
Nothing placed on it is live right now, or its only campaign is waiting for its window. Read the Now playing sentence on the Screens page, then place an always-on campaign on the screen or on one of its groups.
The TV went dark after a few hours, or overnight
That's Google TV's shut-off timer: Settings→System→Power & Energy→Shut-off timer, both timers to Never. Also make sure auto-launch is on, so the player returns after a power cut.
The TV shows "License required"
Your plan has no room for this screen. Change plan from the Screens page, or remove a screen you no longer use.
My products don't appear
Check the page's Data section: the Status filter (active by default), Only show in-stock products, and that the collection actually has products in it. The data preview in the designer lists the rows Keryka reads.
A screen shows as offline in the admin
Check the TV's network connection; the player reconnects by itself as soon as it can. If it stays offline, power the box off and on again.
A smart TV's browser shows a blank page
Its browser engine is too old for the player. Plug a Google TV or Android TV device into the HDMI port instead.
I can't find the player's settings on Google TV
Press BACK five times quickly on the remote.
13Get help
Email us at our support address; a person reads every message. Inside the Shopify app you can also chat with us from the messenger in the corner of every page.