JawnOS：基于 Perl 的自托管个人操作系统式仪表盘

A personal, self-hosted operating environment — "my operating system… kinda."

JawnOS is a long-running hobby project by Jon ("Jawn") Ferwerda that turns a single Perl web server into a personal command centre. It isn't really an operating system — it's a browser-based dashboard that pulls together the things one person actually does with a computer: managing files and media, keeping track of appointments and money, logging where you've been and what you've been doing, taking notes, sending mail, and driving a handful of handheld and wearable devices.

It works with the LilyGo T-Watch S3, the LilyGo T-Deck (Plus, with GPS), and the Raspberry Pi Pico 2W, and it has been wired into some home-automation bits and pieces.

It's still under active development, and finishing it is a "someday, hopefully" kind of goal — but it's genuinely useful in the meantime, and I hope it's of some use to you too.

Features

• Files & media — browse folders with a full right-click menu (new file and folder, rename, open, open with, copy/cut/paste, delete, shred, archive, properties), play video and audio, and view photos through an on-the-fly thumbnailer with a disk cache. Files can be sealed — encrypted with your suds under a name of their own — and opened again from the same menu, with the long jobs running in the background and showing their progress. A move, sealing, opening or deletion carries the appointments, mail attachments and store entries that named the file along with it.
• Music & studio — a multitrack studio with takes, crossfades, waveform clips and a pedalboard routed onto channels, alongside the synth and the music player.
• Appointments & scheduling — a full calendaring system with alarms, recurring appointments, reminders, and calendar export.
• Money — budgeting, invoicing and quotes, day-to-day accounting helpers, and a store with items, models and options that each carry their own prices.
• Warehouse & stock — money and goods tracked per place: what's where and how much of it, packaging that carries real quantities (a carton of twelve, a box of nails by weight) and shelf life, so expired stock is swept up on its own, and a journal of every stock movement and the reason for it — shown inline on both warehouse items and appointments.
• Drawing (the marker) — a layered paint board with pencil, paintbrush, spray, fill and matching erase tools, undo/redo, zoom and pan (pinch, ctrl + scroll, or scroll-to-zoom) and a toolbox that folds away. It reads stylus pressure and ignores your palm on a tablet, and the board autosaves, so a refresh doesn't lose a painting.
• Location & activity — location logging, travel history, distance/speed calculations, and a "father time" activity clock.
• Notes & documents — note-taking, document scanning, OCR (Tesseract), barcode/QR scanning (zbar), and PDF rendering (WeasyPrint).
• Communication — email (IMAP/SMTP), SMS, and an internal message/paper-route system.
• AI — chat and image generation through local Ollama models and Cloudflare Workers AI, plus speech (espeak) and transcription (whisper.cpp).
• Utilities & security — password and pseudonym generation, QR codes, encryption helpers, screen locking, and a keyring-style secret store.
• Devices — first-class support for the T-Watch, T-Deck and Pico 2W, with remote control, SSH tunnelling, and encrypted sync between machines.

How it's built

• Backend: Perl, using Mojolicious::Lite as the web framework. jawn is the launcher — it runs President.pl in a PTY and restarts it if it dies — and President.pl is the Mojolicious app that boots the HTTP/WebSocket server, background workers (Minion), and the rest of the machinery.
• Data: SQLite (via Mojo::SQLite / SQL::Abstract). Most internal message passing between processes is Sereal-encoded over Unix sockets.
• Real-time: WebSockets push updates to the browser so windows, notifications and status stay live without polling.
• Front end: Embedded-Perl (.ep) templates in templates/, rendered into a jQuery-driven "desktop in a browser" UI in public/.
• Firmware: Arduino sketches under jp/, jt/ and jw/ for the handheld/wearable devices.

Repository layout

Requirements

• Perl 5 with the CPAN modules listed in the installation section below (Mojolicious, Mojo::SQLite, Minion, Sereal, Crypt::Simple, and friends).
• A handful of command-line tools: ffmpeg, imagemagick, tesseract, sqlite3, qrencode, zbar, espeak, curl, rsync, openssl, sshpass and autossh (see below).

You don't have to install any of that by hand. The first time you run ./jawn it checks for every dependency and offers to install whatever is missing. The per-platform sections below are the do-it-yourself fallback.

Installation

The first run of ./jawn drives the whole install: it gets missing dependencies, then opens a web wizard that writes config.json and builds you an encrypted database (see First run). If you'd rather do the dependency install yourself first, the per-platform instructions below will do it — the wizard still handles the config and database.

To check (and optionally install) dependencies on their own:

perl scripts/jawnos_deps.pl           # report, then offer to install
perl scripts/jawnos_deps.pl --report  # report only; exits non-zero if anything is missing
perl scripts/jawnos_deps.pl --sh      # print the install commands as a shell script

Android (Termux)

Download and install F-Droid.

Install Termux. Install Termux:api.

In Termux:

termux-setup-storage

pkg install openssh termux-api espeak build-essential \
perl tesseract imagemagick zip sqlite sshpass openssh \
curl sox iproute2 libqrencode rsync zbar ffmpeg tmux \
autossh android-tools ollama termux-services

cpan App::cpanminus

cpanm Net::SSLeay

