PerritoDeck

Plugins

Plugins add things keys can do and values their titles can show. Add them in PerritoDeck from Plugins → Look online, or download one here, unzip it and use Install from folder. They're free and open source (MIT), and they run on your computer with your permissions.

Experimental plugins have only been tested against stand-ins for the service or device they work with, or have known problems with the real one, so they may not work as described yet.

Audio devices 1.0.1

Mute the microphone, change the volume, switch speakers and headsets, and set the volume of one app. Works on Windows, macOS and Linux.

Keys can

  • Mute the microphone
  • Mute the sound
  • Volume up
  • Volume down
  • Volume
  • Switch speakers or headphones
  • Switch microphone
  • Volume of an app
  • and 1 more

Titles can show

  • Microphone muted (on/off)
  • Sound muted (on/off)
  • Volume (0–100)
  • Speakers or headphones in use
  • Microphone in use
  • Volume of an app (0–100) (per app)

Download (72 KB) · needs Python 3
SHA-256 09c8e35934987a64ec4897a51d6b079c09280848d9ecfb6670e30b8bbe1e847e

Clipboard snippets 1.0.1

Paste a saved piece of text with one press, and keep numbered slots you can save the clipboard into and paste back later.

Keys can

  • Paste text
  • Copy text
  • Save the clipboard to a slot
  • Paste a slot
  • Copy a slot

Titles can show

  • What's in a slot (first 20 characters) (per slot number)

Download (51 KB) · needs Python 3
SHA-256 ea359369c3564459e18ac7c0e9aa48c60fc1ee009aacb26ea88e4745972baac1

Clocks 1.0.1

The time and date here or anywhere in the world, countdowns, days until a date and the week number.

Titles can show

  • Time (here, or in a time zone) (per time zone, e.g. asia/tokyo or utc+5:30)
  • Date (here, or in a time zone) (per time zone, e.g. america/new_york)
  • Week number (per time zone, e.g. europe/berlin)
  • Countdown to a date and time (e.g. 12d 4h) (per date and time, e.g. 2026-12-24t18:00)
  • Days until a date (per date, e.g. 2026-12-24, or 12-24 for every year)

Download (32 KB) · needs Python 3
SHA-256 c13f91b8ac505f9ad8944c020efebf60cdb367218523b8d8f8b2c9f140bb4474

Counters 1.0.1

Count things with a key press: deaths on stream, laps, cups of coffee. Counts are kept, and can be written to a text file for OBS.

Keys can

  • Count up
  • Count down
  • Reset to zero
  • Set to a number

Titles can show

  • Count (per counter name)

Download (29 KB) · needs Python 3
SHA-256 a1a71494cc0d594a5df04e2bb38e771c8a1fa4857890ed2ddd5ad03f81f5cf0e

Elgato Key Light 1.0.1 Experimental

Turn lights for Elgato Key Light, Key Light Air and Ring Light on and off, and set their brightness and shade of white, over your network.

Tested against stand-in lights, not yet with a real Key Light or Light Strip.

Keys can

  • Turn a light on or off
  • Set the brightness
  • Brighter
  • Dimmer
  • Set the shade of white
  • Warmer white
  • Cooler white

Titles can show

  • On or off (per light)
  • Brightness (0–100) (per light)
  • Shade of white (e.g. 4700 K) (per light)

Download (38 KB) · needs Python 3
SHA-256 23c09abb37d5f316e63a89957f1b38e4216d3dc013b41b80cdca729d9a287de8

GitLab 1.0.1 Experimental

Run, retry and watch GitLab CI/CD pipelines; count open merge requests and issues. Works with gitlab.com and your own GitLab.

Tested against a stand-in for the GitLab API, not yet with a real GitLab.

Keys can

  • Run a pipeline
  • Retry the last failed pipeline
  • Cancel running pipelines
  • Open the latest pipeline

Titles can show

  • Latest pipeline status (per project)
  • Latest pipeline passed (on/off) (per project)
  • A pipeline is running (on/off) (per project)
  • Open merge requests (per project)
  • Open issues (per project)

