{"id":48497447,"url":"https://github.com/sean01zhang/window-switcher","last_synced_at":"2026-04-07T13:01:10.204Z","repository":{"id":269989181,"uuid":"909053973","full_name":"sean01zhang/window-switcher","owner":"sean01zhang","description":"Window Switcher is a fuzzy-find window overlay for macOS","archived":false,"fork":false,"pushed_at":"2026-04-05T02:34:08.000Z","size":138,"stargazers_count":20,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-05T03:24:29.765Z","etag":null,"topics":["alt-tab","fuzzy-search","macos","window-switcher"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sean01zhang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-27T16:30:18.000Z","updated_at":"2026-04-05T02:12:56.000Z","dependencies_parsed_at":"2025-01-11T21:24:22.865Z","dependency_job_id":"3bfebe70-a24f-4bce-a4ee-f5eeae16c8e6","html_url":"https://github.com/sean01zhang/window-switcher","commit_stats":null,"previous_names":["sean01zhang/window-switcher"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/sean01zhang/window-switcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sean01zhang%2Fwindow-switcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sean01zhang%2Fwindow-switcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sean01zhang%2Fwindow-switcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sean01zhang%2Fwindow-switcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sean01zhang","download_url":"https://codeload.github.com/sean01zhang/window-switcher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sean01zhang%2Fwindow-switcher/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31513382,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"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":["alt-tab","fuzzy-search","macos","window-switcher"],"created_at":"2026-04-07T13:00:57.149Z","updated_at":"2026-04-07T13:01:10.199Z","avatar_url":"https://github.com/sean01zhang.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Window Switcher\n\nWindow Switcher is a simple searchable window switcher for macOS. \n\n![demo](https://github.com/user-attachments/assets/341cbfa8-b004-4d8c-a947-72eefe3411e9)\n\n## Usage\n\n\u003e [!Note]\n\u003e The app needs accessibility to get all windows and focus windows in the active space, and\n\u003e needs screen recording to get the window previews.\n\n1. Use the configured hotkey to open the window switcher. The default is `Option+Tab`.\n2. Type to search for a window, or use arrow keys to move your selection.\n3. Press `enter` to switch to the selected window.\n4. Use the menu bar extra toggle to have Window Switcher launch on startup.\n\n## Configuration\n\nWindow Switcher reads optional configuration from `~/.config/window-switcher/config.toml`.\n\nFull configuration docs live in [docs/configuration.md](docs/configuration.md).\n\n```toml\n[trigger]\nkey = \"tab\"\nmodifiers = [\"option\"]\n\n[navigation]\nnext = [\n  { key = \"j\", modifiers = [\"control\"] },\n  { key = \"n\", modifiers = [\"control\"] }\n]\nprevious = [\n  { key = \"k\", modifiers = [\"control\"] },\n  { key = \"p\", modifiers = [\"control\"] }\n]\n\n[result.window]\ntemplate = \"{app_name}: {title}\"\n\n[result.app]\ntemplate = \"Open {name}\"\n```\n\nSupported trigger modifiers are `command`, `option`, `control`, and `shift`. If the file is missing or invalid, Window Switcher falls back to the default `Option+Tab` trigger.\n\nConfiguration is loaded on app launch and reloaded the next time the switcher is opened. The app does not watch the file for live updates.\n\n## Installation\n\n### Homebrew\n\nThis app is also available as a cask on Homebrew.\n\n```sh\nbrew install --cask sean01zhang/formulae/window-switcher\n```\n\n### Manually\n\n1. Go to [releases](https://github.com/sean01zhang/window-switcher/releases) and download the latest version. The zip (`window-switcher-v#.#.#.zip`) can be found under the assets section.\n2. Unzip the downloaded file. It is recommended to move the app to the Applications folder.\n3. Open the app. You may need to give the app permissions to access accessibility and screen recording. \n\n## Upgrading\n\n### Homebrew\n\n```sh\nbrew upgrade window-switcher\n```\n\n## Features\n\n- [x] Fuzzy-search for windows\n- [x] Switch to windows\n- [x] List windows in current space\n- [ ] List windows in all spaces\n- [x] Get window previews\n- [x] User-defined hotkey bindings\n- [x] Fuzzy-search for applications\n- [x] Launch on startup\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsean01zhang%2Fwindow-switcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsean01zhang%2Fwindow-switcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsean01zhang%2Fwindow-switcher/lists"}