HandyCafe Docs
owner

Client Appearance

Configure how the client desktop looks during active sessions in your cybercafe or gaming center. All appearance settings are managed from the server and pushed to connected clients in real-time.

Open Settings > Clients and choose the Appearance tab. The lock screen has its own Idle Screen tab. See Client Idle Screen.

Themes

Design Theme decides the layout and the visual style of the client desktop. There are 21 themes in three families. The theme applies in Game Mode. In Desktop Mode the client is a floating panel instead: see Client Display Modes.

Essentials

The three base layouts. Everything else is built on one of them.

Theme Character
Arena Sharp esports HUD with a cyan edge
Cinema Cinematic red poster wall, closer to a TV interface
Tablet Touch tile grid in indigo, built for touchscreen stations

Color variants

The same layouts in a different accent colour.

Theme Base layout and accent
Neon Arena Arena layout, neon cyan
Crimson Pulse Arena layout, crimson
Emerald Depth Arena layout, emerald green
Sunset Glow Arena layout, sunset orange
Amethyst Surge Arena layout, amethyst violet
Midnight Silver Cinema layout, monochrome silver

Immersive scenes

Animated, full-screen interfaces with their own structure rather than a recolour of a base layout.

Theme Character
HoloDeck Sci-fi glass deck with cyan holographic accents
Starforge Full HUD frame over a star nebula, with a floor-projected hologram ring
Starport Station cockpit at planetary sunrise, with inward-tilted side consoles and a bottom library rail
NeonVice Synthwave night drive: a banded retro sun over a scrolling neon grid
Obsidian Anthracite lounge with monochrome volumetric smoke and a platinum sheen
Mirage Scorched desert dunes with a shimmering heat haze and a terracotta accent
Aurora Frosted glass panels with drifting coloured lights on a near-black canvas
Riptide Deep-sea split launcher with caustic light
Voltage Esports grid with live energy
Eclipse Center-stage carousel with a gold corona
Magma Basalt fissures with a molten flow
Blueprint Still ink-blue drafting grid

An immersive theme carries a heavier interface than the essentials. Prefer one of the essentials or a colour variant on older client hardware.

Global Online Layout

The Global Online Layout panel controls the session page for all categories. With an immersive theme selected, the panel title starts with the theme name, for example Starforge · Global Online Layout.

Setting Options Description
Poster ratio 9:16, 2:3, 3:4 (vertical), 16:9, 4:3, 3:2 (horizontal) Aspect ratio for poster images on app cards.
Card density Large, Medium, Compact Size of app cards in the grid.
Featured carousel interval (seconds) 5 to 60 How long each featured item stays before the next one. Shown for the essentials and colour variants.
Enable featured animation On, Off Turns the transition between featured items on or off. Shown for immersive themes.
Featured animation type None, Slide left, Slide right, Slide up, Slide down, Fade The transition between featured items.

Welcome Message

The Welcome message box holds a short text shown to the customer on the session page. Leave it empty to show none.

Desktop Color Scheme

Desktop Color Scheme appears only when the clients use Desktop Mode. Choose Dark or Light for the floating panel.

Starforge Customization

Select Starforge under Design Theme to use the WebGL client interface. The Online Layout panel is identified as Starforge · Global Online Layout while this theme is selected.

Starforge uses the existing persistent appearance controls:

Setting Starforge behavior
Poster ratio Changes the WebGL geometry used for library posters.
Card density Changes poster size and spacing while preserving the centered depth effect.
Enable featured animation Enables or disables the WebGL transition between featured posters.
Featured animation type Selects the transition direction or the deck-synchronized fade transition.

The featured stage uses a lightly transparent WebGL frozen glass layer over a procedural aurora animation. The configured cosmos background remains visible through the stage. No poster artwork is used in the background. Each featured selection receives a different accent color and animation phase. Thin water droplets use varied speeds, curved trails and irregular pauses. Droplets fade near the panel boundary to prevent clipped shapes. Crystalline frost and moving highlights add depth. A cover-cropped poster sits above the glass on the right with a left-facing perspective. It remains inside the featured stage and has softly rounded corners, a lightly frozen rim and a shadow directly below it. The featured stage itself has lightly rounded corners. Featured and library posters preserve their image aspect ratios. Library poster geometry uses light cuts on the top-right and bottom-left corners. Library posters also have individual shadows and follow a curved WebGL orbit around the active card. Mouse wheel navigation has a faster response. Dragging changes each poster's orbit angle, depth, scale and rotation continuously without changing selection. The selection changes after release when the distance or release momentum passes the threshold. Arrow button and keyboard navigation also update the selected poster. The top-right status card shows the client host and elapsed usage time.

Background Configuration

Customize the desktop background independently of the theme:

Setting Options
Background type Solid color, Gradient, Image, Video
Color The color for a solid background
Gradient CSS The CSS gradient for a gradient background
Select media Pick an uploaded image or video for an image or video background
Overlay opacity 30% to 95%. Not shown for a solid color.
Blur 0 to 30 px. Not shown for a solid color.

Real-Time Updates

All appearance changes are pushed to connected clients immediately. When you modify themes, layout settings, the welcome message or backgrounds, the changes take effect on client desktops without requiring a restart.

Client QR Code

The Client QR code setting controls the persistent QR code shown on client idle and online screens. You can turn it on or off.

Related Videos

Client Screen Themes and Layout

Pick a theme, set the tile shape and density, write your welcome message and choose what runs behind the grid.