Ribbon
How it worksPricingShortcutsGuidesFAQsChangelog
Download
Ribbon

A scrolling window manager for Mac. Windows sit on one strip: scroll instead of shrinking.

Support: support@meetribbon.app

PricingDownloadShortcutsGuidesChangelogLicensePrivacyTermsRefunds

© 2026 Ribbon · macOS 14+

Guides

Ribbon troubleshooting for macOS

Accessibility, Stage Manager conflicts, unmanaged apps, wake jumps, gestures, and engine restarts.

TL;DR. Most issues are Accessibility off, Stage Manager on, another window manager still running, or an app that refuses resize. Fix those first. Full-screen Spaces and sheets stay outside the strip on purpose.

Direct answer

If the strip misbehaves, check permissions and conflicts before assuming a bug. Ribbon only moves windows it is allowed to manage, and only while Stage Manager and other managers are not also steering frames.

Quick checks

  1. System Settings → Privacy & Security → Accessibility: Ribbon is enabled.
  2. Stage Manager is off (why).
  3. Quit Rectangle, Magnet, Spectacle, and similar tools.
  4. “Displays have separate Spaces” is on (multi-display).
  5. Restart Ribbon from the menu bar.

Walk the checklist on Mac Setup.

Common symptoms

SymptomWhat to do
Window will not resizeApp may be fixed-width. Ribbon lists it under Apps as cannot be managed after two failures.
Strip jumps on wakeDisplays flicker after sleep. Ribbon waits and rebuilds.
Full-screen apps ignoredFull-screen Spaces stay alone. Exit full screen to join the strip.
Sheets and dialogs floatSave panels stay above the strip on purpose.
Three-finger swipe does nothingDefault Finger swipe is 3. Turn off macOS full-screen swipe and Three Finger Drag, or use Option + two fingers with Finger swipe Off.
Engine stoppedMenu bar app restarts it. If it stops twice, check the ribbon CLI and engine log.
License will not unlockPaste the purchase key in Settings → License.

Next

  • Setup
  • Shortcuts
  • Download again if the app never launches

FAQs

Short answers for this guide. Setup and license links if you need the next step.

Can’t find what you’re looking for? See the Mac Setup page or write from the app’s About screen.

No. If something asked you to disable SIP, that was another tool.

Does Ribbon change SIP?
No. If something asked you to disable SIP, that was another tool.
Why did my layout vanish after quit?
Quit restores prior frames by design. Start Ribbon again to rebuild the strip from open windows.
Can two managers share the desktop?
Not reliably. Pick one.

Can’t find what you’re looking for? See the Mac Setup page.

All guides