Skip to content
Vimputer
Esc
↑↓navigate↵open⌘Jpreview
On this page

Plugins

Bind keys to Raycast, Tinycast, Rectangle, Paseo, OBS, Shottr, and other apps' commands.

A plugin turns another app’s commands into actions you can bind. Seven ship with Vimputer and are on by default. Turn one off in Settings → Integrations → Plugins.

Using plugin commands

To bind one command, open the action picker, choose Plugins, then the plugin’s action. Actions that run a discovered command, such as Raycast command, open a search of everything the plugin found.

To fill a layer, use Add from plugin on the layer page. It adds a group of commands as ordinary bindings on free keys, which you can then rebind, delete, or mix with bindings from other plugins. When the plugin finds new commands later, the group shows +N; pick it again to add only the new ones.

Importing a karabiner.json turns commands a plugin recognizes back into its actions, so open "raycast://…" in a shell command becomes a Raycast action. See Karabiner.

Raycast

Runs Raycast commands through their deeplinks: every installed extension (one group each), your script commands, and Raycast’s built-in commands such as Window Management and System. Commands that show no window run in the background. No setup.

To run extensions in Tinycast instead, open Raycast in Settings → Integrations and choose Tinycast under Open extensions with. Existing bindings switch over; nothing needs rebinding.

  • Tinycast must have the extensions installed. In Tinycast, use Settings → Extensions → Import from Raycast.
  • Raycast’s built-in commands (AI Chat, Window Management, Clipboard History) and script commands still open in Raycast, and are listed while Raycast is installed.

Paseo

Puts Paseo coding agents on keys. Open the agent that needs you next (press again for the one after), reply, archive, start an agent, or start and stop a project’s paseo.json scripts. Your saved replies and starters become groups too.

Paseo must be installed. Its page in Settings → Integrations adds remote hosts and edits replies and starters.

T3 Code

Puts T3 Code threads on keys. Open the thread that needs you next (press again for the one after), open the latest thread, reply, settle, stop the latest running thread, or start a thread in a project. A thread needs you when it is waiting on an answer or approval, failed, or finished and not yet settled; snoozed threads wait. Saved replies and starters work as they do for Paseo.

To sign in:

  1. In Settings → Integrations, open T3 Code and choose Sign in.
  2. T3 Code’s approval page opens in your browser. Enter a pairing code from T3 Code’s Settings → Connections, or from t3 auth pairing create.
  3. Choose Supervised. Read only is enough to open threads, but replying, settling, stopping and starting need Supervised or higher.

The sign-in lasts 30 days. Revoke it in T3 Code under Settings → Connections. Vimputer reaches the T3 Code on this Mac; it checks for changes every 3 seconds.

OBS

Controls OBS Studio: record, pause, add a chapter (Hybrid MP4 only), switch scene or scene collection, mute an input, save the replay buffer. Scenes and inputs are read live from OBS.

Turn on the WebSocket server in OBS under Tools → WebSocket Server Settings. Vimputer reads its port and password from OBS’s own config, so there is nothing to enter.

Shottr

Takes screenshots with Shottr: full screen, area, window, scrolling, delayed, OCR, and more, each with what happens after (copy, save, edit, pin, or thumbnail). It offers 13 ready-made presets when Shottr is in Applications. No setup.

Rectangle

Moves and resizes the focused window with Rectangle: halves, corners, thirds, maximize, center, restore, other displays, and every other Rectangle action. Its groups appear when Rectangle is in Applications. Keys call Rectangle directly, so they work even when Vimputer is closed. No setup.

Soundboard

Plays sound clips from boards you build on its page in Settings → Integrations. Drop audio files onto a board to add them. Each board becomes a group.

Shortcuts

Runs any shortcut from Apple’s Shortcuts app, with optional text input. No setup.

BetterTouchTool

Fires BetterTouchTool Named Triggers. It needs BetterTouchTool’s webserver port and shared secret, and there is no screen to enter them yet, so for now it finds nothing.

Not built yet

AeroSpace, Spotify, and superwhisper plugins are planned. Until then, bind their command-line tools with a shell action.

To write a plugin, see Plugin runtime.