cpanm --notest --force Mojolicious::Lite \
 Net::SSLeay CryptX \
 WWW::Mechanize Time::Piece Time::Duration \
 Date::Parse Hash::Merge Encode Data::Dumper \
 File::Find File::Slurp Number::Format \
 SQL::Abstract Mojo::SQLite Data::UUID \
 Mojolicious::Plugin::RenderFile \
 LWP::UserAgent Crypt::Simple File::Type \
 HTML::Strip URI::Encode LWP::Protocol::https \
 URI::Escape MIME::Base64 Math::Trig List::Util \
 Net::IMAP::Client MIME::Parser \
 Email::Stuffer Authen::SASL \
 Minion Minion::Backend::SQLite Mojo::IOLoop::ReadWriteFork \
 Sereal::Encoder WebService::Ollama

pip install weasyprint

Activate developer settings by going to Settings -> About Device -> Software Information. Tap Build Number 7 times.

In Developer options turn on Wireless debugging. Tap it, then pair device.

adb pair ip:port
adb connect ip:port
adb shell settings put global settings_enable_monitor_phantom_procs 0
adb shell settings put global max_phantom_processes 2147483647

cd jawnos

chmod +x jawn President.pl

To run

./jawn

Debian

sudo apt update; sudo apt upgrade;
sudo apt install lib32z1-dev cpanminus \
ssh espeak build-essential zip openssl libssl-dev \
perl tesseract-ocr imagemagick sqlite3 sshpass \
ssh curl sox iproute2 qrencode rsync ffmpeg libbarcode-zbar-perl \
tmux weasyprint autossh net-tools ollama

sudo cpanm --notest --force Mojolicious::Lite \
 WWW::Mechanize Time::Piece Time::Duration \
 Date::Parse  Hash::Merge Encode Data::Dumper \
 File::Find File::Slurp Number::Format \
 SQL::Abstract Mojo::SQLite Data::UUID \
 Mojolicious::Plugin::RenderFile \
 LWP::UserAgent Crypt::Simple File::Type \
 HTML::Strip URI::Encode LWP::Protocol::https \
 URI::Escape MIME::Base64 Math::Trig \
 List::Util Net::SSLeay \
 Net::IMAP::Client MIME::Parser \
 Email::Stuffer Authen::SASL \
 CryptX Minion Minion::Backend::SQLite
 Mojo::IOLoop::ReadWriteFork Sereal::Encoder \
 WebService::Ollama

Edit /etc/ssh/sshd_config:

MaxSessions 1000000

Make swap (if not already created):

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

cd jawnos
./jawn

Manjaro

sudo pacman -Syu
sudo pacman -S base-devel cpanminus sqlite3 \
chromium xclip rsync sshpass certbot zip \
imagemagick espeak-ng tesseract xsane sox \
net-tools xdotool qrencode zbar fprintd python-weasyprint \
autossh lm_sensors ollama cmake python-pip

git clone https://github.com/ggml-org/whisper.cpp
cd whisper.cpp
make

# Fetch the base model configuration
bash ./models/download-ggml-model.sh base

sudo cpanm --notest --force Mojolicious::Lite \
 WWW::Mechanize Time::Piece Time::Duration \
 Date::Parse Hash::Merge Encode Data::Dumper \
 File::Find File::Slurp Number::Format \
 SQL::Abstract Mojo::SQLite Data::UUID \
 Mojolicious::Plugin::RenderFile \
 LWP::UserAgent Crypt::Simple File::Type \
 HTML::Strip URI::Encode LWP::Protocol::https \
 URI::Escape MIME::Base64 Math::Trig \
 List::Util Net::SSLeay \
 Net::IMAP::Client MIME::Parser \
 Email::Stuffer Authen::SASL \
 CryptX Minion Minion::Backend::SQLite \
 Mojo::IOLoop::ReadWriteFork Sereal::Encoder \
 WebService::Ollama

First run

From the jawnos directory:

chmod +x jawn President.pl
./jawn

On the first run — or any time config.json is missing — JawnOS walks you through setup:

1. Dependencies. scripts/jawnos_deps.pl checks for the required command-line tools and Perl modules and offers to install anything that's missing (using apt, pacman or Termux's pkg, plus cpanm).
2. config.json. A web wizard opens at http://127.0.0.1:3210/wizard where you fill in your name, device, start directory, port and media folders; it writes config.json for you. The signatorial is a file that won't change — JawnOS reads it at start-up, hashes it and uses it to encrypt cookies. Leave that field blank and the wizard generates one for you.
3. Database. The wizard builds a brand-new database from database/schema.sql and encrypts it with a numeric unlock code you choose (it can generate one). Write that code down — you type it at the gate screen to unlock JawnOS.

When setup finishes the wizard closes and JawnOS boots. Your browser opens at the gate with the new database listed; enter your unlock code to get in.

To re-run the wizard later, start with ./jawn --setup. To run just the wizard:

perl scripts/jawnos_setup.pl              # opens at http://127.0.0.1:3210/wizard
perl scripts/jawnos_setup.pl --port 4000  # use a different port
perl scripts/jawnos_setup.pl --no-browser # don't try to open a browser

Status

JawnOS is a work in progress. It ships with ten selectable icon sets and hover/long-press hints throughout the interface; the original hand-drawn icons are still the default. The folders app has had most of the attention lately — the right-click menu now does everything it lists, and files can be sealed and opened — along with the warehouse, the marker and battery use on phones.

License

BSD 2-Clause. See LICENSE.