v0.2.2

OpenCAL Image — Getting Started

Flash the .img.zst file to a microSD card using Raspberry Pi Imager or dd. Insert into your Raspberry Pi 5 and power on.

---

Default Login

Username	opencal
Password	OpenCAL1!

SSH is enabled by default. Connect over Ethernet and find the device IP via your router, or use opencal.local if mDNS is available on your network.

You will be required to change the password on your first SSH login. Choose a strong password — the default credentials are public.

---

WiFi Setup

WiFi credentials can be provided before first boot by editing the boot partition (the small FAT32 partition readable from any OS):

1. Copy wifi.txt.example → wifi.txt in the same directory on the boot partition
2. Fill in your network name and password:

   SSID=YourNetworkName
   PASSWORD=YourPassword
   

3. Eject the SD card and boot — credentials are applied automatically on first boot and wifi.txt is deleted so your password does not remain in plaintext

To configure WiFi after first boot, SSH in over Ethernet and run:

nmcli device wifi connect "YourNetworkName" password "YourPassword"

---

OpenCAL Service

opencal starts automatically on boot as a systemd user service. It launches after the Wayland display compositor is ready.

Check service status over SSH:

systemctl --user status opencal

View live logs:

journalctl --user -u opencal -f

Restart the service:

systemctl --user restart opencal

---

Display Configuration

The projector output resolution is detected automatically from the display's EDID. If your projector does not report EDID or you need to lock a specific resolution, edit wayfire.ini on the device:

nano /home/opencal/.config/wayfire/wayfire.ini

Add an output section with the desired resolution (use wlr-randr to list available modes):

[output:HDMI-A-1]
mode = 1920x1080@60

v0.2.1

Merge branch 'image-gen' into beta

v0.1.11

Add xwayland and dbus-user-session

v0.1.10

Add wpasupplicant

v0.1.9

Add wayland env vars and linger config

v0.1.8

Attempt autologin fix and pyproject.toml module structure

v0.1.7

Adjust wifi and autologin config

v0.1.6

Attempt adding Network Manager and WiFi

v0.1.5

Add build config that enables gpio and usb permissions

v0.1.4

Removed opencv from dependencies. Moved to TODO in build process.