look

An open-source, cross OS, community-driven launcher. A lightweight alternative to Spotlight and Raycast. Made with ❀️ from Viet Nam πŸ‡»πŸ‡³

Automatically checked Β· GitHub checked 2026-11-13

look

Overview

look

look icon

A keyboard-first, local-first launcher for macOS, Windows, and Linux. Open apps, files, folders, clipboard history, and quick commands without leaving the keyboard.

Install macOS Linux Windows Latest release Downloads License: GPLv3 Discord

πŸ“˜ Docs Β· πŸ“– User guide Β· 🧩 lookbook Β· πŸ’¬ Discord

Open video on GitHub

Results land as fast as you can type. A Rust core under a native SwiftUI app on macOS, and a GPU-drawn gpui shell on Windows and Linux, with no browser engine in the process. No background daemons. Your index, clipboard, and history stay on your machine; no telemetry.

How it compares
lookSpotlightRaycastAlfredulauncherrofi
PlatformmacOS Β· Windows Β· LinuxmacOS onlymacOS Β· WindowsmacOS onlyLinux onlyLinux only
Open sourceβœ… GPLv3βŒβŒβŒβœ…βœ…
Free, no paid tierβœ…βœ…βŒ Pro $8-10/mo❌ Powerpack Β£34βœ…βœ…
No account neededβœ…βœ…βœ… core, ❌ sync and AIβœ…βœ…βœ…
Clipboard historyβœ… text and imagesβœ… macOS 26+βœ… (free: 3 months)❌ Powerpack only❌❌
Extension storeβœ… lookbookβŒβœ…βœ… Workflowsβœ…βŒ

If this is useful, ⭐ star the repo - it's the single biggest signal that helps the project keep shipping.

Install

macOS

brew install --cask look

Look listens on Cmd+Space from the first launch, a key Spotlight also holds.

Free it from Spotlight in System Settings > Keyboard > Keyboard Shortcuts > Spotlight, or leave Spotlight alone and give Look a different chord with launcher_hotkey in ~/.look/config. Settings are a panel inside the launcher, on Cmd+,.

Release builds are signed and notarized - no Gatekeeper bypass needed. Releases ship one build per architecture, Apple Silicon and Intel, and Homebrew installs the one that matches your Mac.

Nix (flake):

nix profile install 'github:kunkka19xx/look'

The same signed, notarized bundle Homebrew ships, so the Accessibility and Automation grants survive an update. Apple Silicon and Intel. nix-darwin and Home Manager: see BUILDING.md.

Linux

Released artifacts are x86_64 only. ARM builds aren't published; if you need one, please open an issue.

Arch Linux (AUR):

yay -S look-bin
# or
paru -S look-bin

Or without an AUR helper:

git clone https://aur.archlinux.org/look-bin.git
cd look-bin
makepkg -si

Ubuntu/Debian:

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/linux/install-look.sh | bash

Or download the .deb manually from Releases and run sudo dpkg -i Look_*.deb.

Any distro (AppImage):

chmod +x Look_*.AppImage
./Look_*.AppImage

After installing, launch with lookapp from a terminal, or search "Look" in your app launcher. Press Alt+Space to toggle the window at any time. To bind your own key instead, set launcher_hotkey=none in ~/.look/config, restart Look, and bind lookapp --toggle in your desktop settings. Look autostarts on login by default (on full DEs like GNOME/KDE).

Uninstall:

# Arch
yay -R look-bin

# Ubuntu/Debian
sudo dpkg -r lookapp

# AppImage - just delete the file
rm Look_*.AppImage

NixOS (flake):

nix profile install 'github:kunkka19xx/look'

Declarative:

inputs.look.url = "github:kunkka19xx/look";

# in your nixosSystem modules
look.nixosModules.default
{ programs.lookapp.enable = true; }   # binary cache included

Home Manager, updating, and troubleshooting: see BUILDING.md.

Note: Look is in nixpkgs as lookapp too, but a bump there waits on a nixpkgs maintainer, so that package lags releases. Install from this flake instead: the Cachix cache serves the prebuilt binary, so nothing compiles locally (programs.lookapp.enable = true turns it on, or cachix use look).

Note: On GNOME desktops, log out and log back in after the first install so the GNOME Shell extension (used for window focusing and hotkey on Wayland) can load.

Window manager users (i3, sway, Hyprland, niri, etc.): Autostart via .desktop files only works on full DEs (GNOME, KDE). On standalone WMs, add Look to your config manually. On i3, sway, and Hyprland the Alt+Space hotkey and window rules (float, no border) are registered automatically at runtime, so you only need the autostart line; niri needs the bind added by hand (see below):

