captains-deck.com ~/plugins 7 plugins · needs 1.5.4+ ↑ updated 2026-10-06 --:--:--
Beginner 7 plugins 1.5.4+

Plugin gallery.

Ready-made plugins that add new commands to the right-click menu. Download a ZIP, install it from Settings, and it’s there next time you right-click.

About plugins

Plugins are small add-ons written in JavaScript. Each one on this page adds one or more items to the bottom of the right-click menu, and shows its results in a notification or a window you can copy from or save.

  • Plugins work in the direct-download and Setapp editions of Captain’s Deck. In the direct-download edition they’re part of Pro, and they work during the free trial.
  • They aren’t available in the Mac App Store edition, because the App Store sandbox doesn’t allow them.
  • The plugins on this page need Captain’s Deck 1.5.4 or later; GitHub Browser and Share as Gist need 1.5.5 or later. On an older version they tell you to update instead of running.

All seven are free and open source (MIT licence).

Install a plugin

  1. Download the plugin’s ZIP file from this page. Don’t unzip it.
  2. In Captain’s Deck, open Settings (Captain’s Deck → Preferences… or Cmd+,) and choose the Plugins tab.
  3. Click Install Plugin… and pick the ZIP.
  4. Read the list of permissions the plugin asks for and click Install.
  5. Tick the plugin’s checkbox in the list to turn it on, then click Allow when Captain’s Deck asks you to confirm its permissions.

That’s it — right-click a file or folder and the plugin’s commands appear at the bottom of the menu. Installing a newer version of the same plugin replaces the old one.

Turning a plugin off. Untick its checkbox in Settings → Plugins. To remove one completely, select it and click Remove Plugin…: it goes to the Trash, and its stored data, the permissions you allowed and any tokens it kept in your Keychain are cleared.

Permissions

Every plugin lists the permissions it needs, and it can only use those. Captain’s Deck shows you that list twice: when you install the plugin, and again when you first turn it on. A plugin doesn’t run until you click Allow.

If an update to a plugin asks for more than you allowed before, Captain’s Deck asks again and shows only the new permissions. If you didn’t update the plugin yourself, choose Don’t Allow.

The plugins on this page use these permissions:

PermissionWhat it lets the plugin do
Read FilesRead files and folders you point it at
Network AccessConnect to the internet. Marked as dangerous in the prompt. GitHub Browser and Share as Gist use it only to talk to GitHub.
Register ProvidersAdd a new kind of place you can open in a pane. GitHub Browser uses it to show GitHub repositories as folders.
Shell CommandsRun command-line programs. Marked as dangerous in the prompt, and it also needs a switch in Settings (see Image Toolkit and Git Quick Actions below). Those two plugins use it only to run macOS’s sips and git.
Write FilesCreate, change and delete files. Marked as dangerous in the prompt. Project Cleaner uses it only to move folders to the Trash after you confirm.
Context MenuAdd items to the right-click menu
ClipboardRead and write the clipboard
NotificationsShow short messages
DialogsAsk you a question and show result windows

Even with Read Files, plugins can’t open protected places such as your SSH keys, keychains, browser profiles, or Captain’s Deck’s own settings. Only GitHub Browser and Share as Gist ask for network access, and only Image Toolkit and Git Quick Actions ask for shell access.

Checksum & Verify

Checksum & Verify v1.0.0

Make sure a download arrived intact. Copy a file’s SHA-256 with one click, see SHA-1, MD5 or SHA-512 checksums for a batch of files, compare a file against a hash you copied from a website, or check every file listed in a SHA256SUMS file at once. Large files are fine — they’re read in pieces, not loaded into memory.

What it adds

  • Copy SHA-256 — on one or more files (not folders). One file copies just the hash; several files copy one hash  name line each, the same format shasum uses.
  • Show Checksums… — on one or more files. Pick SHA-256, SHA-1, MD5 or SHA-512 and the results open in a window with Copy and Save… buttons.
  • Compare with Clipboard Hash — on a single file. Copy the published hash first; the plugin works out whether it’s MD5, SHA-1, SHA-256, SHA-384 or SHA-512 and tells you whether it matches.
  • Verify Checksums — on a checksum file: one ending in .sha256, .sha1, .md5, .sha384 or .sha512, or named SHA256SUMS, SHA1SUMS, MD5SUMS, SHA512SUMS or CHECKSUMS. Every file it lists is checked in that folder, and a table shows OK, MISMATCH or MISSING for each, which you can copy or save as CSV. Both the shasum format and the BSD SHA256 (name) = hash format are understood.

