How It Works

Architecture

How it all fits together — from the theme to the terminal. Built to work on any Fedora user.

Theme Compilation

Downloaded during install and compiled for your GNOME version. Always fits, never breaks.

Flatpak Runtime

Sandboxed apps like Spotify, Discord, and VLC get the macOS theme too. Every app looks like it belongs.

Preflight Security

Terminal detection walks the process tree to block Ptyxis automatically. OS, desktop, sudo, internet, and boot mode all get checked before anything happens.

17 Fish Functions

Handy shortcuts for everyday tasks. Every function figures out your username automatically — works on any account.

Big Sur Sounds

45 macOS system sounds for clicks, alerts, and notifications. Makes your Fedora sound like a Mac.

Visual Installer

The terminal UI got a full refresh — welcome banner with GNOME version, phase dividers, timestamped logging, completion checklist, and a promotional box. Running the installer is now a premium experience.

Repo Layout

install.sh — 1,721 lines, 22 steps, works on any user
themes/ — macOS GTK theme, compiled for your system
icons/ — macOS-style icons for all apps
fonts/ — Apple SF Pro Display font
sounds/ — 45 macOS Big Sur sound files
configs/ — terminal, shell, system settings
desktop/ — app name overrides
(downloaded) — 14 GNOME extensions from extensions.gnome.org

What Gets Installed

Phase 1 — System prep: preflight checks (terminal detection, OS/desktop, sudo, internet), drivers, codecs, updates
Phase 2 — Apps: browsers, media players, dev tools
Phase 3 — Look: theme, icons, fonts, system settings
Phase 4 — Extras: login screen, Firefox, sounds
Phase 5 — Terminal: Kitty, Fish shell, shortcuts
Phase 6 — Cleanup: removes temp files and caches

How It's Built

Theme compiles for your GNOME version — always compatible
Uses system settings directly — works on fresh users
Terminal detection walks the process tree up to PID 1 — blocks Ptyxis at bootstrap and install.sh, then proactively removes it with all traces
Non-Kitty terminals get a premium warning with 5 feature highlights and SPACE-space confirmation
Kitty uses hide_window_decorations yes for a clean look — no more broken D-Bus wrappers
Firefox theme needs one manual launch — then it's set
Every script detects your username automatically
No machine-specific files — clone and run anywhere