Pipiri Changelog

1.5.1

Launch at Login: new toggle in Settings and in the menu bar menu to automatically start Pipiri when you log in

Scroll to pan: scroll inside a zoomed PiP window to move around the captured region
- uses natural scrolling direction so content follows your fingers on the trackpad
- hold Cmd while scrolling to zoom in and out instead, anchored at the cursor position
Multi-screen PiP placement: new PiP windows are now placed on the screen where your cursor is
- stacking still works when multiple PiPs are on the same screen

Change Detection: get a gentle notification when a change has been detected in the captured contents after a configured amount of time
- press D while hovering the PiP window to cycle between Idle and Change detection or to disable it
Detection script: run a script when an Idle or Change detection triggers
- can be useful to get notified on the phone using something like ntfy.sh
Boundary-based smart zoom: when fn-doubleclick is used, the app will adjust the zoom based on what's under the cursor
- detects rectangle objects like YouTube videos, tables, text fields etc.
- uses a default non-smart zoom if the detection is not clear enough
Configurable aspect ratio: allows setting more extreme aspect ratios for the PiP window
- in case one would want to capture very thin elements like wide progress bars

Quick Region Capture: hold fn and double-click anywhere inside a window to instantly PiP a zoomed-in area around the cursor
- double-click a different spot on an already-captured window to shift the PiP focus to that area instead
- disabled by default, enable it in Settings under Picture-in-Picture
Idle Detection: get a gentle reminder on the PiP window when the captured content hasn't changed for a while
- configurable detection threshold (2–60 s, default 5 s) in Settings
- toggle per-window detection by hovering the PiP panel and pressing D or by clicking the indicator dot in the top-right corner
- when a change is detected, click the PiP panel to jump straight to the source window
Stream quality and efficiency improvements

Fixed PiP being paused/closed when switching focus to a different window of the captured app
- pause/stop now only triggers when the captured window itself is focused

Double-tap the modifier key to toggle Auto-hide on hover
When focusing the captured window, the PiP window will automatically pause the stream and hide
Launch Pipiri with CLI arguments to instantly start a PiP (if Pipiri is already running, the request is forwarded to the existing instance)
- --app <name>: target a window by app name
- --window <title-or-id>: target a window by title (substring match) or numeric window ID
  - combine with --app to disambiguate windows with the same title across apps
- --zoom <position:factor>: zoom into a region of the captured window on start (e.g. --zoom bottom-right:6x or --zoom center:2x)
  - positions: top-left, top, top-right, left, center, right, bottom-left, bottom, bottom-right
- Example (focus the Pipiri window of the VSCode app and zoom on the Copilot chat):
  - /Applications/Pipiri.app/Contents/MacOS/Pipiri --app Code --window Pipiri --zoom bottom-left:5x

Multi-window mode: enable it if you want to create more than one PiP window
Enhance contrast: make contents with very small text more readable by increasing contrast and sharpness

Show double click to focus hint at the bottom of the window
Improve visibility of app actions text when hovering the PiP window
Turn the hotkey text field into a key picker menu, add support for numbers, symbols and Escape

Initial release