Skip to content

Connected Displays

Pratham ResPOS supports three external displays that connect to the POS terminal over your local network:

DisplayPurpose
Kitchen Display (KDS)Shows incoming orders to kitchen staff in real time
Customer DisplayFaces the customer — shows cart items and promotional media
Order Status DisplayShows customers the status of their order while they wait

All displays connect wirelessly to the POS terminal via WebSocket over the local network. No internet connection is required.

Navigate to POS Settings → Device Settings to configure terminal and display settings.


Image: Screenshot of the Device Settings screen with the tab navigation


Step 1 — Terminal Configuration

Before any display can connect, the POS terminal must be configured as a WebSocket server. This is done in the Terminal Configuration tab.

Image: Screenshot of the Terminal Configuration screen

Settings

SettingDescription
Terminal Display NameA name to identify this POS terminal (e.g., "Main Counter", "Drive-Thru POS"). Shown in logs and reports.
Local Socket PortThe port displays use to connect to this terminal. Default is 59590. Only change this if there is a conflict with another service on your network.
Master DeviceEnables system-wide control privileges for this terminal. Enable on your primary POS terminal.

Tap Save Configuration after making changes.

Changing the socket port requires a POS restart to take effect.

Finding the Terminal's IP Address

After saving, the Technical Details panel on the right shows the terminal's Network Addresses — the IP addresses displays need to connect.

Image: Screenshot of the Network Addresses section showing the terminal's local IP addresses

Note down the IP address and port (e.g., 192.168.1.10:59590). You will enter this on each display device so it knows which terminal to connect to.


Step 2 — Connecting the Displays

On each display device (kitchen tablet, customer screen, order status screen), open the display app and enter the POS terminal's connection address:

<Terminal IP Address>:<Socket Port>

Example: 192.168.1.10:59590

Once entered, the display connects automatically and registers itself with the POS. The display type (kitchen, customer, or order status) is set within the display app itself.

All devices must be on the same local network (same Wi-Fi or LAN) as the POS terminal.


Step 3 — Customer Display Settings

The Customer Display tab lets you configure what appears on the customer-facing screen.

Navigate to POS Settings → Device Settings → Customer Display.

Image: Screenshot of the Customer Display settings screen

Settings

SettingDescription
Media Group to DisplaySelect which promotional media group (images/videos) to show on the customer screen. Media groups are managed in the back-office.
Slide Transition IntervalHow many seconds each media slide is shown before moving to the next. Default is 5 seconds.
Show Only MediaWhen enabled, hides the shopping cart and shows only promotional media. When disabled, the cart and media are shown together.
Line Item Font SizeText size for product names shown on the customer display (12px, 14px, 16px, or 18px).
Modifiers Font SizeText size for modifier details under each product (12px, 14px, 16px, or 18px).

Tap Save — settings are immediately broadcast to all connected customer displays on the network.

What the Customer Display Shows

When Show Only Media is off (default):

  • The customer's current cart items with quantities and prices
  • Selected modifiers under each item
  • Order total
  • Promotional media slides alongside the cart

When Show Only Media is on:

  • Only the promotional media slides
  • Cart is hidden (useful when no order is in progress)

Image: Screenshot of the customer display showing cart + media mode and media-only mode


Step 4 — Monitoring Connected Devices

The Connected Devices tab shows all displays currently connected to this terminal. Use it to verify displays are online and active.

Navigate to POS Settings → Device Settings → Connected Devices.

Image: Screenshot of the Connected Devices monitoring screen

What It Shows

ColumnDescription
Device NameThe name the display registered with
TypeKitchen Display, Customer Display, or Order Status Display
IP AddressNetwork address of the connected device
Connected AtWhen the device connected to this terminal
Last ActivityTime of the most recent signal from the device — green if active within the last 60 seconds

Tap Refresh to update the list and check current connection status.

A device showing no recent activity may have lost its network connection or been switched off. Check the device and its network connection.


How the Displays Work

Kitchen Display (KDS)

The kitchen display receives orders automatically when they are placed on the POS. Kitchen staff can see each order's items and mark individual items as prepared.

  • Receives a new order when it is sent to the kitchen from the POS
  • Updates in real time as items are marked ready
  • No configuration required beyond connecting to the terminal

Customer Display

The customer display updates live as the cashier adds or removes items from the cart. It shows the current cart state at all times during checkout.

  • Updates automatically as items are added, removed, or modified
  • Shows the order total
  • Displays promotional media between orders (or at all times if media-only mode is on)

Order Status Display

The order status display shows customers where their order is in the preparation process — useful in busy takeaway or quick service environments.

  • Updates automatically as the order status changes (Accepted → In Progress → Ready to Serve)
  • Helps manage customer queues without staff needing to call out order numbers

Troubleshooting

IssueSteps
Display not appearing in Connected DevicesCheck the display device is on the same network; verify the IP address and port entered on the display match the terminal's network address
Display was connected but now shows as inactiveThe display device may have lost network connection or been restarted — check the device and reconnect
Customer display not updatingConfirm the customer display is listed as active in Connected Devices; try saving Customer Display settings again to re-broadcast
Changed socket port but displays won't connectRestart the POS after changing the port; update the connection address on all display devices to use the new port
No IP addresses showing in Terminal ConfigurationEnsure the device is connected to the local network (Wi-Fi or LAN) before opening Terminal Configuration

Pratham ResPOS Documentation