HandyCafe Docs
owner cashier

Admin Panel

The Admin Panel (labeled "Computers" in the sidebar) is the primary workspace for monitoring and managing all client PCs in your internet cafe or gaming center. It provides a real-time overview of every connected machine, with tools to start sessions, control power, and access remote management features.

For a single screen that combines computers with consoles, Wi-Fi, bills and takings, see the Monitoring Board. Its computer cards use the same actions as this page.

Dashboard Summary Cards

At the top of the Admin Panel, a row of summary cards shows key metrics for the current shift:

Card Description
Occupancy Percentage of PCs currently in use. Calculated as (PCs in use / total PCs) x 100.
Usage Total active session time across all clients.
Network Combined download and upload speed across all connected clients.
Paid Revenue already collected from completed sessions.
Pending Revenue from sessions that are currently active but not yet paid.
Total Sum of paid and pending revenue.

All revenue figures use the configured currency symbol and fraction digits. The row can be hidden with Info cards in Settings > View > Visibility.

View Modes

Open the view menu at the end of the filter toolbar to switch between five views. The choice is saved for the signed-in cashier. The default for new cashiers is set in Settings > View > Computers under Default view.

View What it shows
Card Full detail per machine: user, times, cost, network and host.
Compact Small cards with one reading per machine (time left, cost or debt) and the actions on hover.
Pulse One row per machine with status, time left and cost. Expands on click.
Icon Monitor icon and the machine name, nothing else. Fits the whole room on one screen. The icon style is chosen in Settings > View > Computers.
List Sortable table, one row per machine, with a totals strip. Fits the most machines on one screen.

The lower part of the same menu turns four page elements on or off for everyone: Command bar, System Log, Computer search box and Selection action bar.

Locking the Free Layout

When the Icon view uses free placement (Settings > View > Computers > Free placement), the same menu also shows Lock layout. While the layout is locked the tiles stay where they are. Click, double-click, the action menu and the selection box keep working. Only moving and aligning tiles is turned off. A lock icon in the top corner of the grid shows the layout is locked. Click it to unlock. The lock is saved per cashier.

When zones are in use, tabs above the grid narrow the view to one zone. All zones shows every zone with a header. Unassigned lists PCs without a zone.

Client Cards

Each client card in the grid view displays the following information:

Element Description
Hostname The display name of the client PC
Status icon A color-coded icon showing the current state of the machine
Session timer Start time, end time (for prepaid), used time, and remaining time
Progress bar For time-limited sessions, a visual bar showing how much time has been consumed
Member name The name of the assigned member, if any
Network stats Current download and upload speeds for the client

Status Colors

The status color always describes the machine itself. A computer with no live connection is shown in red, whatever session is recorded on it.

Status Color Meaning
Online Green An active session is running
Idle Cyan The client is connected and ready but no session is active
Paused Amber The session is paused. Billing is halted and the client screen is locked
Admin Purple The client is in admin or maintenance mode
Waiting for admin login Purple shield badge Login as admin was sent to a computer that was switched off. The server woke it and it opens in admin mode when it connects
Busy Cyan, with an hourglass icon A session was started and the connected client has not picked it up yet
Offline Red The client is not connected to the server

An unpaid postpaid account adds a payment badge next to the status icon. It does not change the color.

Login as admin on a switched-off computer works like starting a session on it. The card turns Busy and the server sends a wake signal. The message The computer is being woken. It opens in admin mode when it connects. confirms the request. If the computer does not connect within 10 minutes, the card returns to Offline.

Pending Sessions

A session can be started on a computer that is switched off. Until the machine connects and takes the session over, its card shows an hourglass icon instead of the plain offline icon. In the List view the status column reads Awaiting login.

If the computer never comes online, open its menu on the card, or its details panel, and choose Cancel session. Cancelling frees the station and charges nothing. An amount collected in advance is reversed and the cancellation is written to the log. A session the station has already picked up cannot be cancelled this way. A station with open orders must have them settled or moved first.

Cancel session needs the Cancel a pending session permission in the Computer Management group. The default cashier role does not include it.

Filter Toolbar

The filter toolbar sits between the summary cards and the client grid. It provides controls to narrow down and organize the displayed clients.

