Skip to Content
FeaturesFloating Button

Floating Button

A persistent, draggable button that floats above all windows for one-click sidebar access - perfect for mouse-driven workflows.

How It Works


Floating Button

The Floating Button is a small, semi-transparent button that stays visible above all other windows. Click it once to toggle the sidebar - no keyboard needed.

Persistent & Draggable

Always Visible:

  • Floats above all applications
  • Visible across all desktop spaces
  • Never gets hidden behind windows
  • Small enough not to obstruct work

Fully Draggable:

  • Drag to any position on screen
  • Position persists across app restarts
  • Move to corners, edges, or anywhere you prefer
  • Works across multiple displays

Watch this video:

Floating Button Drag

Setup

Enable Floating Button

  1. Open Preferences → General
  2. Enable Show floating button
  3. Button appears immediately

Floating Button Toggle

No Permissions Required

The floating button works without any special permissions - just toggle it on and it appears.

Using the Floating Button

Toggle Sidebar

Single Click:

  • Sidebar hidden → Click button → Sidebar appears
  • Sidebar visible → Click button → Sidebar hides

Simple, predictable toggle behavior.

Watch this video:

Floating Button Open

Combining Access Methods

Hybrid Workflows

Use the floating button alongside other access methods:

Mouse + Keyboard:

  • Click button when hand is on mouse
  • Press ⌘⇧Space when typing
  • Best of both worlds

Mouse Triggers + Button:

  • Edge triggers for quick access while browsing
  • Floating button for precision when needed
  • Multiple options for different contexts

Button + Command Panel:

  • Click button to show sidebar
  • Press ⌘⌃K for focused search
  • Different tasks, different tools

Troubleshooting

Button not appearing?

  • Verify “Show floating button” is enabled in Preferences
  • Try toggling off and on again
  • Restart SupaSidebar

Button in wrong position?

  • Drag button to desired location
  • Position is saved automatically
  • Check button isn’t hidden off-screen edge

Button too small/hard to click?

  • Unfortunately, button size is not customizable
  • Use keyboard shortcuts or mouse triggers instead
  • Submit feedback for larger button option

Button blocking content?

  • Drag to different position
  • Use semi-transparent appearance (automatic)
  • Consider disabling and using keyboard shortcuts

Button disappeared after display change?

  • Button may be positioned off-screen
  • Disable and re-enable floating button
  • It will reappear at default position

Multiple displays showing duplicate buttons?

  • This shouldn’t happen - only one button appears
  • Report bug to support if you see duplicates

Performance

Minimal Impact

The floating button is lightweight:

  • Minimal CPU usage (event-driven, not polling)
  • Small memory footprint
  • No impact on battery life
  • Efficient rendering

Always-On-Top

The button uses macOS floating window level:

  • Stays above all applications
  • Never gets hidden behind other windows
  • Respects macOS window management

Accessibility

Click Target Size

The floating button provides a reasonable click target for:

  • Mouse users
  • Trackpad users
  • Stylus/pen input
  • Touch input (on supported hardware)

Keyboard Alternative

For users who can’t use mouse:

  • All floating button functionality available via keyboard
  • ⌘⇧Space provides same toggle behavior
  • Full keyboard accessibility maintained

VoiceOver Support

Screen reader users can:

  • Access floating button with VoiceOver
  • Hear button label
  • Activate with VoiceOver commands
Last updated on
Finder IntegrationGlobal Shortcuts