Omybuntu is an unofficial, highly optimized port of Omarchy and Omakub designed specifically for the Debian/Ubuntu ecosystem. It maintains the original philosophy of creating an opinionated, beautiful, and developer-focused desktop environment using tiling window managers, while delivering rock-solid stability and modern package compatibility on Ubuntu bases.
- Window Manager: Pre-configured Hyprland session offering smooth animations, tiling, and keyboard-centric window layouts.
- Modern Shell & Terminal: Foot terminal emulator configured with Starship prompt, zoxide, eza, fzf, lazygit, tmux, and btop.
- Multilingual Installer: Interactive installation wizard supporting English, Portuguese (Brasil), and Spanish.
- Theme Support: Over 20 curated themes (Catppuccin, Gruvbox, Tokyo Night, Nord, and more) switchable instantly.
- Modular CLI: Command-line interface with a clean route manager that handles all configuration, updates, packages, and theme changes under the unified
omybuntucommand. - TUI Apps: Integrated lightweight terminal user interfaces for system operations including Impala (Wi-Fi), Bluetui (Bluetooth), Wiremix (Audio), and Cliamp (Audio playback).
- Automated Migration System: Automated timestamp-based configuration migrations that run transparently during repository updates.
The repository is organized to separate defaults, user configurations, automation scripts, and command-line helpers.
Instead of forcing users to remember individual helper scripts, Omybuntu provides a main binary (bin/omybuntu) that scans the bin/ directory and exposes command routes. Commands use a structured prefix naming scheme:
cmd-: General CLI check utilities.capture-: Screenshot, screen recording, and text-extraction tools.pkg-: Package management helper functions.hw-: Hardware and device feature detection.refresh-: Tools to copy/reset default configuration templates to the user space.install-: Installers for optional developer tools, browsers, and game launchers.launch-: Application launchers and runners.theme-: Theme settings, background switchers, and template renderers.update-: Systems and keyring updater scripts.
To run a sub-command, you can execute:
omybuntu theme set gruvbox- Templates: Located in
default/themed/*.tpl, these files contain placeholders like{{ accent }}or{{ background }}. - Color Definitions: Found in
themes/*/colors.toml, specifying colors for every themed element. - Refresh Pattern: When a theme is updated, the template renderers read the theme definitions and dynamically rewrite configuration files for Waybar, Foot, Hyprland, Hyprlock, Kvantum, and GDM/SDDM.
- Hyprland Configuration: Note that Omybuntu uses
.conffiles for Hyprland configuration (unlike Omarchy, which uses.lua). This is a deliberate choice; we will maintain the.confformat until the Ubuntu packages for Hyprland are updated to fully support Lua. - Config Overwrites: The utility
omybuntu-refresh-configcopies default templates underconfig/to the user's~/.config/with automatic backups.
Omybuntu downloads and configures external launcher engines and TUIs during the setup process:
- Walker: A fast, extendable application runner.
- Elephant: A highly pluggable keyboard launcher.
- Impala: Terminal-based Wi-Fi management utility.
- Bluetui: Terminal-based Bluetooth management.
- Wiremix: Audio mixer TUI.
- Cliamp: Lightweight music player.
To ensure configuration consistency when pulling updates, Omybuntu contains a migration framework under migrations/. Migrations are:
- Sourced sequentially rather than executed directly.
- Named after the Unix timestamp of the last commit.
- Used to patch user configuration files, remove old packages, or perform one-off repair work without user intervention.
Omybuntu comes preconfigured with beautiful dark and light themes. Previews of some popular styles:
Catppuccin |
Gruvbox |
Tokyo Night |
Nord |
To install Omybuntu directly on an active, clean Ubuntu installation, execute the boot script using curl or wget:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/erickdevit/omybuntu/master/boot.sh)"Alternatively, you can use wget:
wget -qO- https://raw.githubusercontent.com/erickdevit/omybuntu/master/boot.sh | bashTo target a specific branch or a custom fork for deployment, specify OMYBUNTU_REPO and OMYBUNTU_REF environment variables:
OMYBUNTU_REPO="erickdevit/omybuntu" OMYBUNTU_REF="master" bash -c "$(curl -fsSL https://raw.githubusercontent.com/erickdevit/omybuntu/master/boot.sh)"For a streamlined bare-metal deployment, we are building a custom Omybuntu ISO installer.
- Direct Boot: Boot straight into the installer which configures Ubuntu and Hyprland without requiring an existing GNOME/Ubuntu Desktop installation.
- No Bloat: Avoids standard GNOME packages, installing only what is defined in the Omybuntu base package lists.
- Rapid Deployment: Incorporates custom chroot scripts to prepare system storage quickly.
- Status: The ISO generation scripts are in active development and testing. The official .iso image will be made available for download very soon.
Omybuntu would not exist without the incredible work of the projects it builds upon. All conceptual credit, design philosophy, and thousands of hours of initial development belong to the original creators:
- Omarchy: Omybuntu is a direct fork and port of Omarchy. We owe our entire foundation to the Omarchy contributors who built the Arch-based vision.
- Omakub: The original visionary project created by David Heinemeier Hansson (DHH) and the Basecamp team. Omakub set the gold standard for what a beautiful, modern, and opinionated Linux distribution should look and feel like.
Omybuntu aims to be a faithful continuation of this vision, bridging the gap between Omarchy's bleeding-edge Arch architecture and the widespread accessibility of Ubuntu.
We welcome contributions! Please see our Contributing Guidelines for details on our professional workflow, issue templates, and pull request standards.
Omybuntu is released under the MIT License.