Status Filter

Filter clients by their connection and session state:

Filter Shows
All Every registered client
Connected All clients currently connected to the server (any status except Offline)
In Use Clients with an active or paused session
Ready Connected clients in the Idle state, available for new sessions
Offline Clients that are not currently connected
Legacy HandyCafe V3 and V4 clients. Shown only when legacy client support is turned on.

Each filter tab displays the count of matching clients. The selected filter is remembered for the signed-in cashier.

Search

The search box next to the filter tabs (Search IP, MAC, user or name) narrows the grid to matching computers. Press Escape to clear it. When nothing matches under the current filter but some computers match under All, a button offers to switch to All.

Connection Wizard

The Connection Wizard button opens the pairing screen with a 6-digit code for connecting a new client PC. It is shown to cashiers who may sign clients in, and can be hidden in Settings > View.

Card Order

Open Card order from the layout controls to choose how client cards and Pulse rows are arranged:

  • Use cafe default. Follow the Default card order selected by an administrator in Settings > View > Visibility > In-page elements > Computers.
  • Smart. Keep the operational order. Unpaid postpaid sessions, timed sessions, active sessions, remaining time, and client status determine priority.
  • Fixed. Keep visible PCs in natural computer-name order. Starting or stopping a session does not move the card. Matching names use the MAC address as a stable final tie-breaker.

The personal choice is saved for the signed-in cashier. Fixed ordering preserves relative positions inside each zone. A status filter can still add or remove a PC when its status no longer belongs to the selected filter.

Card Size and Card Gap

In the Card and Icon views, the layout controls also hold Card Size and Card Gap. Card Gap is a slider (0 to 50 px) that adjusts the spacing between cards. Both values are saved for the signed-in cashier.

Controls Menu

The Controls button at the end of the toolbar opens a menu for the whole cafe:

Entry What it does
Health check Scans all connected client PCs. See Health Check.
Message to all PCs Shows one message on every connected computer.
Shut down idle PCs Shuts down every connected computer without a session, after a confirmation.
Shut down all PCs Shuts down every connected computer, including ones with an active session, after a confirmation.
Scheduled shutdown Shuts down idle PCs or all PCs after a set number of minutes. A banner above the grid counts down and offers Cancel.

The message entry needs the messaging permission. The shutdown entries need the power permission.

Next Free Seat

A small box under the toolbar tells the cashier when a walk-in customer can sit down:

  • The number of free seats, for example 2 seat(s) free now, when at least one computer is idle or switched off.
  • The computer that frees up first, for example Next free: PC05 in ~12 min, when every computer is in use. Timed sessions count down to their end. Open-ended sessions are estimated from the average length of past sessions.
  • No free seat right now (open-ended sessions) when no end time can be estimated.

When customers are waiting in the queue or have a reservation starting soon, the box adds a reminder such as 3 waiting in queue. The estimate itself does not change. The same box appears on the Reservations page.

Hide it in Settings > View > Visibility under In-page elements with the Computers row Empty computer info box.

Health Check

Open Health check from the Controls menu in the filter toolbar to scan all connected client PCs. The summary shows the average health score plus CPU usage, RAM usage, disk usage, network latency, CPU temperature, and GPU temperature.

Each client row shows its own CPU and GPU temperature. Expand a row to view separate temperature gauges with system and storage details. A temperature of 85°C or higher is shown as a warning. A temperature of 95°C or higher is shown as critical and affects the health verdict.

Temperature readings depend on sensors exposed by the operating system or installed hardware drivers. On Apple Silicon Macs, HandyCafe reads the native PMU CPU and GPU temperature sensors without administrator access. HandyCafe shows N/A when a CPU or GPU sensor cannot be read. Computers without a readable sensor are excluded from the corresponding fleet temperature average.

Client Card Action Buttons

Clicking or hovering over any client card reveals action buttons for all available operations. Every command is also in the computer's menu, which you open on its card. The actions are organized by category:

Session Actions

Action Description
Start Session Begin a new postpaid or prepaid session on this PC
Stop Session End the current session and open the payment dialog
Pause Temporarily halt billing on the active session. The client screen locks until the session is resumed from the server
Resume Continue a paused session
Add Time Add or subtract minutes from the running session
Change PC Transfer the session to a different PC. You can also drag a card with a session onto a free card.
Cancel session Cancel a session that was started but not yet claimed on the client. See Pending Sessions.

