---
title: Plugins
description: 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](/docs/integrations/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](https://github.com/abue-ammar/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](/docs/contributing/plugin-runtime).