Download (41 KB) · needs Python 3
SHA-256 026fd9b305dbd02ce2a0c425cb909e490ca268a09b69c9dd1bfcdf20be758214

HTTP requests 1.1.1 Experimental

Call a web address when a key is pressed or a slider moves: webhooks, REST APIs, smart plugs.

Tested against a test server on the same computer, not yet with real web services.

Keys can

  • Send a request
  • Send the slider's value

Titles can show

  • Status of the last request

Download (24 KB) · needs Python 3
SHA-256 fd36e9fd4b854cd7646d3aac49083b57ae912c71846bcbab1269ef5eaa9e7a4b

Is it up? 1.0.1 Experimental

Shows whether your servers and web services answer: a web address, a host and port, or just a host name.

Tested against test servers on the same computer, not yet with real websites and hosts.

Keys can

  • Check now

Titles can show

  • Is up (on/off) (per web address, host:port or host)
  • Response time (per web address, host:port or host)
  • Status (up, down or the web answer code) (per web address, host:port or host)

Download (30 KB) · needs Python 3
SHA-256 06261a30d1c25a8c2101c5585f06812a0103131fd43516ee2774894e74eb0c65

MQTT 1.1.1 Experimental

Publish an MQTT message when a key is pressed or a slider moves (Mosquitto, Zigbee2MQTT, Tasmota, Home Assistant).

Tested against a stand-in MQTT broker, not yet with a real one such as Mosquitto.

Keys can

  • Publish a message
  • Publish the slider's value

Download (25 KB) · needs Python 3
SHA-256 6ee9608327bd3c6f242ba4271fd9367955977945e2bcaaebf839942b81aeae6d

Now playing 1.1.1

Show what's playing (Spotify, Music, a browser or another media player) and play, pause or skip it. Works on Windows, macOS and Linux. On Linux it needs playerctl.

Keys can

  • Play or pause
  • Next track
  • Previous track

Titles can show

  • Artist and title
  • Playing or paused

Download (36 KB) · needs Python 3
SHA-256 d4c5a227a9cce51b2ebb5bd5e8c9d231039c8fa03da2a066228dfdaa7a4616ac

OBS Studio 1.0.3

Control OBS Studio 28 or newer: scenes, streaming, recording, audio, sources, filters, screenshots and more, with live status on your keys.

Keys can

  • Switch scene
  • Studio Mode on or off
  • Transition now (Studio Mode)
  • Choose the transition
  • Streaming
  • Recording
  • Split the recording into a new file
  • Add a chapter marker to the recording
  • and 18 more

Titles can show

  • Connected to OBS (on/off)
  • Live scene
  • Preview scene (Studio Mode)
  • Studio Mode (on/off)
  • Streaming (on/off)
  • Recording (on/off)
  • Recording paused (on/off)
  • Replay buffer running (on/off)
  • and 22 more

Download (131 KB) · needs Python 3
SHA-256 62eae5acecfae1938d8a03cdf53b6a343ef91636afc23115f6dc3857ee01c8ce

Ollama 1.0.1 Experimental

Load, unload and pull local AI models in Ollama, and ask one a question from a key.

Tested against a stand-in for Ollama, not yet with a real Ollama.

Keys can

  • Load a model
  • Unload a model
  • Unload all models
  • Download a model
  • Ask a question

Titles can show

  • Loaded models
  • Number of loaded models
  • Graphics memory used by models (GB)
  • Model is loaded (on/off) (per model)
  • Last answer (shortened)
  • Download progress

Download (38 KB) · needs Python 3
SHA-256 37d8ca96da9c23fc4ec7e3d4109967a8b7122680a5dee00a76ff80b2fecfd764

Philips Hue 1.0.2 Experimental

Turn Hue lights and rooms on and off, dim them, change their colour and start scenes, through the Hue Bridge on your network.

Tested against a stand-in for a Hue Bridge, not yet with real Hue lights.

Keys can

  • Pair with the bridge
  • Turn a light or room on or off
  • Set the brightness
  • Brighter
  • Dimmer
  • Set a colour
  • Set a shade of white
  • Start a scene

Titles can show

  • On or off (per light or room)
  • Brightness (0–100) (per light or room)