# i3: ~/.config/i3/config
exec --no-startup-id lookapp
# (Alt+Space works via X11 global shortcut plugin)

# sway: ~/.config/sway/config
exec lookapp
# (Alt+Space, float, and border rules are injected automatically via swaymsg)

# Hyprland: ~/.config/hypr/hyprland.conf
exec-once = lookapp
# (Alt+Space, float, and border rules are injected automatically via hyprctl)

niri has no API to add binds at runtime, so Alt+Space has to go in ~/.config/niri/config.kdl yourself, or in any file that config includes. Look shows the exact stanza for your system (the gdbus path differs on NixOS) in its setup notice on first run:

spawn-at-startup "lookapp"

binds {
    Alt+Space allow-inhibiting=false { spawn "gdbus" "call" "--session" "--dest" "com.look.Desktop" "--object-path" "/com/look/Desktop" "--method" "com.look.Desktop.Toggle"; }
}

allow-inhibiting=false matters: without it niri passes the key to a window holding a keyboard-shortcuts inhibitor, which fullscreen games, browsers and virtual machines all take, and Look never opens over them.

Any key works, it is the same spawn line: Look only ever sees the D-Bus call. Bind a key niri already uses (Mod+D spawns fuzzel in the default config) and niri rejects the whole config as a duplicate keybind, keeping the last good one, so drop the existing bind first and check with niri validate, or niri --config <path> validate if you start niri with -c. The setup notice names the file Look actually read, which is that -c path, then NIRI_CONFIG, then ~/.config/niri/config.kdl, then /etc/niri/config.kdl - niri loads one of them and never merges.

Floating is applied at runtime over niri's IPC; add a rule only if you also want the focus ring and shadow off:

window-rule {
    match app-id="^lookapp$"
    open-floating true
    focus-ring { off; }
    shadow { off; }
}

Hyprland 0.55+ only. Focus-existing-window uses the wlr-foreign-toplevel-management protocol. Older Hyprland versions relied on the legacy hyprctl dispatch focuswindow syntax which was deprecated in 0.55; selecting an already-running app on <0.55 may launch a second instance instead of focusing. Upgrade to 0.55+ for correct behavior.

To build from source, see apps/linows/BUILDING.md.

Windows

Released artifacts are x86_64 only. Windows on ARM (Surface Pro X / Snapdragon X) can run the x64 build under emulation; native ARM builds aren't published - open an issue if you need one.

One PowerShell line, no admin required:

iex "& { $(irm https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/windows/install-look.ps1) }"

Or with Scoop (if you already have it installed):

scoop bucket add extras
scoop install extras/look

The script resolves the latest release, downloads the NSIS installer, verifies its SHA256 against the published checksums, and runs it silently into %LOCALAPPDATA%\Programs\Look. SmartScreen will warn on the first download while reputation builds - click "More info β†’ Run anyway" if Windows blocks the script itself.

Uninstall:

# Scoop
scoop uninstall look

# Installer script
iex "& { $(irm https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/windows/install-look.ps1) } -Uninstall"

# Optional: wipe user data
Remove-Item -Recurse "$env:LOCALAPPDATA\look"

The launcher's global hotkey defaults to Alt+Space; set launcher_hotkey in ~/.look/config (for example launcher_hotkey=ctrl+space) to change it, then reload with Ctrl+Shift+;. For a manual install: download Look_<version>_x64-setup.exe from Releases, verify the SHA256 against the published Look-<version>-windows-checksums.txt, then run. Uninstall via Settings β†’ Apps or %LOCALAPPDATA%\Programs\Look\uninstall.exe. To wipe user data: Remove-Item -Recurse "$env:LOCALAPPDATA\look".

Other install options (curl, pin version, update/uninstall)

macOS - Homebrew update / uninstall:

# update
brew upgrade --cask look

# uninstall
brew uninstall --cask look

macOS - curl installer:

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash

Pin a specific version or repo fork:

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash -s -- --version <version> --repo kunkka19xx/look

Direct URL:

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash -s -- --url "https://github.com/kunkka19xx/look/releases/download/v<version>/Look-<version>-macOS.zip"

CLI naming note: macOS ships /usr/bin/look, so terminal command examples use lookapp.

If Look is fully quit and Spotlight is still unbound, relaunch from Launchpad, or via:

open "/Applications/Look.app"

Essential shortcuts

