RoyalPOS Help

Help › Kitchen Display, Captain & Token Counter

Kitchen Display, Captain & Token Counter

Using the Kitchen Display System (KDS), the Captain ordering app, and the Token Counter display in RoyalPOS, and connecting them to the main POS over the local network (LAN/WiFi).

What is the Kitchen Display System (KDS) in RoyalPOS?

The Kitchen Display System (KDS) shows incoming orders on a screen in the kitchen instead of (or in addition to) printing paper KOTs. Kitchen staff see each order's items and update them through stages — pending, in process, and ready — so the floor and counter stay in sync.

Screenshot:

RoyalPOS Kitchen Display showing live orders in columns

How do I open the Kitchen Display on a device?

On the RoyalPOS dashboard choose the Kitchen option (available for restaurant outlets). The device then runs as a kitchen screen and shows orders sent from the main POS. A dedicated kitchen device stays on this screen during service.

  1. Open RoyalPOS on the kitchen device.
  2. From the dashboard, choose the Kitchen / KDS option.
  3. Connect to the main POS (enter its IP/port or use search).
  4. Leave the device on the KDS screen during service.

Screenshot:

Selecting the Kitchen option on the RoyalPOS dashboard

How does a kitchen screen connect to the main POS?

The main POS device acts as the server and the kitchen screen connects to it over the same WiFi/LAN using the POS device's IP address and port. Once connected, orders placed on the POS appear on the kitchen screen in real time.

  1. Make sure the POS and the kitchen device are on the same WiFi/LAN.
  2. On the kitchen device, open the Kitchen screen and the Join Server dialog.
  3. Enter the POS device's IP address and port (or use Search to find it).
  4. Connect — orders now stream live to the kitchen screen.

Screenshot:

Kitchen device connecting to the main POS over LAN

All devices (POS, KDS, captain, token counter) must be on the same local network.

How do I join the kitchen screen to the POS server (IP and port)?

On the kitchen screen, open the Join Server dialog, enter the POS device's IP address and port, and tap connect. You can also use the Search option to scan the local network and detect the POS automatically.

  1. Open the Kitchen screen → Join Server.
  2. Enter the POS device's IP and port, or tap Search to auto-detect.
  3. Tap Connect.
  4. The screen shows connected and begins receiving orders.

Screenshot:

Join Server dialog with IP, port and search options

How do I find the POS device's IP address for the kitchen/captain to connect?

The POS device's IP is shown on the POS where the server is started (printer/kitchen server settings show the device IP and port). You can also check the device's WiFi settings for its IP address, then enter that IP on the kitchen/captain/token-counter device.

  1. On the POS device, open the kitchen/server settings to see its IP and port, or check the device WiFi details.
  2. Note the IP (e.g. 192.168.1.10) and port.
  3. Enter them on the kitchen, captain, or token-counter device.

Screenshot:

POS device showing its server IP address and port

What do the Pending, In Process and Ready columns mean on the KDS?

Orders move through stages on the KDS: Pending (new, not started), In Process (being prepared after the kitchen accepts the items), and Ready/History (prepared/served). Staff advance an order from one stage to the next as they cook.

Screenshot:

KDS columns for Pending, In Process and Ready orders

How does the kitchen accept new items on the KDS?

On a pending order, tap Accept (All Accept for the whole order, or accept an individual item). The order moves into the In Process stage so everyone can see it is being prepared.

  1. Open the Pending column.
  2. Tap All Accept on the order card (or accept individual items).
  3. The order moves to In Process.

Screenshot:

Accepting items on a pending KDS order

How do I mark food as ready on the kitchen screen?

On an order in the In Process stage, tap the Food Ready button. The order's items are marked ready and the update is broadcast to the POS and any token counter, so the counter knows the order can be served or collected.

  1. Open the In Process column.
  2. Tap Food Ready on the order card.
  3. The order moves to Ready and the token counter/POS updates.

Screenshot:

Food Ready button on an in-process KDS order

How do I mark items as served on the KDS?

Use the All Served / Served action on the order card to mark items as served once they have been handed over. Served orders move into history.

  1. Open the order on the KDS.
  2. Tap All Served (or serve individual items).
  3. The order moves to history.