Download (47 KB) · needs Python 3
SHA-256 b472b6f5eabdb1f8c6c9a060a931213addfe23c4cfadc5f9e2a85913a330efa2

Proxmox VE 1.0.1 Experimental

Start, shut down and watch Proxmox virtual machines and containers.

Tested against a stand-in for the Proxmox VE API, not yet with a real server.

Keys can

  • Start
  • Shut down
  • Stop (pull the plug)
  • Restart
  • Pause a VM
  • Resume a paused VM
  • Start or shut down
  • Take a snapshot

Titles can show

  • Guest status (running, stopped, paused) (per vm or container id)
  • Guest is running (on/off) (per vm or container id)
  • Guest CPU use (%) (per vm or container id)
  • Guest memory use (%) (per vm or container id)
  • Guest uptime (per vm or container id)
  • Guest name (per vm or container id)
  • Node CPU use (%) (per node name)
  • Node memory use (%) (per node name)
  • and 2 more

Download (43 KB) · needs Python 3
SHA-256 8b90043350e878b25899a0420a5c27ade211f6d30e5616148025a1475a97e019

Screenshot 1.0.1

Take a screenshot of the whole screen, an area you pick or the window in front, save it with the date and time in its name, and copy it to the clipboard if you like.

Keys can

  • Take a screenshot
  • Open the screenshot folder

Titles can show

  • Last screenshot (file name)

Download (47 KB) · needs Python 3
SHA-256 3661fa1dc6cd5942093d4a00a2c91b5712c553e976356fe7ad4d03a7145c6f28

Soundboard 1.0.1

Play sound files (WAV, MP3 and more) from a key, and stop them again. Uses the players your computer already has.

Keys can

  • Play a sound
  • Stop all sounds

Titles can show

  • Is playing (on/off) (per sound file)

Download (43 KB) · needs Python 3
SHA-256 c015d32a4181cf9882d6315aff8e9c93212cbf83df8c602fa4e8591124bae7c6

Spotify 1.0.2 Experimental

Play, pause, skip, like and change the volume in Spotify on any of your devices, and show what's playing. Uses your Spotify account; controlling playback needs Spotify Premium.

Tested against a stand-in for Spotify, not yet with the real Spotify service.

Keys can

  • Sign in to Spotify
  • Sign out of Spotify
  • Play or pause
  • Next track
  • Previous track
  • Shuffle
  • Repeat
  • Spotify volume
  • and 6 more

Titles can show

  • Track
  • Artist
  • Album
  • Playing (on/off)
  • Shuffle (on/off)
  • Repeat (off/all/one)
  • Track is liked (on/off)
  • Volume (0–100)
  • and 2 more

Download (59 KB) · needs Python 3
SHA-256 206a79eabad8978f0e6e11bb13d301f0d582e18830bb3046a7ad490ba9356f2a

System monitor 1.0.1

Shows CPU, memory, disk, network, GPU, temperatures, uptime and battery on keys and sliders, updated every 2 seconds.

Keys can

  • Open the system monitor

Titles can show

  • CPU in use (%)
  • Memory in use (%)
  • Memory in use (e.g. 11.2 GB)
  • Disk full (%) (per drive or folder)
  • Download speed (e.g. 1.4 MB/s)
  • Upload speed
  • GPU in use (%, NVIDIA)
  • GPU temperature (°C, NVIDIA)
  • and 4 more

Download (53 KB) · needs Python 3
SHA-256 2e91b82ce58c41fe9098fda861c4ebc1a5680719e757147ab1e902ad616a104b

Timers 1.0.1

Countdown timers, stopwatches and a Pomodoro timer on your keys. They keep going if the app restarts.

Keys can

  • Start a countdown
  • Start or pause a countdown
  • Pause a countdown
  • Reset a countdown
  • Add or take away time
  • Start or stop a stopwatch
  • Stopwatch lap
  • Reset a stopwatch
  • and 3 more

Titles can show

  • Time left (per timer name)
  • Timer or stopwatch is running (on/off) (per timer name)
  • Timer has finished (on/off) (per timer name)
  • How far the timer is, 0 to 100 (per timer name)
  • Stopwatch time (per stopwatch name)
  • Last lap time (per stopwatch name)
  • Pomodoro: work or break
  • Pomodoro: time left
  • and 3 more

