rcmd

A simple MacOS application switcher, inspired by rcmd. I didn't want to spend $13 so I made a small app with a similar concept. NOTE: Neither I nor this repo have anything to do with the original rcmd app.

Usage

usage: rcmd [options]

  Description:
    Press and hold the right command key then type what process you
    want to switch to. The text is fuzzy matched against all running
    processes, for example typing `xcd` will probably switch to Xcode.

    By default the active window will update as you type, to disable
    this behaviour pass `--manual or -m` through the arguments. This
    will make it so you will to press the return (Enter) key to switch

  Arguments:
    * --manual/-m -- Press return key to switch windows
    * --blacklist/-b -- Path to app blacklist
    * --tolerance/-T -- Fuzzy matching tolerance (default: 1)
    * --no-dynamic-blacklist/-d -- Disable dynamically blacklisting apps
                                   with no windows on screen
    * --no-menubar/-x -- Disable menubar icon
    * --no-text/-t -- Disable buffer text window
    * --no-swtich/-s -- Disable application switching
    * --applescript/-a -- Path to AppleScript file to run on event
    * --font/-f -- Name of font to use
    * --font-size/-F -- Set size of font (default: 72)
    * --position/-p -- Set the window position, options: top, top-left,
                       top-right, bottom, bottom-left, bottom-right,
                       left, and right (default: centre)
    * --color/-c -- Set the background color of he window. Accepts colors
                    in hex (#FFFFFF) and rgb (rgb(255,255,255) formats.
                    (default: rgb(0,0,0)
    * --opacity/-o -- Set the opacity of the window (default: 0.5)
    * --lua/-l -- Path to Lua file to run on event. NOTE: This requires
                  rcmd to be build with -DRCMD_ENABLE_LUA
    * --verbose/-b -- Enable logging
    * --help/-h -- Display this message

Build

You have three choices:

1. Run make and make install to build and intall the program
2. Run make app and make install-app to build and install the app version
3. Use xcodegen to generate the Xcode project

NOTE: This app needs accessibility permissions to run.

Credits

• Levenshtein distance implementation taken from Rosetta Code
• String wildcard matching function by tidwall/match.c
• Privileges check for accessibility by koekeishiya/skhd

LICENSE

rcmd -- use the right cmd key to swtich between apps

Copyright (C) 2024  George Watson

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.