Screenshot:

All Served action on a KDS order

Can the kitchen screen play a sound when a new order arrives?

Yes. RoyalPOS plays an alert sound on the kitchen screen when a new order arrives so staff notice it without watching the screen. Keep the device volume up.

Screenshot:

Kitchen display new-order alert

Does the kitchen screen reconnect automatically if the WiFi drops?

Yes. The kitchen screen keeps a live connection to the POS and automatically reconnects if the WiFi briefly drops or the app is resumed from the background, so you don't have to re-join the server manually each time.

Screenshot:

Kitchen screen reconnecting to the POS automatically

What is the difference between the KDS and a kitchen (KOT) printer?

A kitchen printer prints a paper KOT ticket for each order; the KDS shows the same orders on a screen instead, with live status updates and no paper. You can use one or both — many outlets use the KDS for visibility and still print a KOT for record.

Screenshot:

Comparison of kitchen display screen versus a printed KOT

Can I run more than one kitchen screen?

Yes. Multiple kitchen screens can connect to the same POS over the LAN. Each connects with the POS IP and port and receives the live orders, so you can have separate screens for, say, the kitchen and the bar.

  1. Connect each kitchen device to the same POS IP/port.
  2. Each screen receives the live order stream.

Screenshot:

Two kitchen screens connected to one POS

What is the Captain app?

The Captain app lets waiters/stewards take dine-in orders at the table on a handheld device. It connects to the main POS over the LAN; orders punched on the captain device go straight to the POS and the kitchen.

Screenshot:

Captain app taking a table order

How do I connect the Captain app to the POS?

On the Captain device, enter the POS device's IP address and port (or use search) to connect over the same WiFi/LAN. Once connected, the captain can view tables and punch orders that sync to the POS.

  1. Put the captain device on the same WiFi/LAN as the POS.
  2. Enter the POS IP and port (or Search to auto-detect).
  3. Connect and start taking table orders.

Screenshot:

Captain app connecting to the POS server by IP

What is the Token Counter display?

The Token Counter is a customer-facing screen that shows order token numbers and their status — typically which tokens are being prepared and which are ready for pickup. It connects to the POS over the LAN and updates live as the kitchen progresses orders.

Screenshot:

Token counter screen showing preparing and ready tokens

How do I connect the Token Counter to the POS?

On the Token Counter device enter the POS device's IP address and port over the same WiFi/LAN. Make sure the Token Counter option is enabled on the POS so it broadcasts order data to the counter.

  1. Put the token-counter device on the same WiFi/LAN as the POS.
  2. Enter the POS IP and port to connect.
  3. On the POS, ensure the Token Counter option is enabled.
  4. Tokens now appear and update live.

Screenshot:

Token counter connecting to the POS by IP and port

What does the Token Counter show — preparing vs ready?

The Token Counter shows two groups: tokens that are still Preparing and tokens that are Ready. When the kitchen marks an order Food Ready, its token moves from Preparing to Ready so customers know to collect it. It shows recent orders only (older orders drop off automatically).

Screenshot:

Token counter with Preparing and Ready columns

The kitchen screen is not showing new orders — what should I check?

Check that the kitchen device and POS are on the same WiFi/LAN, that the correct POS IP and port were entered, and that the connection shows connected. Re-join the server if needed. A firewall or antivirus on the POS device can block the connection — allow RoyalPOS through it.

  1. Confirm both devices are on the same network.
  2. Re-open Join Server and re-enter the POS IP/port (or Search).
  3. Allow RoyalPOS through the POS device's firewall/antivirus.
  4. Reconnect and place a test order.

Screenshot:

Kitchen screen showing disconnected/connecting state

The Token Counter shows old or too many orders — how do I fix it?

The Token Counter shows only recent orders (the last few hours); older ones drop off automatically. If it shows stale data, confirm it is still connected to the POS and that the Token Counter option is enabled on the POS. Reconnecting refreshes the list.

  1. Confirm the token-counter device is connected to the POS.
  2. Ensure the Token Counter option is enabled on the POS.
  3. Reconnect to refresh the order list.

Screenshot:

Token counter refreshing its order list