Skip to content

southflowpeak/Pin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pin

Pin App Icon

Keep any window always on top on macOS


🎬 How it works

See Pin in action: southflowpeak.com/pin

✨ Features

  • 🪟 Pin Any Window - Select any window and keep it always visible on top
  • 📋 Menu Bar Control - Easily select and manage windows from the menu bar
  • 🔔 Auto Updates - Built-in automatic updates via Sparkle

📥 Installation

Download

👉 Download Pin v0.1.0

System Requirements

  • macOS 14.0 (Sonoma) or later

🔐 Screen Recording Permission

Pin requires Screen Recording permission to function.

Screen Recording Permission Dialog

On first launch, you'll see the dialog above. Click "Open System Settings" and enable Pin in the Privacy & Security settings.

Screen Recording Settings

💡 Why is Screen Recording permission required?

Pin uses macOS's ScreenCaptureKit API to keep windows on top:

  1. SCStream captures the target window's content in real-time
  2. The captured frames are displayed using AVSampleBufferDisplayLayer
  3. This layer is placed in a floating window set to NSWindow.Level.floating

This creates a "mirror window" that stays on top even when the original window is behind other windows. Since ScreenCaptureKit is used to capture window content, macOS requires Screen Recording permission.

🚀 Usage

  1. Click the 📌 icon in the menu bar
  2. Select "Pin Window..." and choose the window you want to pin
  3. To unpin, click the pin icon on the top-left of the mirror window, or select "Unpin" from the menu

📄 License

MIT License

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •