SnaprSnapr/Guide

Plugins (Post Process)

Plugins let you run tools from a local repository after a capture. You can choose an action from the floating preview or open the plugin sheet automatically after every capture.

Register a Plugin#

  1. Download or clone a plugin repository to a permanent location.
  2. Open Settings → Plugins.
  3. Click Register Plugin and select the repository folder.
  4. Complete any setup described by the plugin. Each plugin owns its runtime and dependencies; Snapr does not rely on your system PATH when it runs the plugin.

Start with the Snapr example plugin.

Run an Action#

  • From the floating preview, open More actions → Post Process.
  • Press Command/Ctrl + P while the floating preview is active.
  • To open the sheet after every capture, choose Open plugin actions under Settings → Capture → After capture completes.

Only actions compatible with the current capture appear. When an action creates a file, Snapr lets you copy its path or reveal it in the file browser.

Manage Plugins#

Use the switch in Settings → Plugins to enable or disable a plugin. Use Reload after changing its manifest or actions, and unregister it when you no longer want Snapr to use that repository.

Trust and Security#

Plugins run local code with your user permissions and are not sandboxed. Register only repositories you trust, and review their setup instructions and source before running them.