gitwtfhub

wtf is pinp?

bmilioli/pinp — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · generalComplexity · 2/5Setup · easy

TL;DR

A floating always-on-top mini browser for macOS that keeps any website visible in a corner of your screen while you work.

Mindmap

mindmap
  root((pinp))
    What it does
      Floating always-on-top browser
      Works with any URL
      Persistent login sessions
    Tech stack
      Electron
      JavaScript
      macOS
    Use cases
      Watch streams while working
      Corner snapping and resizing
      Click-through mode
    Audience
      Mac users wanting mini browser

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Keep a live video, stream, or dashboard floating on top of other apps while working.

REASON 2

Watch or interact with any website in a small always-on-top window, not just video.

REASON 3

Snap a floating browser window into a screen corner with global keyboard shortcuts.

REASON 4

Click through a floating window to the app behind it while content keeps playing.

What's in the stack?

JavaScriptElectronmacOS

How it stacks up

bmilioli/pinp00kaku/gallery-slider-block3rd-eden/ircb.io
Stars0
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-192016-11-16
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

The downloaded build is not notarized, so macOS Gatekeeper needs one terminal command to clear the quarantine flag before it will launch.

Wtf does this do

pinp is a small always on top app for macOS that lets you keep any website floating in a corner of your screen, like a tiny mini browser window, while you work in other apps. Unlike the picture in picture feature already built into Safari or Chrome, which only works with actual video elements on a page, pinp can display any URL at all, and you can still click around and interact with the page inside it, not just play and pause a video. The window has no title bar, no icon in the dock, and no visible controls until you move your mouse to the top edge, where a hidden toolbar with a URL bar and navigation buttons appears. It stays on top even over fullscreen apps and other virtual desktop spaces, without pulling you away from whatever space you are currently using. You can resize it between four preset sizes, snap it into a corner of the screen, cycle through several opacity levels so it is more or less see through, and turn on a click through mode where your mouse passes straight through the window to whatever is behind it while the page keeps playing. Your logins are remembered between restarts, including working sign in flows for services like Google that normally have stricter security checks around embedded browsers. The app also remembers its own position, size, and opacity, and checks that against your currently connected monitors so it never ends up stranded off screen if you unplug a display. To use it, you can download a ready built version for Mac, or run it yourself from the source code if you have Node.js installed. Because the downloaded build is not notarized by Apple, the first time you open it macOS will warn that it is damaged, which is a normal Gatekeeper message rather than a sign of a broken download, and clearing that warning once with a single terminal command fixes it. The project is built with Electron, has no runtime dependencies beyond Electron itself, and includes a full set of global keyboard shortcuts for resizing, snapping, and toggling the window from anywhere on the system.

Yoink these prompts

Prompt 1
Help me install pinp on macOS and fix the 'app is damaged' Gatekeeper warning.
Prompt 2
Explain how pinp's click-through mode works and how to toggle it.
Prompt 3
Show me how to build pinp from source with npm and Electron.
Prompt 4
Walk me through the global keyboard shortcuts for resizing and snapping the pinp window.

Frequently asked questions

wtf is pinp?

A floating always-on-top mini browser for macOS that keeps any website visible in a corner of your screen while you work.

What language is pinp written in?

Mainly JavaScript. The stack also includes JavaScript, Electron, macOS.

How hard is pinp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pinp for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.