### Install Omabuntu with wget command Source: https://omabuntu.omakasui.org/manual/setup/installation Run this command in a terminal to download and start the Omabuntu installation. You will be prompted for your username and email to configure Git, and later to confirm extensions. A reboot is required at the end. ```bash wget -qO- https://omabuntu.omakasui.org/install | bash ``` -------------------------------- ### Retry installation Source: https://omabuntu.omakasui.org/manual/setup/troubleshooting If the initial installation fails, you can manually trigger the installation script. ```bash source ~/.local/share/omakub/install.sh ``` -------------------------------- ### Install Firefox browser with omakub Source: https://omabuntu.omakasui.org/manual/applications/browsers Installs Firefox from the Mozilla PPA, pinned to prevent replacement by Ubuntu's Snap package. Use this command to install a browser from the terminal. ```bash omakub install browser firefox ``` -------------------------------- ### Install Ruby and Node.js with Mise per-project Source: https://omabuntu.omakasui.org/manual/applications/development-tools Use these commands in a project directory to install specific runtime versions. They create or update a .mise.toml or .tool-versions file for the project. ```bash mise use ruby@3.4 mise use node@22 ``` -------------------------------- ### Install a Web App with omakub-webapp-install Source: https://omabuntu.omakasui.org/manual/applications/web-apps Run this command from the terminal or via the Omabuntu Menu (Install > Web App) to add a new web app. It prompts for the name, URL, and icon; icons are fetched from the site's favicon when possible, otherwise you are prompted for a URL (dashboardicons.com is suggested). The app opens in Chromium or your configured default browser if it is Chrome, Brave, Edge, Opera, or Vivaldi. ```bash omakub-webapp-install ``` -------------------------------- ### Install Flatpak app Source: https://omabuntu.omakasui.org/manual/configuration/packages Use this command to install a Flatpak application from Flathub. Replace with the application's ID, e.g., com.example.App. ```bash flatpak install flathub ``` -------------------------------- ### Install a hook with omakub hook install Source: https://omabuntu.omakasui.org/manual/configuration/hooks Installs a script as a hook for a specific event. The script must be executable and will run in alphabetical order with other hooks in the same .d directory. ```bash omakub hook install theme-set ~/my-theme-script ``` -------------------------------- ### Install Ruby globally with Mise Source: https://omabuntu.omakasui.org/manual/applications/development-tools Use the -g flag to install a runtime version globally, affecting all projects. ```bash mise use -g ruby@3.4 ``` -------------------------------- ### Install omakub-zellij with apt Source: https://omabuntu.omakasui.org/manual/setup/faq Install the Zellij package, which is no longer preinstalled in Omabuntu. Tmux is the default terminal multiplexer used by the configuration. ```bash sudo apt install omakub-zellij ``` -------------------------------- ### Example: add and drop a Notes keybinding Source: https://omabuntu.omakasui.org/manual/configuration/extra-hotkeys Adds a keybinding named 'Notes' that runs 'obsidian' with the key combination o, then removes it by name. Adding a shortcut that reuses an existing key combination replaces the old one. ```bash omakub gnome keybinding add "Notes" "obsidian" "o" omakub gnome keybinding drop "Notes" ``` -------------------------------- ### Review migration logs Source: https://omabuntu.omakasui.org/manual/setup/troubleshooting Displays the contents of the installation log file to help identify issues encountered during migration. ```bash cat /var/log/omabuntu-install.log ``` -------------------------------- ### Install a custom AI agent with omakub npm Source: https://omabuntu.omakasui.org/manual/applications/ai Installs a package as a command. The command name defaults to the package name; pass a second argument when the binary is named differently, as with scoped packages. ```bash omakub npm install [command-name] ``` -------------------------------- ### Example theme-set hook script (sync-wezterm) Source: https://omabuntu.omakasui.org/manual/configuration/hooks A bash script that receives the theme name as $1 and writes it to a Wezterm configuration file. This is a sample hook that can be activated by removing the .sample extension. ```bash #!/bin/bash # $1 is the theme name echo "theme = \"$1\"" > ~/.config/wezterm/theme.lua ``` -------------------------------- ### Install Chromium Google account service Source: https://omabuntu.omakasui.org/manual/applications/browsers Installs the Chromium account service to enable Google account sign-in, which fails out of the box due to missing OAuth credentials. Restart Chromium afterwards. ```bash omakub install chromium google account ``` -------------------------------- ### Verify sudo privileges Source: https://omabuntu.omakasui.org/manual/setup/troubleshooting Ensures the current user has the necessary sudo permissions required for installation. ```bash sudo -v ``` -------------------------------- ### Install and remove font families Source: https://omabuntu.omakasui.org/manual/configuration/fonts Commands to install or remove specific font families provided by Omabuntu. ```bash omakub install font jetbrains-mono omakub remove font jetbrains-mono ``` -------------------------------- ### Restore from backup Source: https://omabuntu.omakasui.org/manual/setup/troubleshooting Manually restore configuration files by removing the current directory and copying files from a specific timestamped backup folder. ```bash rm ~/.local/share/omakub cp ~/.local/share/omakub-backup-{timestamp} ~/.local/share/omakub ``` -------------------------------- ### Run migration script Source: https://omabuntu.omakasui.org/manual/setup/migration Execute this command in your terminal to initiate the migration from Omakub to Omabuntu. A reboot is required after the process finishes. ```bash wget -qO- https://omabuntu.omakasui.org/migrate | bash ``` -------------------------------- ### Configure Plymouth and GDM themes via CLI Source: https://omabuntu.omakasui.org/manual/essentials/themes Use the omakub command to set the boot splash (Plymouth) and login screen (GDM) themes, or reset them to the Omabuntu default. Note that Plymouth customization is skipped on systems with LVM disk encryption. ```bash omakub plymouth set-by-theme "Tokyo Night" # boot splash omakub gdm set-by-theme "Tokyo Night" # login screen omakub plymouth reset # back to the Omabuntu default omakub gdm reset ``` -------------------------------- ### Set default browser and print current default Source: https://omabuntu.omakasui.org/manual/applications/browsers Sets Firefox as the default browser and prints the current default. The first command sets the XDG handler and http, https, and text/html associations. The second command prints the current default. ```bash omakub default browser firefox ``` ```bash omakub default browser # print the current default ``` -------------------------------- ### Omabuntu GNOME keybinding add and drop commands Source: https://omabuntu.omakasui.org/manual/configuration/extra-hotkeys Use these commands to add or remove a custom GNOME keybinding. The add command takes a name, command, and keybinding; the drop command takes a name. Running add with no arguments prompts for the three values interactively. ```bash omakub gnome keybinding add omakub gnome keybinding drop ``` -------------------------------- ### Preview, set, and reset Plymouth boot splash Source: https://omabuntu.omakasui.org/manual/configuration/branding Preview, apply, and reset the boot splash. The preview command writes an image instead of applying. Setting the boot splash also syncs the login screen to the same colors and logo. Plymouth changes rebuild the initramfs and need sudo; on systems with LVM disk encryption the customization is skipped. ```bash omakub plymouth preview '#1d2021' '#ebdbb2' logo.png preview.png omakub plymouth set '#1d2021' '#ebdbb2' logo.png omakub plymouth reset ``` -------------------------------- ### Set background directly with omakub theme bg set Source: https://omabuntu.omakasui.org/manual/configuration/backgrounds Use these commands to set the background image directly. The first sets the image with default scaling; the second allows specifying a scaling mode (zoom, center, stretch, fill, fit, spanned); the third cycles to the next background. ```bash omakub theme bg set ~/Pictures/wallpaper.jpg omakub theme bg set ~/Pictures/wallpaper.jpg center # zoom, center, stretch, fill, fit, spanned omakub theme bg next ``` -------------------------------- ### iso2sd drive utility Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Writes an ISO image to an SD card. Running without arguments lists available SD card devices. ```bash iso2sd ~/Downloads/ubuntu-25.04-desktop-amd64.iso /dev/sda ``` -------------------------------- ### Manage About screen branding from terminal Source: https://omabuntu.omakasui.org/manual/configuration/branding Edit the About screen text, set it from an image, or restore the default Omabuntu logo. The About window reads from ~/.config/omakub/branding/about.txt. ```bash omakub branding about text omakub branding about image omakub branding about reset ``` -------------------------------- ### Set default browser, editor, and terminal Source: https://omabuntu.omakasui.org/manual/configuration/defaults Use these commands to define the default applications for web browsing, text editing, and terminal emulation. Running these commands without arguments will display the currently configured value. ```bash omakub default browser firefox omakub default editor code omakub default terminal ghostty ``` -------------------------------- ### Configure DNS settings Source: https://omabuntu.omakasui.org/manual/configuration/defaults Set the system DNS resolution provider. You can choose interactively or specify a provider like Cloudflare directly. ```bash omakub setup dns # choose interactively omakub setup dns Cloudflare ``` -------------------------------- ### tdl dev layout Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Opens Neovim, an AI tool, and a terminal in a single Tmux window. ```bash tdl claude # editor on left, claude on right (30%), terminal at bottom (15%) tdl claude codex # same, with a second AI tool below the first ``` -------------------------------- ### Share Files with omakub share Source: https://omabuntu.omakasui.org/manual/applications/desktop-tools Commands to send clipboard content, files, or folders to other devices via LocalSend. Transfers run as detached processes. ```bash omakub share clipboard # send the current clipboard as a text file omakub share file ~/Downloads/report.pdf omakub share file # pick files with fzf, Tab for multiple omakub share folder ``` -------------------------------- ### Run omakub debug diagnostics Source: https://omabuntu.omakasui.org/manual/setup/troubleshooting Collects system state information into a log file. Use the provided flags to print the output or skip sudo-dependent sections. ```bash omakub debug # write the log omakub debug --print # write it and print it omakub debug --no-sudo # skip the dmesg section, no sudo needed ``` -------------------------------- ### tdlm multi-project dev layout Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Opens a tdl layout per subdirectory of the current folder. ```bash tdlm claude # one window per child dir, each with editor + claude pane ``` -------------------------------- ### Video transcoding functions Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Wrappers for omakub transcode to convert video files to various formats. ```bash transcode-video-1080p input.mov # 1080p mp4 transcode-video-4K input.mov # 4K mp4 transcode-video-gif input.mov # animated gif ``` -------------------------------- ### Authenticate with GitHub CLI Source: https://omabuntu.omakasui.org/manual/applications/development-tools Run this command to authenticate gh with your GitHub account. It initiates an interactive login flow. ```bash gh auth login ``` -------------------------------- ### Manage fonts with omakub CLI Source: https://omabuntu.omakasui.org/manual/configuration/fonts Commands to list, check, set, and resize the system monospace font. ```bash omakub font list # every monospace font on the system omakub font current omakub font set "CaskaydiaMono Nerd Font" omakub font size current omakub font size set 10 ``` -------------------------------- ### tsl swarm layout Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Splits the window into N panes all running the same command. ```bash tsl 4 claude # four side-by-side panes each running `claude` ``` -------------------------------- ### Remove a Web App with omakub-webapp-remove Source: https://omabuntu.omakasui.org/manual/applications/web-apps Run this command to remove an existing web app. It shows an interactive picker and deletes the selected app's .desktop file, icon, and browser profile data. ```bash omakub-webapp-remove ``` -------------------------------- ### Image transcoding functions Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Wrappers for omakub transcode to convert image files to various formats and resolutions. ```bash img2jpg photo.png # JPG, high resolution img2jpg-medium photo.tiff # JPG, medium resolution img2jpg-small photo.tiff # JPG, low resolution img2png photo.jpg # PNG, high resolution ``` -------------------------------- ### Compression functions Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Functions for compressing directories and decompressing archives. ```bash compress dir_name/ # creates dir_name.tar.gz decompress archive.tar.gz # alias for tar -xzf ``` -------------------------------- ### Convert Media with omakub transcode Source: https://omabuntu.omakasui.org/manual/applications/desktop-tools Commands to convert pictures and videos into shareable formats. The output file is saved in the same directory as the input file with the specified resolution and format. ```bash omakub transcode # pick everything interactively omakub transcode --path ~/Downloads # limit the picker to one folder omakub transcode ~/Videos/demo.mov mp4 1080p omakub transcode ~/Pictures/photo.heic jpg medium ``` -------------------------------- ### Convert image to ASCII for About screen Source: https://omabuntu.omakasui.org/manual/configuration/branding Convert an image to ASCII for the About screen with custom dimensions. Options include --width, --height, --mode braille|block, --threshold 0-100, and --invert. Braille packs in more detail; block reads better at small sizes. ```bash omakub transcode ascii ~/logo.svg ~/.config/omakub/branding/about.txt --width 54 --height 26 ``` -------------------------------- ### Test a hook with omakub hook theme-set Source: https://omabuntu.omakasui.org/manual/configuration/hooks Triggers the theme-set hook manually with a given theme name, allowing you to test without switching themes. ```bash omakub hook theme-set "Tokyo Night" ``` -------------------------------- ### lip list active tunnels Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Prints all active SSH port forwarding tunnels. ```bash lip # print all active SSH port forwarding tunnels ``` -------------------------------- ### Check UFW status Source: https://omabuntu.omakasui.org/manual/setup/security Displays the current status and verbose configuration of the Uncomplicated Firewall. ```bash sudo ufw status verbose ``` -------------------------------- ### Manage Reminders with omakub reminder Source: https://omabuntu.omakasui.org/manual/applications/desktop-tools Commands to schedule, list, or clear desktop notification reminders. Reminders persist after closing the terminal but are cleared upon system reboot. ```bash omakub reminder 5 # notify in 5 minutes omakub reminder 30 "Check the oven" # with a message omakub reminder show # list what's pending, with times omakub reminder clear # cancel everything ``` -------------------------------- ### Run AI agents side by side with Tmux layouts Source: https://omabuntu.omakasui.org/manual/applications/ai Use tdl and tsl functions to run agents in Tmux panes. tdl claude gives editor left, claude right, terminal bottom; tdl claude codex adds a second agent below; tsl 4 claude creates four panes all running claude. ```bash tdl claude # editor left, claude right, terminal bottom tdl claude codex # same, with a second agent below the first tsl 4 claude # four panes, all running claude ``` -------------------------------- ### ga add worktree Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Creates a new Git worktree and branch in a directory adjacent to the current project. ```bash ga feature-login # creates ../myproject--feature-login/ on a new branch ``` -------------------------------- ### Set and reset GDM login screen Source: https://omabuntu.omakasui.org/manual/configuration/branding Set the GDM login screen background (hex color or image path) with a logo, or reset to default. The background accepts a hex color or an image path. ```bash omakub gdm set '#1e1e2e' logo.png omakub gdm set ~/Pictures/wallpaper.png logo.png omakub gdm reset ``` -------------------------------- ### fip SSH port forwarding Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Forwards local ports to a remote server. ```bash fip myserver 3000 # forward localhost:3000 to myserver:3000 fip myserver 3000 5432 # forward multiple ports in one command ``` -------------------------------- ### Remap compose key to right Alt with gsettings Source: https://omabuntu.omakasui.org/manual/setup/faq Use this command to move the compose key from Caps Lock to the right Alt key, restoring Caps Lock functionality. Any xkb compose option can replace 'compose:ralt'. ```bash gsettings set org.gnome.desktop.input-sources xkb-options "['compose:ralt']" ``` -------------------------------- ### gd delete worktree Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Removes the current worktree and deletes its associated branch after confirmation. ```bash gd # prompts for confirmation, then removes the worktree and deletes the branch ``` -------------------------------- ### dip SSH port forwarding removal Source: https://omabuntu.omakasui.org/manual/applications/shell-functions Stops active port forwarding for specified ports. ```bash dip 3000 # stop forwarding port 3000 dip 3000 5432 # stop multiple at once ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.