AI-OS — Special Effects, Auto-Tiling & Account Polish (Builds 1.0.0.114 – 1.0.0.119)

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:
    1. 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).
    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).
    3. 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)

  1. 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().
  2. 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.
  3. 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.