A macOS-native recreation inspired by end4-pC / illogical-impulse, redesigned for macOS using modern desktop architecture.
End4-mac brings the iconic end4-pC / illogical-impulse desktop rice experience to macOS — featuring a full Live Wallpaper Engine, Material 3 Expressive Widgets, Interactive Shaders, Spotlight App Launcher, Synchronized LRCLIB Lyrics, and Dynamic Material You Theming.
┌─────────────────────────────────────────────────────────────────────────────┐
│ FLOATING STATUS BAR │
│ [Workspaces] [12:45 PM | 33°C] [Media | 85% | Wi-Fi] │
└─────────────────────────────────────────────────────────────────────────────┘
┌───────────────────────┐ ┌─────────────────────┐ ┌─────────────────────────┐
│ LEFT QUICK-PANEL │ │ COOKIE CLOCK │ │ RIGHT MEDIA & AI │
│ • Wi-Fi / Bluetooth │ │ │ │ • Now Playing Card │
│ • DND / Night Shift │ │ (M3 7-Scallop) │ │ • Synchronized Lyrics │
│ • 120fps Sliders │ │ Analog + Date │ │ • AI Assistant (Chat) │
│ • 5-Day Weather │ │ │ │ • CPU / RAM Live Gauge │
└───────────────────────┘ └─────────────────────┘ └─────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ LIVE WALLPAPER & SHADER ENGINE │
│ [Aurora Borealis] [Fluid Waves] [Cosmic Stars] [Retro Grid] │
└─────────────────────────────────────────────────────────────────────────────┘
- Interactive Canvas Shaders:
- 🌌 Aurora Borealis: Fluid, multi-point organic mesh gradients with smooth particle drifts.
- 🌊 Fluid Waves: Flowing multi-layer harmonic sine wave ribbons.
- ✨ Cosmic Stars: Deep space starfield with realistic twinkling stars and glowing nebulae.
- 🌆 Retro Grid: 80s Cyberpunk horizon sunset with perspective vanishing rays.
- Online Wallpaper Search (Wallhaven API):
- Integrated online search directly querying Wallhaven's repository with categories (General, Anime, People).
- Material 3 Centered Shape Cutouts:
- Procedural bezier-curve scallop shapes (Cookie 7, 9, 12, 16-sided, Flower, 4-Leaf Clover) with customizable opacity, tint, and optional continuous rotation.
- Filters & Video:
- Real-time blur (0–40px) and dimming (0–80%) sliders.
- HTML5 looping video wallpaper support.
- Cookie Analog Clock: Signature Android 12/14/M3 expressive scallop analog clock with continuous rotating hour/minute/second hands and date indicator pill.
- Bold Typography Digital Clock: Large Material display typography with date and live weather conditions.
- Audio Reactive Visualizer: Real-time frequency bar animation reacting to current media playback state.
- Desktop Weather Card: Live temperature, apparent temperature, humidity, and wind speed from Open-Meteo.
- System Resource Radial Meters: Live animated SVG circular meters for CPU and RAM consumption.
- One-click modal to switch between Presets, Online Wallhaven Wallpapers, Live Shaders, M3 Shape cutouts, and Desktop Widgets.
- Dynamic Material You Auto-Theming: Extracts dominant color palettes from any chosen wallpaper in real-time and applies tonal variations across the entire UI.
- Floating Pill Status Bar: Top center glassmorphic pill with virtual desktop indicators, live clock, weather snippet, volume, Wi-Fi, battery, and media marquee.
- Left Quick-Settings Sidebar (
⌘ + A):- Real macOS system toggles for Wi-Fi, Bluetooth, Do Not Disturb, and Night Shift.
- Zero-latency 120fps sliders for Display Brightness and System Volume with dynamic gradient track fills.
- Interactive month calendar with today highlights.
- Right Sidebar (
⌘ + N):- Now Playing Card: Album art, title, artist, progress scrubber, and playback controls (Spotify & Apple Music).
- Synchronized LRCLIB Lyrics: Real-time time-synced scrolling lyrics matching audio playback.
- Notes & Tasks Widget: Persistent quick notes saved via localStorage.
- AI Assistant Tab: Chat interface compatible with local Ollama (
llama3) and Google Gemini.
- Spotlight App Launcher (
⌘ + Space):- Real-time fuzzy search across
/Applicationsand/System/Applications. - Inline calculator with instant math evaluation (
= 42 * 8). - Quick system actions: Theme toggle, screenshot, lock screen, and web search fallback.
- Real-time fuzzy search across
| Shortcut | Action |
|---|---|
| ⌘ + Space | Open Spotlight App Launcher & Calculator |
| ⌘ + , (or Click Clock) | Open Wallpaper Engine Customizer & Widget Settings |
| ⌘ + A | Open Left Quick-Settings Sidebar |
| ⌘ + N | Open Right Media & AI Assistant Sidebar |
| Esc | Dismiss any open modal, sidebar, or launcher |
End4-mac/
├── electron/ # Native macOS Main Process (Node.js/CJS)
│ ├── main.cjs # Window creation, tray, global shortcuts, IPC
│ ├── preload.cjs # Secure ContextBridge API exposure
│ └── services/ # Native macOS service backends
│ ├── audio.cjs # Volume & mute control via osascript
│ ├── battery.cjs # Battery percentage & charging via pmset
│ ├── brightness.cjs # Display backlight control
│ ├── media.cjs # Apple Music & Spotify playback bridge
│ ├── network.cjs # Wi-Fi SSID, RSSI, and IP via airport/networksetup
│ ├── system.cjs # CPU, RAM, and Application directory scanning
│ └── toggles.cjs # Native Wi-Fi, Bluetooth, DND, and Night Shift hooks
├── src/ # Renderer Process (React 19 + Vite)
│ ├── App.jsx # Main shell coordinator
│ ├── main.jsx # React entry point
│ ├── assets/ # Local offline fonts, custom icons & wallpapers
│ ├── hooks/
│ │ └── useSystemData.js # Polling & optimistic hooks for system telemetry
│ ├── modules/
│ │ ├── bar/ # Floating status bar pill
│ │ ├── desktopWidgets/ # Cookie clock, digital clock, visualizer, weather, meters
│ │ ├── overlay/ # Spotlight app launcher & calculator
│ │ ├── sidebarLeft/ # Quick toggles, 120fps sliders, calendar
│ │ ├── sidebarRight/ # Media card, synced lyrics, notes, AI chat
│ │ ├── wallpaperEngine/ # Shaders, centered shapes, background manager
│ │ └── wallpaperSelector/ # Wallpaper & widget customizer modal
│ ├── services/ # Frontend API services
│ │ ├── AiService.js # Ollama & Gemini assistant integration
│ │ ├── LyricsService.js # LRCLIB synchronized lyrics client
│ │ └── OnlineWallpapersService.js# Wallhaven API client
│ ├── styles/
│ │ ├── design-tokens.css # 190+ Material 3 CSS custom properties
│ │ └── globals.css # Reset, typography, glassmorphism utilities
│ └── theme/
│ └── MaterialTheme.jsx # Dynamic HCT/M3 tonal palette extractor
├── index.html # Application HTML shell
├── package.json # Project dependencies & build scripts
└── vite.config.js # Vite bundler configuration
- macOS 12.0 (Monterey) or later (Apple Silicon & Intel supported)
- Node.js (v18 or newer)
- npm / yarn / pnpm
-
Clone the repository:
git clone https://github.com/satiricalguru/End4-mac.git cd End4-mac -
Install dependencies:
npm install
-
Run the application:
# Launch as native macOS desktop app npm start -
Run in development mode (with Vite Hot Module Replacement):
npm run electron:dev
-
Build for production:
npm run build
End4-mac implements the Material 3 Expressive Design System:
- Dynamic Palette Extraction: Change your wallpaper in the customizer (
⌘ + ,), and the application will extract the dominant tones to generate primary, secondary, tertiary, and container colors dynamically. - Glassmorphism: Uses
-webkit-backdrop-filter: blur(40px)with tailored opacity layers (--glass-bg,--glass-border). - Offline Font Support: Includes
MaterialSymbolsRounded.ttfbundled locally for fast, reliable icon rendering without internet connectivity.
This macOS port builds upon the foundation and creative work of the developers and contributors of the upstream end4-pC repository and illogical-impulse. Sincere gratitude to all contributors for their widgets, designs, and ideas!
- Jatin Pandey (@satiricalguru) — macOS native port architecture, Electron main process, React 19 modules, and shaders.
- pctrade & end4-pC contributors for the upstream desktop rice.
- end-4 for the original Linux illogical-impulse / dots-hyprland.
- LRCLIB for the open-source synchronized lyrics database.
- Wallhaven for high-resolution desktop wallpapers.
- Open-Meteo for free weather forecasts.
This project is open-source software licensed under the MIT License.