{"id":21694201,"url":"https://github.com/emadda/robata","last_synced_at":"2025-04-12T10:50:22.310Z","repository":{"id":253326036,"uuid":"843163223","full_name":"emadda/robata","owner":"emadda","description":"macOS window selector","archived":false,"fork":false,"pushed_at":"2024-08-27T13:18:42.000Z","size":8,"stargazers_count":12,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-05T05:13:11.426Z","etag":null,"topics":["macos"],"latest_commit_sha":null,"homepage":"https://robata.app","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emadda.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}},"created_at":"2024-08-15T23:16:55.000Z","updated_at":"2024-10-18T22:45:32.000Z","dependencies_parsed_at":"2024-08-26T17:30:15.956Z","dependency_job_id":"e5610ca4-3cd7-4987-9baf-791ff0edb272","html_url":"https://github.com/emadda/robata","commit_stats":null,"previous_names":["emadda/robata"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emadda%2Frobata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emadda%2Frobata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emadda%2Frobata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emadda%2Frobata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emadda","download_url":"https://codeload.github.com/emadda/robata/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248557844,"owners_count":21124165,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["macos"],"created_at":"2024-11-25T18:27:14.771Z","updated_at":"2025-04-12T10:50:22.279Z","avatar_url":"https://github.com/emadda.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Robata\n\nPut it on the grill.\n\nRobata is a window selector app for macOS.\n\n[Download for macOS](https://github.com/emadda/robata/releases/download/v-001/Robata-001.dmg).\n\nPlease [report any issues or feedback you have](https://github.com/emadda/robata/issues).\n\nYou can also contact me at [enzo@robata.app](mailto:enzo@robata.app).\n\n\nLearn more: [robata.app](https://robata.app).\n\n# Keyboard shortcuts\n\n\n- Open/close Robata UI to show windows\n\t- Touch the bottom left of any trackpads attached.\n\t- cmd-§\n\t\t- (or cmd-` for US keyboards)\n\t\t- The § or ` key is above the tab key.\n\t\t- You can customize this in the settings.\n\t\t- Works similarly to cmd-tab.\n\n\n\n- z\n\t- Zoom.\n\t- If you hover over a window the zoom is centered there, otherwise the closest image center is used.\n\n- c\n\t- Close window currently under mouse.\n\n- cmd-d\n\t- Discover windows.\n\t- Window discovery only needs to be done when Robata first opens - macOS window APIs only allow reading windows that have been on an active space.\n\t- Spaces can only be switched to when an app focuses on one of its own windows on that space.\n\t- To find all your windows, this creates a small window on each space, visits each space, and then closes.\n\t- It should take around 10 seconds.\n\t- Or you can manually switch to different spaces instead.\n\n\n# Custom methods of opening\n\nBy default the bottom left of any attached trackpads open Robata. You just need to rest your finger lightly (no tap needed).\n\nYou can customize this via Robata -\u003e Settings.\n\n\nYou can attach your own keyboard or mouse shortcuts to toggle Robata using any of these methods:\n\n\n- Via the .app file.\n\n```\n# Toggles the UI.\nopen /Applications/Robata.app\n```\n\n\n- Custom URL schemes.\n\n```\nrobata://show\nrobata://hide\nrobata://toggle\n```\n\nUsed in a shell script:\n```sh\n#!/bin/sh\nopen \"robata://toggle\"\n```\n\n\n- Tap the Dock icon.\n- Apple Shortcuts.\n- `Settings ▶ Keyboard ▶ Keyboard Shortcuts... ▶ App Shortcuts ▶ Add Robata` \n- Alt-tab.\n\n\n# Permissions\n\nRobata requires:\n\n- Settings -\u003e Privacy \u0026 Security -\u003e Accessibility \n- Settings -\u003e Privacy \u0026 Security -\u003e Screen \u0026 System Audio Recording\n\n\nDrag and drop the app onto these lists and enable the toggle.\n\nIt only uses the screenshot API whilst the UI is being viewed. Accessibility is required for access to window titles, sizes and to the trackpad.\n\n\n# Security: Apple Notarized\n\nRobata is [notarized](https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution) by Apple, which has the following benefits:\n\n- It has been scanned and verified to be malware free.\n- The app cannot be modified in any way, so the code that was checked by Apple is the code that runs.\n- The developer ID is verified.\n- Apple can remotely disable any apps found to contain malware in the future.\n\nRobata does not access the network or disk whilst it runs.\n\n\n# Acknowledgements\n\nThanks to the developers of open source projects for their discovery and documentation of the Apple APIs that allows reading macOS spaces.\n\nYou may want to give them a try if Robata does not suit your needs:\n\n- [https://github.com/Hammerspoon/hammerspoon](https://github.com/Hammerspoon/hammerspoon/)\n- [https://github.com/lwouis/alt-tab-macos](https://github.com/lwouis/alt-tab-macos)\n- [https://github.com/rxhanson/Rectangle](https://github.com/rxhanson/Rectangle)\n- [https://github.com/koekeishiya/yabai](https://github.com/koekeishiya/yabai)\n- [https://github.com/ianyh/Amethyst](https://github.com/ianyh/Amethyst)\n- [https://github.com/kasper/phoenix](https://github.com/kasper/phoenix)\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femadda%2Frobata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femadda%2Frobata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femadda%2Frobata/lists"}