:: 𝕆𝕡𝕖𝕟ℝ𝕚𝕠𝕥 ::

⚠️ WARNING: OpenRiot is IN PROGRESS and will not (yet) install! ⚠️

One Command. Complete Environment. Zero Compromises.

OpenRiot: The OpenBSD System You’ve Always Wanted

OpenRiot is the answer to every time you’ve thought “Why can’t an OpenBSD installation just work correctly from the start?” Built on the same principles as ArchRiot — perfect the details once, get it right every time.

Curated to be correct:

• 🪟 Sway Tiling — i3-compatible Wayland compositor with OpenBSD’s legendary stability
• ⚡ Robust Binary — Atomic operations, pledge/unveil security, zero dependency hell
• 🛡️ Privacy — Zero telemetry, zero tracking, zero data harvesting
• 🎨 Aesthetics — Carefully crafted dark themes that work at any hour
• 💎 OpenBSD — The most security-audited OS on the planet

Built on OpenBSD with Sway, because security and aesthetics shouldn’t be mutually exclusive.

📚 Navigate This Guide

• 🚀 Choose Your OpenRiot Experience
  • 🔥 Method 1: Install Script
  • ⚡ Method 2: OpenRiot ISO
• ⌨️ Master Your OpenRiot Desktop
• 🔄 System Management
• 🧰 Advanced Usage
• 🔧 Troubleshooting
• 📄 License
• 📋 Progress — Project status, plan, and architecture

🚀 Choose Your OpenRiot Experience

🔥 Method 1: Install Script

You already have OpenBSD installed

Transform your current OpenBSD system into OpenRiot

curl -fsSL https://openriot.org/setup.sh | sh

Perfect for:

• 🏠 System preservation — Keep your data and configs intact
• 🔧 OpenBSD variants — Any OpenBSD 7.x installation
• 🎨 Desktop upgrade — Transform just your desktop environment
• ⚡ Quick wins — Get OpenRiot’s features without starting over

What you get:

• OpenRiot Sway desktop environment and apps
• CypherRiot themes and customizations
• Waybar with custom modules
• Fish shell with git prompts

⚡ Method 2: OpenRiot ISO

You do NOT have OpenBSD installed

⚠️ Warning: ISO will replace a drive with OpenBSD + OpenRiot. ⚠️

1. 📥 Download OpenRiot ISO
   • OpenRiot ISO
   • Verify the SHA256 checksum before flashing

2. 🔧 Create bootable USB

    dd if=openriot-*.iso of=/dev/sdX bs=1M status=progress
   

3. 🚀 Boot and install
   • Boot from USB
   • Choose (I)nstall
   • Answer the prompts (autoinstall answers are pre-filled)
   • After base install, log in and run:

    curl -fsSL https://openriot.org/setup.sh | sh
   

⌨️ Master Your OpenRiot Desktop

OpenRiot uses Sway (i3-compatible Wayland compositor). Keybindings mirror ArchRiot:

Key	Action
Super + Return	Terminal (foot)
Super + D	App Launcher (wofi)
Super + F	File Manager (Thunar)
Super + B	Browser
Super + L	Lock Screen
Super + 1-6	Switch Workspace
Super + Shift + 1-6	Move Window to Workspace
Super + Shift + L	Lock Screen
Print	Screenshot (region)
Super + Shift + H	Keybindings Help

🔄 System Management

OpenBSD update commands:

# Update packages
pkg_add -u

# Update system
syspatch -a && sysupgrade -n && syspatch -a && sysupgrade

# Rebuild packages after major version upgrade
pkg_add -u

🧰 Advanced Usage

Environment Variables

OpenRiot sets sensible defaults in ~/.config/environment.d/:

XDG_CURRENT_DESKTOP=sway
XDG_SESSION_TYPE=wayland
XCURSOR_THEME=Bibata-Modern-Ice

Keybindings Customization

Edit ~/.config/sway/keybindings.conf and reload:

killall sway && sway

Waybar Modules

Waybar modules are in ~/.config/waybar/. See ArchRiot config for reference.

🔧 Troubleshooting

WiFi not working

OpenBSD uses iwx for Intel WiFi 6 (AX211). Run:

fw_update -a -v
reboot

Sway won’t start

Check logs:

sway -d 2>&1 | less

Package missing

Search OpenBSD packages:

pkg_info -Q package-name

📄 License

MIT License — see LICENSE

---

📋 Progress

See Progress.md for full project status, architecture, build plan, and TODO list.

OpenRiot 🐡 — An opinionated OpenBSD desktop system
Created by CyphrRiot