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.
Dashboard Summary Cards
At the top of the Admin Panel, a row of summary cards shows key metrics for the current shift:
| Card | Description |
|---|---|
| Usage | Percentage of PCs currently in use, displayed as a speedometer gauge. Calculated as (online PCs / total PCs) x 100. |
| Network | Combined download and upload speed across all connected clients, in Mbps. |
| Usage Time | Total active session time across all clients, displayed in minutes. |
| Paid | Revenue already collected from completed sessions. |
| Pending Revenue | Revenue from sessions that are currently active but not yet paid. |
| Total Revenue | Sum of paid and pending revenue. |
All revenue figures use the configured currency symbol and fraction digits from Settings > Pricing.
View Modes
The Admin Panel supports three view modes, toggled from the filter toolbar:
Icon View (Grid)
Displays each client PC as a card in a grid layout. Each card shows the hostname, status color, session timer, member name, and network speeds. This is the default view and provides the best visual overview.
Detail View (Grid with Expanded Cards)
Similar to Icon View but with larger cards showing additional details such as the progress bar for time-limited sessions and more detailed session timing.
List View
Displays all clients in a table format with one row per client. This view is compact and efficient when managing a large number of PCs.
Client Cards
Each client card in the grid view displays the following information:
| Element | Description |
|---|---|
| Hostname | The display name of the client PC |
| Status color | A color-coded border or background indicating the current state |
| 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
Client cards are color-coded by their current status:
| Status | Color | Meaning |
|---|---|---|
| Online | Green | An active session is running |
| Idle | Cyan | The client is connected and ready but no session is active |
| Paused | Orange | The session is paused; billing is halted |
| Admin | Purple | The client is in admin or maintenance mode |
| Offline | Red | The client is not connected to the server |
| Busy | Yellow | The client is processing a request |
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 |
Each filter button displays the count of matching clients.
Search
A text search field that filters clients by hostname. Type any part of the hostname to narrow the list.
Sort
Sort the client list by:
- Hostname (ascending or descending)
- Status
- Time used (ascending or descending)
Group By
Group clients visually:
- None. All clients displayed together
- Status. Clients grouped into sections by their current status
Card Gap
A slider (0--50px) that adjusts the spacing between client cards in grid view. Useful for personalizing the visual density of the panel.
View Toggle
Switches between Icon, Detail, and List view modes.
Client Card Action Buttons
Clicking or hovering over any client card reveals action buttons for all available operations. 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 |
| Resume | Continue a paused session |
| Add Time | Add or subtract minutes from the running session |
| Switch | Transfer the session to a different PC |
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 |
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 | Shut down the client PC remotely |
| Reboot | Restart the client PC remotely |
| Wake on LAN | Send a Wake-on-LAN magic packet to power on an offline PC |
| Close 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
When you click a client card, the Selected Client Details panel appears on the right side of the Admin Panel. This panel shows extended information about the selected PC:
System Information
- Operating system version and build
- RAM usage and capacity
Application Lists
Tabbed views showing:
- Running Apps. Applications currently running, with process names and memory usage
- Startup Apps. Applications that launch automatically when the PC boots
- Installed Apps. All software installed on the client
- Windowed Apps. Applications with visible windows that can be targeted for window capture
Power Controls
Dedicated buttons for Shutdown, Reboot, and Wake on LAN, with loading states and disabled states based on the client's current status:
- Shutdown and Reboot are only available when the client is connected.
- Wake on LAN is only available when the client is offline.
Bulk Operations
You can select multiple clients for simultaneous actions:
- Hold Ctrl (or Cmd on macOS) and click multiple client cards to select them.
- Use the bulk action buttons to perform operations on all selected clients at once.
Available bulk operations include:
- Shutdown. Shut down all selected PCs
- Reboot. Restart all selected PCs
- Send Message. Display the same message on all selected PCs
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.
Next Steps
- Session Management: Learn the full session lifecycle
- Remote Desktop: View and control client screens
- Screenshots: Capture client screens
- Cashier Roles: Configure role-based permissions