Permissions it asks for

  • Read Files
  • Context Menu
  • Clipboard
  • Notifications
  • Dialogs
Download ZIP ↓
SHA-256d97b962b4c596115741555db5906f9fd6c6c51b295555e1ecc3b7e38069a584f

Bulk Metadata

Bulk Metadata v1.0.0

See what’s inside your files without opening them one by one. Select a batch of photos and get camera, lens, exposure and GPS in one table; select an album and get artist, track and bitrate; select a folder of PDFs and get titles, authors and page counts. Save the table as CSV to open it in Numbers or Excel.

What it adds

  • Show Metadata — on anything you select.
    • One file: every detail macOS knows about it, in a two-column table.
    • Several files or folders: choose Photos (date taken, camera, lens, aperture, shutter, ISO, focal length, size, GPS), Audio (title, artist, album, track, year, genre, length, bitrate, sample rate), Documents (title, author, pages, created, modified, creator app) or Everything. Folders are searched including their subfolders, hidden files are skipped, and up to 2,000 files are read. Columns no file has a value for are left out.

The result window has Copy and Save CSV… buttons. Details come from Spotlight, plus the EXIF and GPS data stored in photos, so photo details work even in folders Spotlight hasn’t indexed.

Permissions it asks for

  • Read Files
  • Context Menu
  • Notifications
  • Dialogs
Download ZIP ↓
SHA-2562994418c8ace62641b26c71037ca777acf5005368e7d14c05d53d63d81c71bf0

Project Cleaner

Project Cleaner v1.0.0

Get back the gigabytes your old projects are sitting on. Right-click a folder and Project Cleaner finds the build output and package folders your tools can recreate — node_modules, Xcode’s DerivedData, Python caches and the rest — shows how big each one is, and moves them to the Trash only when you say so. Changed your mind? Put them back from the Trash.

What it adds

  • Find Build Clutter… — on a single folder. It looks through the folder and its subfolders and lists what it finds, largest first, with each folder’s size and file count. Then it asks whether to move them all to the Trash; click Move to Trash or Cancel.

It looks for:

  • Always: node_modules, DerivedData, __pycache__, .pytest_cache, .mypy_cache, .gradle, .next, .nuxt, .parcel-cache
  • Only next to the project file that makes them: target (with Cargo.toml), .build (with Package.swift), Pods (with Podfile)
  • Python virtual environments: venv and .venv folders that contain pyvenv.cfg

It never looks inside .git, .hg or .svn folders, or folders named Library, Applications or System.

Permissions it asks for

  • Read Files
  • Write Files
  • Context Menu
  • Notifications
  • Dialogs

Write Files is what lets it move folders to the Trash. It only does that after you click Move to Trash.

Download ZIP ↓
SHA-25604e0c757887159bec1e61429d81edb29cf126012a6d91981ff66f9eb0403f270

Image Toolkit

Image Toolkit v1.0.0

Shrink photos for email or the web, turn HEIC pictures from your iPhone into JPEGs, and check an image’s size and colour space — without opening another app. It uses sips, the image tool built into macOS, so there’s nothing else to install. Your originals are never changed: every result is a new file saved next to the original.

What it adds

  • Resize Images… — on one or more images. Pick a size for the longest side (512, 1024, 1600, 2048 or 3000 pixels, or type your own) and the proportions are kept. beach.jpg resized to 1024 becomes beach-1024.jpg; if that name is taken you get beach-1024 2.jpg. Images that are already that size or smaller are skipped, never enlarged.
  • Convert Images… — to JPEG, PNG, HEIC or TIFF. photo.heic converted to JPEG becomes photo.jpg. Images already in that format are skipped.
  • Image Info — a table with each image’s size in pixels, format, colour space, whether it has transparency, and its DPI.

It reads JPEG, PNG, HEIC, TIFF, GIF, BMP, WebP, JPEG 2000 and Photoshop files. Other files in your selection are left alone. After resizing or converting, a notification says how many files were saved, and a window lists anything that was skipped and why.

Turn on shell commands first. This plugin runs a command-line tool, which Captain’s Deck only allows after you tick Allow plugins to execute shell commands in Settings → Plugins and click Enable. Without it, the plugin tells you to turn that on and does nothing else.

Permissions it asks for

  • Shell Commands
  • Read Files
  • Context Menu
  • Notifications
  • Dialogs

Shell Commands is what lets it run sips. File names are passed safely, so a file with quotes or other unusual characters in its name can’t run anything.

Download ZIP ↓
SHA-256dca8f2328d822f612ed85cf13ca247e69553a4ee0df8ce6d3eab6e103c1af76e

