AI-OS — Special Effects, Auto-Tiling & Account Polish (Builds 1.0.0.114 – 1.0.0.119)
Part 1: The Simple Version (What's New for Everyone)
In our latest release (Build 1.0.0.119), we've given the AI-OS desktop a huge visual and workflow upgrade—bringing Hyprland-style spring physics, hybrid auto-tiling, and next-gen compositor effects right into Cinnamon/Muffin without taking away any of your favorite Compiz effects (Wobbly Windows, Magic Lamp, Fire, and Desktop Cube all continue to work!).
New Special Effects & Window Management
- Buttery Spring-Loaded Animations (Enabled by Default!): Opening, closing, minimizing, restoring, and snapping windows now use smooth, physics-based spring motion (Smooth preset enabled out of the box). You can switch between Smooth, Snappy, and Bouncy anytime in Settings → Appearance → Effects.
- Hybrid Auto-Tiling (Super+Y or Quick Settings): Want windows to arrange themselves automatically side-by-side without overlapping? Turn on Auto-Tile from Quick Settings, press Super+Y, or add the new Auto-Tiling Toggle applet to your panel. Turn it off anytime to go right back to classic floating windows.
- Press Super+Shift+F to float/unfloat any individual window (like a calculator or dialog), or drag one tiled window onto another to swap their positions.
- Optional Next-Gen Compositor Effects (Off by Default — Turn On in Settings → Effects or Quick Settings):
- System-Wide Backdrop Blur: Live frosted-glass blur behind your panels, popup menus, Quick Settings, and terminal windows—with sliders for Blur strength and Frosted glass grain.
- Active Window Glow Border: Highlights your currently focused window with a crisp glowing accent border (especially awesome when Auto-Tiling!).
- Dim Inactive Windows: Gently dims background windows so the window you're working in pops immediately.
Cleaner AI Account Manager (1.0.0.114)
- Separate Stripe & Patreon Sections: Settings → AI Settings now cleanly groups account controls under Manage account via Stripe and Manage account via Patreon.
- Log in via Token: Added a dedicated Log in via Token button for Patreon Shop tokens, personal API keys, and recovery codes.
Bugs Fixed
- Desktop Startup Crash (1.0.0.117): Fixed a critical bug introduced in 1.0.0.115 that caused Cinnamon to crash right after login (leaving a black screen with no panels or window borders).
- Patreon Sign-In Sync (1.0.0.114): Fixed a Cloudflare 403 rejection during Patreon OAuth polling that falsely reported "This account is disabled or access has expired" right after a successful browser login.
- Settings Heading Display (1.0.0.118): Fixed a missing section heading above System-wide backdrop blur in Settings → Effects.
Part 2: Deep Dive for the Tech Junkies
Here is what changed under the hood in muffin/, ai-os/, and the private gateway between 1.0.0.114 and 1.0.0.119.
1. Muffin / Clutter 2-Pass Downsampled Kawase Blur Shader (muffin/clutter/clutter/clutter-backdrop-effect.c)
- Before: ClutterBackdropEffect captured a full-resolution framebuffer and ran a 49-tap (7×7) brute-force loop per pixel in a single fragment pass, capped at 1920×1200.
- Now (1.0.0.116): Upgraded to a 2-pass half-resolution Kawase downsample/upsample pipeline:
- Blits the behind-actor stage framebuffer into capture_tex, then runs a 5-tap Kawase downsample pass into a half-resolution offscreen target (down_tex, width/2 × height/2).
- Runs a 9-tap Kawase upsample pass back to the stage framebuffer with linear filtering, configurable corner radius (radius, 0–64px), blur spread (blur-strength, 0.2–3.0), and procedural frosted-glass micro-noise (grain, 0.0–0.15).
- Expanded maximum surface bounds up to 4K (4096×2560) while keeping the existing org.ai_os.Materials1 / ai-os-glass contract intact.
2. Damped Harmonic Oscillator Spring Engine (ai-os/js/ui/aiOsEffects.js)
- Added runSpring(durationMs, presetName, onStep, onDone) driven by Clutter.Timeline (new-frame tick), solving: x¨=−k(x−1)−cx˙\ddot{x} = -k(x - 1) - c\dot{x}x¨=−k(x−1)−cx˙
- Three tuned presets in org.aios.effects:
- smooth (default in 1.0.0.119): stiffness: 240, damping: 28, mass: 1
- snappy: stiffness: 420, damping: 32, mass: 1
- bouncy: stiffness: 340, damping: 18, mass: 1
- Added animateTileMove(actor, fromRect, toRect) so tiled window reflows interpolate smoothly via actor transforms (translation_x/y, scale_x/y) after move_resize_frame().
- Non-interference with Compiz effects: LampEffect (Magic Lamp), FireEffect (Burn), WobblyEffect (Wobbly Windows), and Cube (Desktop Cube) always take precedence when selected and never collide with spring transitions.
3. Hybrid Auto-Tiling Engine (ai-os/js/ui/aiOsTiling.js, org.aios.tiling)
- Layouts:
- bsp (Binary Space Partition / Dwindle): Recursively splits each remaining slot horizontally or vertically based on aspect ratio (width >= height).
- master-stack: Places the primary window on the left (master-ratio, 0.35–0.75, default 0.55) and stacks remaining windows evenly on the right.
- Stability & Ergonomics:
- Batches retile passes via GLib.idle_add with a re-entrancy lock (_applying) and a > 2px geometry-diff threshold to prevent resize feedback loops with Electron/Qt apps.
- Excludes DIALOG, MODAL_DIALOG, UTILITY, fullscreen/minimized windows, and configurable floating-classes (galculator, pavucontrol, nm-connection-editor, etc.).
- Drag-and-drop swapping on grab-op-end (Meta.GrabOp.MOVING) when dropping one tiled window onto another.
- Exposed via Super+Y (toggle), Super+Shift+F (float window), tiling@ai-os panel applet, Quick Settings Auto-Tile tile, D-Bus org.ai_os.DesktopControl (SetTiling, GetTilingState), and the ai-os-tiling agent skill.
4. System-Wide Compositing & Focus Effects (ai-os/js/ui/aiOsCompositorFx.js)
- system-blur (false default): Attaches Clutter.BackdropEffect (aios-sys-blur) to Cinnamon panels, popup menus, Quick Settings, and terminal windows (ai-os-terminal, xfce4-terminal, gnome-terminal), tearing down all effects and stopping the redraw timer immediately when toggled off.
- active-window-glow (false default): Tracks global.display notify::focus-window + position-changed / size-changed with a non-reactive St.Bin border/glow actor (glow-color, glow-width), hiding automatically during Overview, Expo, fullscreen, and minimize.
- dim-inactive (false default): Applies Clutter.BrightnessContrastEffect (aios-dim) to unfocused normal windows using dim-amount (5–40%).
5. Bug Fixes & Root Causes (1.0.0.114 – 1.0.0.118)
- Cloudflare Error 1010 on Patreon/Token Endpoints (1.0.0.114): Python's default urllib User-Agent triggered Cloudflare HTTP 403 on api.makululinux.us/auth/poll/ and /auth/token, which the gateway mapped to access_denied. Fixed by setting User-Agent: AI-OS-Gateway/1.0 in http().
- Cinnamon Startup Crash on workareas-changed (1.0.0.117): In 1.0.0.115/1.0.0.116, aiOsTiling.js connected 'workareas-changed' on Main.layoutManager (which does not emit that signal), throwing an uncaught error in main.js:start(). Moved the signal to global.display inside a try/catch and verified full cinnamon startup in an isolated Debian 13 Xvfb container before compiling .117.
- Blank Section Heading in Settings → Effects (1.0.0.118): SettingsSection parses titles with Pango markup, so "System-Wide Compositing · Kawase blur & focus" failed on the unescaped & and rendered an empty label. Changed to "System-Wide Compositing · Kawase blur and focus".
Build-by-Build Changelog (1.0.0.114 – 1.0.0.119)
- 1.0.0.114: Separate Stripe & Patreon sections in AI Settings, Log in via Token, and Cloudflare User-Agent fix.
- 1.0.0.115: Hybrid Auto-Tiling (aiOsTiling.js), damped spring physics (aiOsEffects.js), tiling@ai-os applet, and Quick Settings tiles.
- 1.0.0.116: 2-pass Kawase ClutterBackdropEffect in Muffin, System-Wide Backdrop Blur, Active Window Glow, and Inactive Window Dimming.
- 1.0.0.117: Fixed workareas-changed startup crash in aiOsTiling.js; verified full cinnamon startup in Debian 13 Xvfb.
- 1.0.0.118: Fixed Pango & heading in cs_effects.py, confirmed off-by-default toggles, and added mandatory test-before-compiling-DEBs rule.
- 1.0.0.119: Enabled spring-physics (true) and spring-tile (true) by default with the smooth preset.