Build a GUI App with Chromium
This page was machine-translated. The Japanese page is the official version.
This guide introduces GUI applications for Actcast through an example browser application using Chromium. A GUI application can display information on a connected monitor and receive input from a mouse or keyboard. You can implement a custom interface or use existing GUI software.
Example application
The sample application displays a URL on a monitor connected to an Actcast device. Example uses include keeping a store dashboard visible or displaying signage.
See the Chromium sample application.
The sample supports:
- Opening a default URL specified in the Act settings at startup.
- Selecting between full-screen window mode and client-area kiosk mode through the Act settings.
- Keyboard and mouse input.
The Act settings used by the sample are:
| Setting | Description |
|---|---|
default_url |
URL to display at startup. |
kiosk_mode |
When true, Chromium displays only the client area in full-screen mode. |
keylayout |
Keyboard layout, expected to be jp or us, when text input is needed. |
Requirements
- Connect a display to the device.
- Connect any keyboard or mouse before starting the Act.
- Ensure the device’s network can reach the URL to display. The connection must not be blocked, for example by a required proxy.
Important
Hot-plugging a keyboard or mouse while the Act is running is not supported. Connect input devices before starting the Act.
Application structure
The sample targets ActcastOS 4 and assumes a Raspberry Pi 4 Model B. The application requires these files:
app/main
app/main.py
app/healthchecker
.actdk/setting.json
.actdk/dependencies.json
manifesto/bookworm.json
setting_schema.jsonWhen testing in Developer Mode, also provide act_settings.json. See the sample project for the complete implementation and setup instructions.