Git Quick Actions

Git Quick Actions v1.0.0

Everyday Git jobs from the right-click menu: see who changed a file and when, send a teammate a link to it, and pull or switch branches without opening a terminal. It adds to Captain’s Deck’s own Git menu (stage, unstage, revert, diff and commit) rather than repeating it.

What it adds

  • Git: History — on one file or folder. A table of the commits that changed it, newest first, with date, author and message (up to the latest 200).
  • Git: Blame — on a file. Shows every line with the commit, author and date that last changed it.
  • Git: Copy Remote Link — on one file or folder. Copies its web link on GitHub, GitLab or Bitbucket, pinned to the commit you have checked out so the link keeps pointing at the same version. If that commit isn’t pushed yet, it says so, because the link won’t open until you push.
  • Git: Pull — on a folder in a repository. Pulls only when it can fast-forward. If your branch and the remote have both changed, it merges nothing and shows Git’s message, so you can sort it out in a terminal.
  • Git: Switch Branch… — on a folder in a repository. Pick from your local branches, most recently used first. If Git refuses (for example because you have changes that would be overwritten), you see why.

It needs Git, which comes with Apple’s Command Line Tools; a Homebrew Git is found too. It never asks for a password: if the remote needs one that Git can’t get from your keychain or SSH agent, Pull shows Git’s error instead.

Turn on shell commands first. This plugin runs a command-line tool, which Captain’s Deck only allows after you tick Allow plugins to execute shell commands in Settings → Plugins and click Enable. Without it, the plugin tells you to turn that on and does nothing else.

Permissions it asks for

  • Shell Commands
  • Context Menu
  • Clipboard
  • Notifications
  • Dialogs

Shell Commands is what lets it run git. Clipboard is used only to copy the link.

Download ZIP ↓
SHA-25607bd1c23947120a7988c070137fcc609af114e34bc4bdf7d461912fe9c533f72

GitHub Browser

GitHub Browser v1.0.0

Browse a GitHub repository in a pane, like a folder: owners, repositories, branches and files. View a file with F3 or Quick Look, or copy files and folders to the other pane with F5. It’s read-only, so nothing you do here changes the repository. Needs Captain’s Deck 1.5.5 or later.

What it adds

  • Open GitHub Repository… — type owner/repo or paste a GitHub link, and the repository opens in the pane. You can also type github://owner/repo in Go to Path (⌘G).
  • GitHub Browser Token… — add or remove a GitHub token. Public repositories work without one (GitHub allows 60 requests an hour); a token raises that to 5,000 and opens your private repositories. It’s kept in your Keychain and removed with the plugin.

To go back to your disk, go to any folder on your Mac with Go to Path.

Permissions it asks for

  • Network Access
  • Register Providers
  • Context Menu
  • Notifications
  • Dialogs

Network Access is used only to talk to GitHub. Register Providers is what lets it show GitHub as a place in the pane.

Download ZIP ↓
SHA-2567f7d8b2ba0be9b06a583baa31de230e7154d613939ee08b0af5b6961e9f74a1a

Share as Gist

Share as Gist v1.0.0

Share code, logs or notes as a GitHub Gist and get the link on your clipboard. Needs Captain’s Deck 1.5.5 or later.

What it adds

  • Share as Gist… — on one or more text files. Choose a secret gist, which only people with the link can see, or a public one, which is listed on your GitHub profile and can be searched. All the selected files go into one gist, and its link is copied. Files over 1 MB, empty files and files that aren’t text are left out, and you’re told which.

The first time, it asks for a GitHub token with the gist permission and keeps it in your Keychain. To replace it, choose Change GitHub token… where you pick secret or public. If GitHub stops accepting the token, the plugin forgets it and asks again next time.

Permissions it asks for

  • Network Access
  • Read Files
  • Context Menu
  • Clipboard
  • Notifications
  • Dialogs

Network Access is used only to send the files to GitHub. Clipboard is used only to copy the link.

Download ZIP ↓
SHA-256fcc31beb19f65065e8731c7a495b4bcdfbc50ae6cb4cf356945bbe91e6d436d3

Check your download

Each card shows the ZIP’s SHA-256 checksum. To check a download, run this in Terminal (or Captain’s Deck’s own terminal) in your Downloads folder and compare the result with the card:

shasum -a 256 checksum-verify-1.0.0.zip

All seven checksums are also in one SHA256SUMS file. Once Checksum & Verify is installed, save that file next to your downloads, right-click it and choose Verify Checksums to check the rest in one go.

Tweaks

Theme
Motion