Download (45 KB) · needs Python 3
SHA-256 f6c7316572bf3f8137334fbfad8af092204d24fefb0212b51b6d39cfa834b09e

TrueNAS 1.0.1 Experimental

Watch TrueNAS pools, alerts and apps, start and stop apps, and run scrubs and backup tasks.

Tested against a stand-in for the TrueNAS API, not yet with a real TrueNAS.

Keys can

  • Start an app
  • Stop an app
  • Restart an app
  • Start or stop an app
  • Scrub a pool
  • Dismiss all alerts
  • Run a backup task

Titles can show

  • Pool health (ONLINE, DEGRADED…) (per pool name)
  • Pool is healthy (on/off) (per pool name)
  • Pool space used (%) (per pool name)
  • Active alerts
  • Worst alert level
  • App state (running, stopped…) (per app name)
  • App is running (on/off) (per app name)
  • CPU use (%)
  • and 1 more

Download (58 KB) · needs Python 3
SHA-256 89c67c3fbd3ef6d9a3681cccb5a0c7e704940fb5926cf6d7c208900aa12dbaeb

Twitch 1.1.4 Experimental

Run your Twitch stream: markers, ads, clips, chat, title and category, moderation, raids, channel points, polls and predictions; show live status, viewers, followers, subs, the latest events and more.

Tested against stand-ins for Twitch's sign-in, API and live events, not yet with real Twitch.

Keys can

  • Sign in to Twitch
  • Sign out of Twitch
  • Add a stream marker
  • Make a clip
  • Open the last clip
  • Set the stream title or category
  • Use a stream preset
  • Stream tags
  • and 29 more

Titles can show

  • Live (on/off) (per channel name, or me)
  • Viewers (per channel name, or me)
  • Time live (per channel name, or me)
  • Stream title (per channel name, or me)
  • Category (per channel name, or me)
  • Tags (per channel name, or me)
  • Followers (per channel name, or me)
  • Subscribers (your channel) (per channel name, or me)
  • and 26 more

Download (169 KB) · needs Python 3
SHA-256 ec5bc1078f9dded0f8aa36d9eeb7b1c9e80d29052cdd0759f88f45f19cf4ce1a

Wake-on-LAN 1.0.1 Experimental

Switch on a computer or server on your network with a key press. Wake-on-LAN must be turned on in its BIOS or network settings.

Tested by catching the wake-up packet on the same computer, not yet by waking a real one.

Keys can

  • Wake a computer

Download (25 KB) · needs Python 3
SHA-256 82f1c21813857f82597a62b32db788ddc03ec4152235fb0512679d3c0613acec

Weather 1.0.1 Experimental

Current weather and today's forecast for any place, from Open-Meteo. Free, no account needed.

Tested against a stand-in for Open-Meteo, not yet with the live service.

Keys can

  • Refresh the weather

Titles can show

  • Temperature (per place or latitude,longitude)
  • Feels like (per place or latitude,longitude)
  • Conditions (e.g. Light rain) (per place or latitude,longitude)
  • Weather icon (per place or latitude,longitude)
  • Humidity (per place or latitude,longitude)
  • Wind speed (per place or latitude,longitude)
  • Today's high (per place or latitude,longitude)
  • Today's low (per place or latitude,longitude)
  • and 1 more

Download (34 KB) · needs Python 3
SHA-256 edb3dc570b40b8e8add0a3cc98bdebc622d71c25464cd45698322ad06c527b51

Windows and apps 1.0.1

Switch to an app (or open it), minimize, maximize, close or quit it, show the desktop, and show which app is in front. Windows, macOS and Linux (X11, Sway, Hyprland).

Keys can

  • Switch to an app
  • Minimize, maximize or close a window
  • Quit an app
  • Show the desktop

Titles can show

  • Is the app running (on/off) (per app name)
  • App in front

Download (66 KB) · needs Python 3
SHA-256 64cb0191d95aca8fff7307518996d8e206c64ef6354d76ef2ec863701be61582