Moving a Session by Dragging

Drag a card that holds a session and drop it on another card. This works in the Card, Compact, Pulse, Icon and List views. The two cards decide what happens. No menu appears:

You drop On Result
A running postpaid session A free computer The Change PC dialog opens with that computer already chosen as the target
A running postpaid session A computer with a live session The Transfer Payment confirmation opens. The bill is added to the target computer's bill and the source closes with no payment collected. The whole amount is collected from the target when its session ends
A prepaid session A free computer The Change PC dialog opens. A prepaid bill cannot be added to another computer, because its money is already in the till
A pending session A free computer The Change PC dialog opens. A pending session cannot be moved onto a computer that is in use

While you drag, valid targets are highlighted. When a drop is refused, a message names the reason. Legacy computer cards cannot be dragged or used as drop targets.

Remote Tools

Action Description
Remote Desktop Open a live remote desktop view of the client's screen
Screenshot Capture a single screenshot of the client's current screen
Window Capture Capture specific application windows on the client
Send Message Display a popup message on the client's screen
Remote Explorer Browse the client's disk, download and send files. See Remote Explorer.
Update client Push a HandyCafe Client update package to this PC. See Client Updates.
Restriction profile Move the PC to another restriction profile. Shown when at least one named profile exists. See Client Restrictions.

Application Information

Action Description
Running Apps View the list of applications currently running on the client
Startup Apps View applications configured to launch at Windows startup
Installed Apps View all software installed on the client PC
Windowed Apps View applications with visible windows

Power Management

Action Description
Shutdown Computer Shut down the client PC remotely
Restart Computer Restart the client PC remotely
Wake Up Send a Wake-on-LAN magic packet to power on an offline PC
Exit Client Close the HandyCafe Client software on the remote PC

Actions that are not applicable to the client's current state are shown as disabled. For example, you cannot pause an idle client or start a session on a PC that already has one running.

Selected Client Details Panel

Click a client card to open the details panel on the right side of the page. When Left-click opens the details panel is off in Settings > General, open the panel with Open details panel in the computer's menu instead. Close it with the X in its header.

Header

The header stays in place while the rest of the panel scrolls. It shows:

  • The computer name and a status badge.
  • The member's username, when a member is signed in.
  • The IP address, the hostname (when it differs from the display name), the MAC address and the client version.
  • Time Left, Used and Amount for the current session.

Live Preview

Under the header, a live view of the computer's screen plays while the panel is open. Click it to open the full remote viewer with Open Full Remote. When the remote window is already open, the preview offers Focus Remote Window instead. An offline computer shows Client offline, no preview. Turn the preview off with Live preview in the details panel in Settings > General.

Sections

The sections below appear only when the signed-in cashier's role allows their commands:

Section What it holds
Session Controls Start Session, Stop Session, Pause Session, Resume Session or Relogin Session, Make open-ended or Set time limit, Add Time with the time presets, and Reduce time
Equipment Rented equipment for the seat. Shown only when equipment is priced for this computer
Open Orders The computer's open orders, with cancel and void actions and a link to the Orders page
Power Controls Shutdown Computer, Restart Computer, Wake Up and Exit Client
Monitoring Screenshot, Remote Control, Running Apps, Run command, Installed Apps, Startup Apps, Process Monitor and Remote Explorer
Remote Actions Login as admin (only while the computer waits with no session), Terminate all apps, Send file and Send file & run, Update client, and an Open URL field
Send Message A message field with Send. Cancel session appears here for a pending session. Unlock Login appears when login is locked on the device
System Info Collapsible. Session Info (time used, time left, payment type, user type), Network Statistics (downloaded, uploaded) and System (total memory, memory usage, operating system, foreground app)
Running Apps Collapsible live list of running applications with used time and run time. A camera button on a windowed app captures that window

Shutdown and restart need a connected computer. Wake Up needs an offline one.

Selecting Several Computers

