Sulguni Taskbar docs

Start, Search, Quick Settings, tray/notifications/calendar flyouts, previews, themes, and multi-display workflows.

Sulguni Taskbar docs (v4.4.90)

Sulguni Taskbar is the native desktop control layer for macOS: a Windows 11-style taskbar with a Start command hub, Double-⌘ search, Quick Settings with Audio Output Device routing, tray/notifications/calendar flyouts, 60fps ScreenCaptureKit window previews, and power-user window workflows.

For a single searchable page of all 280+ features, 16 surfaces, 45 setting keys, and 140+ Bridge API endpoints, visit the Complete Feature Inventory.

If you only read a few pages, use this order:

  1. Make it feel right: Themes & presets → Alignment & size
  2. Make it fast: Hotkeys
  3. Make it yours: Start menu → Start menu customization
  4. Make it searchable: Search → Search sources → Document search
  5. Make it practical: Quick Settings → System info in Quick Settings
  6. Make window switching reliable: Window previews → Live previews

What’s new in v4.4.90 (Build 107)

  • Always Show as Pin (Compact 40px Pins): Right-click any running app on the taskbar and enable Always Show as Pin (taskbar.compactPinBundleIds) to keep verbose apps as compact 40px icons with window count badges even in Never Combine mode.
  • Hide Specific Apps from Taskbar: Exclude background helpers or companion utilities (taskbar.excludedBundleIds) directly from the right-click context menu or Settings → Taskbar.
  • Dynamic Floating Mode & Secondary Overflow Bar: Float as a centered island on the desktop and automatically expand edge-to-edge when an app is maximized (taskbar.dynamicFloatingEnabled), or spill excess windows into an elevated secondary overflow bar (#/taskbarOverflow).
  • Live Preview Power Controls: Hovering a window card reveals Window Snap (Left 50%, Right 50%, Maximize, Center 70%) with a live desktop ghost overlay, Live Picture-in-Picture (PiP) floating clone, 1-Click Window Screenshot, Per-Window RAM Badge, and Instant Search Filter when 3+ windows are open.
  • 3-Finger Swipe Window Switcher & Scroll Gestures: Swipe 3 fingers up/down on the trackpad to open the full-screen window switcher (#/windowSwitcher) with haptic feedback and 1–9/M/Q hotkeys, or scroll directly over taskbar app pills to cycle/peek windows.
  • Spring-Loaded File Drop & Drag-to-Pin: Drag files onto any taskbar app icon for 650ms to bring its window to the front and drop directly, or drag .app bundles onto the taskbar to pin them.
  • 10 Dedicated Widget Context Menus & Quick Split-Tile: Right-click any taskbar widget (Start, Search, Weather, Media, Tray, Clock, Show Desktop) for tailored actions, or click Tile Top 2 Windows Left & Right from the taskbar background menu.
  • Airy Light, Dark & Auto Appearance: Switch all taskbar surfaces, flyouts, and context menus between Auto (Follow macOS), Light (Airy White), and Dark (Obsidian).

Panels & flyouts

Window workflow

Multi-display

Customization

Permissions & troubleshooting

AI (optional)