Launcher

Emojies

Calculator

Color picker

Dependencies

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

Installation

• Quick download: Run

  sudo curl -sL $(curl -s https://api.github.com/repos/5hubham5ingh/jiffy/releases/latest | grep -Po '"browser_download_url": "\K[^"]+' | grep jiffy) | tar -xz && sudo mv jiffy /usr/bin/
  

• Or, 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-

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.