ActionmacOSWindowsLinux
Toggle launcherCmd+SpaceAlt+SpaceAlt+Space
Open / runEnterEnterEnter
Web searchCmd+EnterCtrl+EnterCtrl+Enter
Reveal in file managerCmd+F (Finder)Ctrl+F (Explorer)Ctrl+F (Files)
Edit selected file/folder in your editorCmd+ECtrl+ECtrl+E
Open a terminal thereCmd+TCtrl+TCtrl+T
Action menu for the selected rowCmd+KCtrl+KCtrl+K
Move to Trash (or empty the Trash folder)Cmd+Dn/an/a
Command mode (calc, pomo, todo, speed, kill, shell, sys)Cmd+/Ctrl+/Ctrl+/
SettingsCmd+,Ctrl+,Ctrl+,
Back / hideEscapeEscapeEscape
Quit Look (Cmd+Q only hides it)Cmd+Option+QAlt+Shift+QAlt+Shift+Q
Switch to running app N (home screen)Cmd+1..Cmd+9Alt+1..Alt+9Alt+1..Alt+9
Hide selected app from LookCmd+Shift+HCtrl+Shift+HCtrl+Shift+H
Run selected app as adminn/aCtrl+Shift+Entern/a
Fire a super action (empty home screen)Cmd+<letter>Alt+<letter>Alt+<letter>

(Throughout the rest of the docs, Cmd+X on macOS maps to Ctrl+X on Windows and Linux; the launcher-toggle hotkey uses Alt+Space on Windows/Linux instead of Cmd+Space because Win+Space / Super+Space are typically reserved by the OS or desktop environment.)

Every chord in the table is a default. Rebind the in-app ones (all but Enter, Escape, Quit and the running-app digits, which stay fixed) in Settings > Shortcuts on all three platforms, or set shortcut_<group>_<action> in ~/.look/config; the launcher toggle records there too on macOS and Windows, while Linux takes launcher_hotkey=none and your own binding of lookapp --toggle. A super action's letter is its mnemonic in ~/.look/super-actions.toml. Details in Keyboard shortcuts.

Cmd+E and Cmd+T need a tool named in ~/.look/config (text_editor, code_editor, terminal), and file_manager retargets Cmd+F. Declare nothing and each falls back to the system default: see Preferred tools.

Which super actions are on the strip, where they sit, and any tiles of your own is a drawing in ~/.look/super-actions.toml, seeded on first run: see Super actions.

Full reference: docs/user-guide.md.

Extend it with lookbook

Look can list your own rows next to apps and files: repos, SSH hosts, containers, tmux sessions, a morning routine. lookbook is a catalog of ready-made ones. Open Settings > Extend and choose Browse lookbook: each card says whether it works on your machine, and Install asks for what it needs (a folder, a terminal) before writing anything.

Made one worth sharing? Send it to lookbook, or show it first in #lookbook-share on Discord. AI-assisted is fine, as long as it is useful, documented and tested. To write your own, see Your own sources; to have an app push its own rows, see Integrating your app.

Themes

Built-in: Catppuccin, Tokyo Night, Rose Pine, Gruvbox, Dracula, Kanagawa, Kindle, Liquid, plus Custom. Kanagawa is the default on Linux and Windows. Kindle is the one light preset - paper, ink, and a serif face. Liquid renders on macOS 26's Liquid Glass and is hidden on older releases; on Linux and Windows it ships as clear glass - same palette and geometry, a specular rim instead of refraction, plus real behind-window blur wherever the compositor grants it (KDE, Hyprland 0.56+, Niri). Switch in Settings > Appearance.

Documentation

  • πŸ“˜ Docs site - hosted, searchable user guide and reference
  • πŸ’¬ Discord - ask for help, show your setup, share sources and tiles
  • User guide (in-repo) - full feature reference, shortcuts, configuration, permissions, troubleshooting
  • Architecture - how the Swift app + Rust core fit together
  • Integrating your app - the connector contract, for shipping an app that puts its own rows in Look
  • Features - what's shipped, what's planned
  • Contributing - how to contribute
  • Your own sources - declare custom rows from directories, files, and commands
  • lookbook - ready-made sources (git, ssh, docker, projects), browsable and installable from Settings > Extend
  • Writing a control - add a Quick Action toggle/button to the panel
  • Development - building locally, repo layout, release process

License

Copyright (C) 2026 kunkka19xx

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. See LICENSE for the full text.

Contributors

Thanks to everyone who has contributed - see the contributor graph.