Jiffy

𝐴𝑝𝑝 𝑙𝑎𝑢𝑛𝑐ℎ𝑒𝑟 | 𝐵𝑎𝑠𝑖𝑐 𝑐𝑎𝑙𝑐𝑢𝑙𝑎𝑡𝑜𝑟 | 𝐸𝑚𝑜𝑗𝑖 𝑝𝑖𝑐𝑘𝑒𝑟
𝐶𝑢𝑠𝑡𝑜𝑚 𝑐𝑜𝑚𝑚𝑎𝑛𝑑 𝑝𝑎𝑙𝑙𝑒𝑡𝑡𝑒

---

Launcher

Emojies

Calculator

Dependencies

• fzf for fuzzy search.
• kitty terminal(optional) for displaying app icons.

Installation

• You can download the precompiled binary of Jiffy from the GitHub Releases page.

• Move the binary to a directory included in your system's PATH (e.g., /usr/local/bin or ~/bin).

• After installing the binary, you can run jiffy from your terminal.

  Build from source

  • Install QuickJs compiler

    git clone --depth 1 https://github.com/bellard/quickjs.git &&
    cd quickjs &&
    make &&
    sudo make install &&

  • Get the Jiffy's source code and compile.

    git clone --depth 1 https://github.com/5hubham5ingh/jiffy.git &&
    git clone --depth 1 https://github.com/5hubham5ingh/justjs.git &&
    git clone --depth 1 https://github.com/ctn-malone/qjs-ext-lib.git &&
    cd jiffy &&
    qjsc -flto main.js -o jiffy &&
    sudo mv jiffy /usr/bin/

Configuration

Jiffy allows you to define custom menus in menu.jsonc and menu.js files. These file should be in your ~/.config/jiffy/ directory. The menu follows the JSON format.

Example

1. menu.jsonc

{
  "Power Menu": [
    {
      "name": "Shutdown",
      "exec": "shutdown -P now",
      "description": "System shutdown.",
    },
    {
      "name": "Sleep",
      "exec": "shutdown -H now",
      "description": "System sleep.",
    },
    {
      "name": "Reboot",
      "exec": "shutdown -r now",
      "description": "System reboot.",
    },
    {
      "name": "List scheduled shutdown.",
      "exec": "shutdown --show",
      "description": "List scheduled shutdown.",
      "terminal": true
    }
  ]
}

This example defines a "Power Menu" with shutdown, reboot, and sleep options. The exec field specifies the command to run, and the description gives a brief explanation of each option.

2. menu.js

let _focusWindowsCache = null;
export default {
  "Hypr Windows": await getHyprWindows(), // executes on jiffy startup

  get "Hypr keybinds"() {
    return getHyprlandKeybinds(); // executes on menu access
  },

  get "Binaries"() {
    const result = []
    const paths = STD.getenv("PATH")?.split(':')

    for (const path of paths) {
      const bins = OS.readdir(path)[0].filter(name => name !== '.' && name !== '..')
      for (const bin of bins) {
        result.push({
          name: bin,
          description: `Location: '${path}'`,
          exec: bin
        })
      }
    }
    return result;
  }
};

async function getHyprWindows() {
  if (_focusWindowsCache) return _focusWindowsCache;
  const hyprState = JSON.parse(
    await execAsync(["hyprctl", "-j", "clients"]),
  );
  _focusWindowsCache = hyprState.map((window) => ({
    name: window.class,
    description: window.title.replace("#", "_"),
    exec: `hyprctl dispatch focuswindow address:${window.address}`,
  }));
  return _focusWindowsCache;
}

let _hyprKeyBindsCache = null;
function getHyprlandKeybinds() {
  if (_hyprKeyBindsCache) return _hyprKeyBindsCache;
  const hyprBinds = JSON.parse(
    exec(["hyprctl", "-j", "binds"]),
  );
  const mods = generateModMaskMap();
  _hyprKeyBindsCache = hyprBinds.map((keyBind) => ({
    name: `${
      (mods[keyBind.modmask] ?? []).join(" + ").concat(" ")
    }${keyBind.key}`,
    description: keyBind.description,
    exec: `${keyBind.dispatcher} ${keyBind.arg}`,
  }));
  return _hyprKeyBindsCache;

  function generateModMaskMap() {
    const modMaskMap = {};

    function parseModMask(modmask) {
      const modifiers = [];
      if (modmask & 1) modifiers.push("SHIFT");
      if (modmask & 4) modifiers.push("CTRL");
      if (modmask & 8) modifiers.push("ALT");
      if (modmask & 64) modifiers.push("SUPER");
      return modifiers;
    }

    const validModifiers = [1, 4, 8, 64];
    let validMasks = [0];

    for (const mod of validModifiers) {
      const newMasks = [];
      for (const mask of validMasks) {
        newMasks.push(mask | mod);
      }
      validMasks = [...validMasks, ...newMasks];
    }

    validMasks = validMasks.filter((mask) => mask !== 0);

    for (const mask of validMasks) {
      modMaskMap[mask] = parseModMask(mask).reverse();
    }

    return modMaskMap;
  }
}

This example defines a dynamically generated menu for switching focus to another opened window and browse all key bind of Hyprland.

Usage

You can launch Jiffy by running the following command:

jiffy [ARG] ...

Examples

1. Hide prompt and app's category:

   jiffy --fzf-args='--prompt=" "' -c

2. Hide app description and refresh app's list:

   jiffy --fzf-args="--preview-window=0" --no-cache

3. Change UI preset and inject custom JS:

   jiffy -p 2 -i 'OS.exec(["kitty", "@", "set-spacing", "margin=0"])'

Run jiffy --help to see more options.

Keyboard Shortcuts

You can switch between any modes or UI presets using following shotcut keys-

Shortcut	Action
shift+tab	Change UI preset
tab	Change mode
mainMod+space	Refresh application list for launcher
mainMod+k	Show all keybinds

Miscellaneous

Config for hyprland

$applicationMenu = kitty -1 -o allow_remote_control=yes --class=applicationMenu --title=applicationMenu -o background_opacity=$overlay_window_opacity jiffy -x wl-copy -i 'OS.exec(["kitty", "@", "set-spacing", "margin=0"])' -r

bindd = $mainMod, Return, Launch application menu, exec, $applicationMenu

windowrulev2 = float, title:^(applicationMenu)$ 
windowrulev2 = center 1, title:^(applicationMenu)$
windowrulev2 = size 1390 410, title:^(applicationMenu)$ 
windowrulev2 = animation slide up, title:^(applicationMenu)$
windowrulev2 = bordersize 0, title:^(applicationMenu)$
windowrulev2 = rounding 10, title:^(applicationMenu)$
windowrulev2 = dimaround, title:^(applicationMenu)$
windowrulev2 = pin, title:^(applicationMenu)$
windowrulev2 = stayfocused, title:^(applicationMenu)$

Config for kitty

map alt+enter launch --type=overlay jiffy -t 'kitty -1 --hold'

Todo

• icons for custom command, UI should adjust if there is no icons in the menu

---

Feel free to contribute or open issues if you encounter any problems or have suggestions for new features.