74 lines
2.1 KiB
Markdown
74 lines
2.1 KiB
Markdown
# BottomDash
|
|
|
|
A tiny bottom-screen dashboard for the AYN Thor running Armada OS.
|
|
|
|
It gives the otherwise-idle lower OLED a job: a clock and battery indicator on a black background. It runs through Armada's `armada-run-bottom`, allowing dual-screen applications to lease the lower display and automatically returning to BottomDash when they're done.
|
|
|
|
## Disclaimer
|
|
|
|
This project is **vibe coded**. I am not a Qt developer. I wanted my bottom screen to show a clock and battery level, and through sufficient bullying of an LLM, now it does.
|
|
|
|
I was, in fact, too lazy to even write this README myself. The same LLM wrote it. Adjust your expectations accordingly.
|
|
|
|
## Building
|
|
|
|
Requires Qt 6 and CMake. Armada already includes the Qt runtime; development packages can be installed in a Fedora Distrobox to avoid modifying the host OS.
|
|
|
|
```bash
|
|
cmake -B build
|
|
cmake --build build
|
|
```
|
|
|
|
Copy the resulting executable somewhere permanent:
|
|
|
|
```bash
|
|
mkdir -p ~/.local/bin
|
|
cp build/bottomdash ~/.local/bin/
|
|
```
|
|
|
|
## Running
|
|
|
|
To run BottomDash manually in Armada Gaming Mode:
|
|
|
|
```bash
|
|
/usr/bin/armada-run-bottom -- ~/.local/bin/bottomdash
|
|
```
|
|
|
|
## Starting automatically
|
|
|
|
Create `~/.config/systemd/user/bottomdash.service`:
|
|
|
|
```ini
|
|
[Unit]
|
|
Description=BottomDash lower-screen dashboard
|
|
After=gamescope-session-plus@steam.service
|
|
BindsTo=gamescope-session-plus@steam.service
|
|
|
|
[Service]
|
|
Type=simple
|
|
ExecStartPre=/bin/sh -c 'while [ ! -S /tmp/gamescope-lease.sock ]; do sleep 1; done'
|
|
ExecStart=/usr/bin/armada-run-bottom -- /usr/bin/env QT_QPA_PLATFORM=wayland %h/.local/bin/bottomdash
|
|
Restart=on-failure
|
|
RestartSec=2
|
|
|
|
[Install]
|
|
WantedBy=gamescope-session-plus@steam.service
|
|
```
|
|
|
|
Then enable it:
|
|
|
|
```bash
|
|
systemctl --user daemon-reload
|
|
systemctl --user enable bottomdash.service
|
|
```
|
|
|
|
BottomDash should now start with Armada Gaming Mode. Applications such as Azahar can lease the lower display normally; when they exit, BottomDash returns automatically.
|
|
|
|
Note that using BottomDash this way may conflict with Armada's Plasma Mobile bottom-screen session.
|
|
|
|
## Scope
|
|
|
|
Clock. Battery. OLED black.
|
|
|
|
That's it. The bottom screen has a job now.
|