Warning

THIS VERSION IS NO LONGER MAINTAINED. NEW VERSIONS ARE AT floatpane/floatpane

floatpane

A lightweight, floating wallpaper selector for macOS.

---

floatpane is a minimal utility for macOS that lets you quickly browse and set your desktop wallpaper. It's designed to be invoked with a global keyboard shortcut and floats above all other windows, making it compatible with tiling window managers like Aerospace and yabai.

🎬 Demo

✨ Features

• ⚡ Summon: Bring up the wallpaper grid from anywhere with Cmd+Shift+P.
• 🖼️ Floating Window: Floats on top of all other applications for easy access.
• 🧩 Tiling WM Friendly: Integrates smoothly with Aerospace, yabai, and Amethyst.
• ⌨️ Keyboard Navigation: Use arrow keys to browse, Enter to apply, and Esc to dismiss.
• 🚀 Lazy Loading: Thumbnails load as you scroll for a fast, responsive experience.
• ✅ Current Wallpaper Indicator: Your active wallpaper is always highlighted.
• 🎨 Themes: Customize the look and feel with multiple built-in themes.

📋 Requirements

• macOS
• A ~/wallpapers directory containing your images.

🚀 Installation

Homebrew (Recommended)

brew tap floatpane/floatpane
brew install floatpane

Builds (DMG's) are also available here.

Warning

The Builds are not signed with an Apple Developer ID. You need to run xattr -cr /Applications/floatpane.app after downloading and before opening it for the first time.

For Developers

1. Clone the repository:

   git clone https://github.com/floatpane/floatpane.git
   cd floatpane

2. Install dependencies:

   npm install

3. Run in development mode:

   You'll need two terminal windows for this.

   • In Terminal 1, start the webpack watcher:

     npm run watch

   • In Terminal 2, start the Electron app:

     npm start

🌅 Wallpapers

You can find all the wallpapers I use by going to andrinoff/wallpapers

OR

curl -sS https://andrinoff.com/wallpapers/download.sh | sh

🎨 Available Themes

Floatpane includes a variety of themes to match your style. You can change the theme in the settings (Cmd+,, or by clicking the gear icon).

• Aura
• Ayu Dark
• Cobalt2
• Dracula
• Gruvbox Dark
• Material Theme
• Monokai
• Night Owl
• Nord
• One Dark Pro
• Panda Syntax
• Solarized Dark
• Synthwave '84
• Tokyo Night Blue

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.