You can select multiple clients for simultaneous actions:

  • Click a card to select only that PC.
  • Hold Ctrl (or Cmd on macOS) and click cards to add or remove them.
  • Hold Shift and click a card to select the range from the last selected card.
  • Press Ctrl+A (or Cmd+A) to select every PC currently shown.
  • Drag across empty space to draw a selection box.
  • Click empty space to clear the selection.

Bulk Action Bar

While PCs are selected, a bar appears across the bottom of the page with the number of selected PCs and these buttons:

Button What it does
Start sessions Opens the Start sessions dialog for every selected PC that is free. See Starting Sessions on Several Computers.
Add product Adds the same products to the account of every selected PC.
Stop sessions Opens one dialog to close the sessions on all selected PCs that have one.
Shut down Shuts down the selected PCs after a confirmation. Shown only with the power permission.
Clear Clears the selection.

PCs that are skipped, for example because they have a pending account, are listed by name under the bar. On a narrow window the bar shrinks its text to stay on one line. To hide the bar, turn off Selection action bar in the view menu or in Settings > View.

Starting Sessions on Several Computers

Start sessions opens one dialog for all selected computers. Each computer is billed on its own:

  • The dialog lists the computers it will start. Remove one from the list to leave it out or use Restore all to bring every removed computer back. Computers that cannot start are listed under Skipped with the reason: in session, pending account or unpaid bill.
  • Choose a plan under Select a plan or pick Custom and enter Minutes (per PC) or Amount (per PC). The summary shows the amount for one computer and the total for all of them. When the selected computers have different hourly rates, a typed amount is charged as the same fixed price on every computer.
  • Turn Prepaid on to collect in advance, then choose the payment method. Print a receipt per computer prints a separate receipt for each one. When the payment method charges a card terminal, the terminal is charged once per computer.
  • Start one by one switches to starting each computer in turn with its own dialog.

The confirm button names the number of computers it will start. Member login is not offered here because a member can hold only one computer at a time.

Command Bar

The command bar is a row of icon buttons under the filter toolbar. Its buttons act on the selected PCs. A button turns on only when every selected PC supports that command. Hover over a button to see its name, or over a dimmed button to see why it is unavailable.

The command bar offers the same commands as the computer's menu, for example starting prepaid or postpaid sessions, Start one by one, Stop together, pause and resume, Add Time, Reduce time, Add Product, Change PC, Create voucher, messages and chat, Remote Control, Run command, Open URL, Send file, Remote Explorer, Update client, Wake Up, Restart Computer and Shutdown Computer. Commands your role cannot use are not shown.

Choose which buttons appear and in what order in Settings > View > Computers under Command bar buttons. Turn the bar off there with Show the command bar, or from the view menu on the Computers page.

System Log

The System Log panel sits under the computer grid. It shows new log records live as they arrive.

  • Use Collapse and Expand at the end of the header to fold the panel. Collapsed, it shows only the latest record.
  • Drag the top edge to resize it. Double-clicking the top edge also folds or unfolds the panel.
  • Filter the records with All, Stations, Cash and Errors. The Errors filter shows how many errors arrived.
  • Open detailed view opens the Logs page.

Turn the panel off in Settings > View > Computers with Show the system log panel, or from the view menu on the Computers page.

Real-Time Updates

The Admin Panel updates in real time through the TCP event stream between the server and connected clients. Changes happen instantly:

  • When a client connects or disconnects, its card appears or changes to the Offline state.
  • Session timers count in real time without page refreshes.
  • Network speed indicators update continuously.
  • Status colors change immediately when sessions start, pause, resume, or stop.

Permission Checks

All actions in the Admin Panel respect the cashier's role permissions:

  • If the cashier's role does not grant session management permission, session-related actions are disabled.
  • If the beta license is in read-only mode, all modification actions are disabled.
  • Power management actions require the appropriate permission level.

Disabled actions appear grayed out on the client card and detail panel. Hovering over a disabled action shows a tooltip explaining why it is unavailable.

Legacy Clients

HandyCafe V3 and V4 clients appear under the Legacy filter tab as their own card type. Their action toolbar is reduced to match what the legacy protocol supports. Enable runtime support in Settings > Clients > Legacy Clients before you expect them to show up. See Legacy Clients Settings. See Legacy Clients for full details.


Next Steps