Daphnis 0.1.0

First run

You can run Daphnis two ways: in a window with QEMU, or on a PC started from a USB drive. Both use the same disk image, and QEMU is the place to start, with no USB drive to write and no firmware setting to change.

Requirements

Each way needs different things, listed below. Start with QEMU, because it needs no USB drive and no change to your PC's firmware.

In a window with QEMU, the way to start:

On a PC from a USB drive:

To build the image from source:

Booted so far on an MSI MPG Z390 Gaming Edge AC (Core i7-8700K) and an HP Laptop 15-da0xxx (Core i5-8250U).

Download and check the image

Download Daphnis 0.1.0

Download the compressed image and SHA256SUMS from the release page, and put both in one folder. Open a terminal in that folder and run the two commands below: the first unpacks the image beside the download, and the second checks both files. The check shows the files arrived complete and unchanged, as long as SHA256SUMS came from the same release page; nothing is signed, so it shows no more than that.

xz -dk daphnis-0.1.0-x86_64.img.xz
sha256sum -c SHA256SUMS

Each line it prints must read OK; if one does not, download the files again.

Run it in a window with QEMU

QEMU is a virtual machine: a program that runs a second computer inside your own, so Daphnis opens in a window beside your other programs. It is the one virtual machine Daphnis is tested on. These steps are for a Linux PC with QEMU and its UEFI firmware.

  1. Install QEMU and its UEFI firmware. On Ubuntu 24.04 the packages are qemu-system-x86 and ovmf.
    sudo apt install qemu-system-x86 ovmf
  2. In the folder that holds the unpacked image, copy the firmware's settings file once, then start Daphnis with the command after it.
    cp /usr/share/OVMF/OVMF_VARS_4M.fd daphnis-vars.fd
    qemu-system-x86_64 -accel tcg -cpu max -m 4G \
      -drive if=pflash,format=raw,readonly=on,file=/usr/share/OVMF/OVMF_CODE_4M.fd \
      -drive if=pflash,format=raw,file=daphnis-vars.fd \
      -vga none -device bochs-display,edid=on,xres=1920,yres=1080 \
      -device qemu-xhci \
      -drive if=none,id=stick,format=raw,file=daphnis-0.1.0-x86_64.img \
      -device usb-storage,drive=stick
  3. The QEMU window opens on the first boot screen, the same screen a PC shows. Carry on at First boot below.
  4. To stop, choose Shut Down in Daphnis, and the QEMU window closes.
  5. To start Daphnis again, run the same command. Your accounts and files stay in the image file.

Run it on a PC from a USB drive

Use a USB drive to run Daphnis on a PC's own screen and keyboard, from the same disk image. There are three parts: write the drive, set the firmware, and start the PC on the first boot screen.

Write the USB drive

Writing the image erases the whole drive, so copy off any files you want to keep. To find the USB drive's device name, run this command once with the drive inserted and once with it removed; the line that comes and goes is the drive, and its NAME is the device name.

lsblk -d -o NAME,SIZE,MODEL

Then write the image, with the USB drive's device name in place of /dev/sdX. Write to the whole device, never to a partition such as /dev/sdX1.

sudo dd if=daphnis-0.1.0-x86_64.img of=/dev/sdX bs=4M conv=fsync status=progress

Any other tool that writes a raw image to a whole device does the same job.

Set the firmware

If the PC runs Windows with BitLocker or device encryption, have its recovery key at hand before you change anything. Windows may ask for it the next time it starts after a firmware setting changes.

Unplug every other USB drive. Daphnis uses only the first USB disk it finds, and keeps your home there only when that disk is this drive.

  1. Turn Secure Boot off in the firmware's setup. The boot loader on the drive is not signed, so with Secure Boot on the firmware refuses it.
  2. Open the firmware's boot menu and choose the USB drive's UEFI entry.
computerboot menuSecure Boot
MSI MPG Z390 Gaming Edge ACF11off on the tested board
HP Laptop 15-da0xxxF9on by default; turn it off in setup, F10

The PC starts straight into Daphnis, with no menu in between.

First boot

  1. The first boot screen asks for a name, a Password, and the Password again. A name is up to 32 lowercase letters, digits and the hyphen. A Parent's password has 8 characters or more, and a Child's has 4 or more.
  2. Press Enter to make the account. This first account is a Parent; every account is either a Parent or a Child.
  3. From then on, every start ends at the login screen, which lists accounts with Parents first. Choose yours, type its password and press Enter.

To shut down from the first boot, login or lock screen, press Super+Esc.

The desk

Super is the key with the Windows logo on most PC keyboards.

keysaction
Super, tapped alonethe Super plane: type to find an app or a file, Enter opens it
Super+Entera new Console, tiled
Alt+Tabthe switcher: hold Alt, press Tab to move, release Alt to choose
Super+1 to Super+9desktop 1 to 9
F11the focused window fills the screen
Super+Llock

An app you open from the Super plane or from Index floats, and an app you open with a Super+ combination tiles. The app's name in the bar at the top is its menu.

Index is the file browser. It opens your home folder, which holds Documents, Downloads and Pictures.

Settings to make first

When a prompt asks for a password

A prompt appears when a program wants more than its account holds: the disk, the network, sound, or the kernel's own rights. The system's prompt shows an AUTH mark in the bar, and a Parent's password answers it.

Inside a session, a password box without the AUTH mark is not the system's, so do not type a password into it.

Shut down

Tap Super and press the power button at the foot of the plane for Lock, Shut Down and Restart. Shut Down and Restart ask first only when something is unsaved, and Shut Down turns the computer off.

Switch User and Sleep are in the menu but do not work yet.