{"id":48362209,"url":"https://github.com/kunkka19xx/look","last_synced_at":"2026-05-15T16:01:48.340Z","repository":{"id":349123542,"uuid":"1201098277","full_name":"kunkka19xx/look","owner":"kunkka19xx","description":"An open-source, community-driven launcher for macOS. A lightweight alternative to Spotlight and Raycast. I'm working on this project with AI agents.","archived":false,"fork":false,"pushed_at":"2026-05-14T14:57:14.000Z","size":37383,"stargazers_count":132,"open_issues_count":13,"forks_count":12,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-14T16:47:37.755Z","etag":null,"topics":["apple","launcher","macos","opensource","rofi-macos","rust","spotlight","swift"],"latest_commit_sha":null,"homepage":"https://noah-code.com/docs/look","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kunkka19xx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"kunkka19xx","buy_me_a_coffee":"kunkka19xx","custom":["https://me.momo.vn/4GIEuasJuWTVC5sluxiv"]}},"created_at":"2026-04-04T07:54:34.000Z","updated_at":"2026-05-14T15:53:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kunkka19xx/look","commit_stats":null,"previous_names":["kunkka19xx/look"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/kunkka19xx/look","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunkka19xx%2Flook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunkka19xx%2Flook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunkka19xx%2Flook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunkka19xx%2Flook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kunkka19xx","download_url":"https://codeload.github.com/kunkka19xx/look/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunkka19xx%2Flook/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33071582,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple","launcher","macos","opensource","rofi-macos","rust","spotlight","swift"],"created_at":"2026-04-05T13:01:25.684Z","updated_at":"2026-05-15T16:01:48.334Z","avatar_url":"https://github.com/kunkka19xx.png","language":"Swift","funding_links":["https://github.com/sponsors/kunkka19xx","https://buymeacoffee.com/kunkka19xx","https://me.momo.vn/4GIEuasJuWTVC5sluxiv"],"categories":[],"sub_categories":[],"readme":"# look\n\n\u003cimg src=\"assets/icon.png\" alt=\"look icon\" width=\"96\" /\u003e\n\nA keyboard-first, local-first launcher for macOS, Windows, and Linux. Open apps, files, folders, clipboard history, and quick commands without leaving the keyboard.\n\n[macOS](#macos) · [Windows](#windows) · [Linux](#linux-under-development)\n📘 [Docs](https://noah-code.com/docs/look) · 📖 [User guide](docs/user-guide.md) · 🎬 [Demo video](https://www.youtube.com/watch?v=4Twb4We3PIs)\n\nhttps://github.com/user-attachments/assets/176a929d-edbe-46a0-a0c5-229eb9b31c1c\n\n## Install\n\n### macOS\n\n```bash\nbrew tap kunkka19xx/tap\nbrew install --cask look\n```\n\nThen bind `Cmd+Space` to Look (disable Spotlight's shortcut in `System Settings \u003e Keyboard \u003e Keyboard Shortcuts \u003e Spotlight`). Release builds are signed and notarized — no Gatekeeper bypass needed.\n\n### Linux\n\n**Arch Linux (AUR):**\n\n```bash\nyay -S look-bin\n# or\nparu -S look-bin\n```\n\nOr without an AUR helper:\n\n```bash\ngit clone https://aur.archlinux.org/look-bin.git\ncd look-bin\nmakepkg -si\n```\n\n**Ubuntu/Debian (.deb)** — download from [Releases](https://github.com/kunkka19xx/look/releases):\n\n```bash\nsudo dpkg -i Look_*.deb\n```\n\n**Any distro (AppImage):**\n\n```bash\nchmod +x Look_*.AppImage\n./Look_*.AppImage\n```\n\nAfter installing, launch with `lookapp` from a terminal, or search \"Look\" in your app launcher. Press `Alt+Space` to toggle the window at any time. Look autostarts on login by default (on full DEs like GNOME/KDE).\n\nUninstall:\n\n```bash\n# Arch\nyay -R look-bin\n\n# Ubuntu/Debian\nsudo dpkg -r lookapp\n\n# AppImage — just delete the file\nrm Look_*.AppImage\n```\n\n**NixOS (flake):**\n\n```bash\n# Run directly\nnix run github:kunkka19xx/look?dir=apps/linows\n\n# Install to profile\nnix profile install github:kunkka19xx/look?dir=apps/linows\n```\n\nDeclarative (NixOS):\n\n```nix\n# flake.nix — add input and cachix config\n{\n  nixConfig = {\n    extra-substituters = [ \"https://look.cachix.org\" ];\n    extra-trusted-public-keys = [ \"look.cachix.org-1:8elPCeSVBzlDZXqIRKBK9GyLIK/Hoe1xiWZF0ir7uX4=\" ];\n  };\n\n  inputs.look.url = \"github:kunkka19xx/look?dir=apps/linows\";\n  # ... your other inputs\n}\n\n# configuration.nix — add package\n{ pkgs, inputs, ... }:\n{\n  environment.systemPackages = [\n    inputs.look.packages.${pkgs.system}.default\n  ];\n}\n```\n\nPre-built binaries are served via [Cachix](https://look.cachix.org). On first rebuild, nix will ask to trust the cache — say yes. No source compilation needed.\n\nUpdate to latest release:\n\n```bash\nnix flake update look --flake /path/to/your/flake\nsudo nixos-rebuild switch --flake /path/to/your/flake#hostname\n```\n\n\u003e **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.\n\n**Window manager users (i3, sway, Hyprland, etc.):** Autostart via `.desktop` files only works on full DEs (GNOME, KDE). On standalone WMs, add Look to your config manually. The `Alt+Space` hotkey and window rules (float, no border) are registered automatically at runtime — you only need the autostart line:\n\n```bash\n# i3: ~/.config/i3/config\nexec --no-startup-id lookapp\n# (Alt+Space works via X11 global shortcut plugin)\n\n# sway: ~/.config/sway/config\nexec lookapp\n# (Alt+Space, float, and border rules are injected automatically via swaymsg)\n\n# Hyprland: ~/.config/hypr/hyprland.conf\nexec-once = lookapp\n# (Alt+Space, float, and border rules are injected automatically via hyprctl)\n```\n\n\u003e **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 \u003c0.55 may launch a second instance instead of focusing. Upgrade to 0.55+ for correct behavior.\n\nTo build from source, see [apps/linows/BUILDING.md](apps/linows/BUILDING.md).\n\n### Windows\n\nInstall the latest release with one PowerShell line (no admin required):\n\n```powershell\niex \"\u0026 { $(irm https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/windows/install-look.ps1) }\"\n```\n\nThe script auto-detects x64 vs ARM64, pulls the matching release zip, verifies its SHA256 against the published manifest, extracts to `%LOCALAPPDATA%\\Programs\\Look`, and creates Start menu + desktop shortcuts. The release bundle is self-contained (`\u003cWindowsAppSDKSelfContained\u003etrue\u003c/WindowsAppSDKSelfContained\u003e`) so no separate runtime install is needed.\n\nUninstall:\n\n```powershell\niex \"\u0026 { $(irm https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/windows/install-look.ps1) } -Uninstall\"\n```\n\nSmartScreen may warn on first run while reputation builds — click \"More info → Run anyway\". The launcher's global hotkey (`Alt+Space`) is configurable in Settings → Appearance.\n\n\u003cdetails\u003e\n\u003csummary\u003eOther install options (curl, pin version, update/uninstall)\u003c/summary\u003e\n\n**macOS — Homebrew update / uninstall:**\n\n```bash\n# update\nbrew upgrade --cask kunkka19xx/tap/look\n\n# uninstall\nbrew uninstall --cask look\n```\n\n**macOS — curl installer:**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash\n```\n\nPin a specific version or repo fork:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash -s -- --version \u003cversion\u003e --repo kunkka19xx/look\n```\n\nDirect URL:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash -s -- --url \"https://github.com/kunkka19xx/look/releases/download/v\u003cversion\u003e/Look-\u003cversion\u003e-macOS.zip\"\n```\n\nCLI naming note: macOS ships `/usr/bin/look`, so terminal command examples use `lookapp`.\n\nIf Look is fully quit and Spotlight is still unbound, relaunch from Launchpad, or via:\n\n```bash\nopen \"/Applications/Look.app\"\n```\n\n\u003c/details\u003e\n\n## What you can do\n\n- **Find and open anything** — apps, files, folders indexed locally. Type, Enter, done.\n- **Calc inline** — type `2^10`, `4!`, `200*15%`, `sqrt(2)`, `2*pi`. No command mode needed.\n- **Kill a process by port** — `Cmd+/` then `kill :3000`. Confirms before killing.\n- **Search clipboard history** — `c\"meeting` finds the snippet you copied an hour ago.\n- **Translate or look up a word** — `t\"hello` for quick translation, `tw\"word` for a definition panel.\n- **Regex, path, and kind-scoped search** — `r\"^Visual.*`, `git/project/readme`, `a\"safari`, `f\"note`, `d\"documents`.\n\nAll local. No account. No telemetry. No plugin marketplace to manage.\n\n## Why look\n\n- **Fast** — typical search under 1 ms on a 2000-item index; empty-query browse under 30 µs.\n- **Small** — single native macOS app, no Electron, no background daemons.\n- **Local-first** — candidates indexed in a local SQLite file; the only network calls are explicit (`t\"`, `tw\"`, `Cmd+Enter` web search).\n- **Zero-config by default** — presets cover common apps (`alias_note`, `alias_code`, `alias_term`, `alias_chat`, `alias_music`, `alias_brow`). Configure more via `~/.look.config` when you want to.\n- **Keyboard-first** — every action has a key; mouse never required.\n\nIf you want a launcher that stays out of your way and does exactly what you asked, that's the pitch.\n\n## Essential shortcuts\n\n| Action                                        | macOS            | Windows             | Linux            |\n| --------------------------------------------- | ---------------- | ------------------- | ---------------- |\n| Toggle launcher                               | `Cmd+Space`      | `Alt+Space`         | `Alt+Space`      |\n| Open / run                                    | `Enter`          | `Enter`             | `Enter`          |\n| Web search                                    | `Cmd+Enter`      | `Ctrl+Enter`        | `Ctrl+Enter`     |\n| Reveal in file manager                        | `Cmd+F` (Finder) | `Ctrl+F` (Explorer) | `Ctrl+F` (Files) |\n| Command mode (`calc`, `shell`, `kill`, `sys`) | `Cmd+/`          | `Ctrl+/`            | `Ctrl+/`         |\n| Settings                                      | `Cmd+Shift+,`    | `Ctrl+Shift+,`      | `Ctrl+Shift+,`   |\n| Back / hide                                   | `Escape`         | `Escape`            | `Escape`         |\n\n(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.)\n\nFull reference: [docs/user-guide.md](docs/user-guide.md).\n\n## Themes\n\nBuilt-in: Catppuccin, Tokyo Night, Rose Pine, Gruvbox, Dracula, Kanagawa, plus Custom. Switch in `Settings \u003e Appearance`.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/look-ui/1.png\" width=\"45%\" /\u003e\n  \u003cimg src=\"assets/look-ui/2.png\" width=\"45%\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/look-ui/3.png\" width=\"45%\" /\u003e\n  \u003cimg src=\"assets/look-ui/4.png\" width=\"45%\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/look-ui/5.png\" width=\"45%\" /\u003e\n  \u003cimg src=\"assets/look-ui/6.png\" width=\"45%\" /\u003e\n\u003c/p\u003e\n\n## Documentation\n\n- 📘 [Docs site](https://noah-code.com/docs/look) — hosted, searchable user guide and reference\n- [User guide (in-repo)](docs/user-guide.md) — full feature reference, shortcuts, configuration, permissions, troubleshooting\n- [Architecture](docs/architecture.md) — how the Swift app + Rust core fit together\n- [Features](docs/features.md) — what's shipped, what's planned\n- [Contributing](CONTRIBUTING.md) — how to contribute\n- [Development](DEVELOPMENT.md) — building locally, repo layout, release process\n\n## Scope\n\nIn scope:\n\n- apps, files, folders, clipboard, command mode, translation, regex/path search\n- local-first behavior, zero telemetry\n- near-term plugin/extension exploration\n\nOut of scope for v1:\n\n- online-first behavior\n- semantic/vector search\n- full content indexing (names and metadata only)\n\n### Platform direction\n\n- **macOS** — shipped and stable (SwiftUI, native). This is the design source of truth.\n- **Windows + Linux** — a new shared Tauri v2 app (`apps/linows/`) is under active development. It targets both platforms with a single codebase (Rust backend, vanilla HTML/CSS/JS frontend). Current status:\n  - Core search, preview, multi-pick, clipboard history, translation — done\n  - Command mode (calc, pomo, kill, shell, sys) — done\n  - Settings screen (appearance, themes, blur, font autocomplete) — done\n  - Platform-aware blur (Mica/Acrylic on Windows, CSS backdrop-filter on Linux)\n  - Dynamic window scaling based on monitor resolution\n  - 6 built-in themes + Custom\n- **Windows (WinUI3)** — the current `apps/windows/` WinUI3/C# app is in maintenance mode (bug fixes only). It will be archived once the Tauri app reaches feature parity.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n## Contributors\n\nThanks to everyone who has contributed — see the [contributor graph](https://github.com/kunkka19xx/look/graphs/contributors).\n\nContribution flow: branch from `dev`, open PRs into `dev`. See [CONTRIBUTING.md](CONTRIBUTING.md) and [DEVELOPMENT.md](DEVELOPMENT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkunkka19xx%2Flook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkunkka19xx%2Flook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkunkka19xx%2Flook/lists"}