{"id":30028641,"url":"https://github.com/systemsoftware/app-pane","last_synced_at":"2025-10-15T10:27:42.851Z","repository":{"id":301972800,"uuid":"1001051111","full_name":"systemsoftware/app-pane","owner":"systemsoftware","description":"macOS 26 Launchpad replacement (works with any macOS version supported by Electron)","archived":false,"fork":false,"pushed_at":"2025-07-17T18:57:39.000Z","size":9865,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-06T15:58:08.185Z","etag":null,"topics":["launcher","luanchpad","macos"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/systemsoftware.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}},"created_at":"2025-06-12T18:29:54.000Z","updated_at":"2025-07-17T18:57:42.000Z","dependencies_parsed_at":"2025-08-06T15:58:14.257Z","dependency_job_id":null,"html_url":"https://github.com/systemsoftware/app-pane","commit_stats":null,"previous_names":["systemsoftware/app-pane"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/systemsoftware/app-pane","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemsoftware%2Fapp-pane","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemsoftware%2Fapp-pane/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemsoftware%2Fapp-pane/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemsoftware%2Fapp-pane/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/systemsoftware","download_url":"https://codeload.github.com/systemsoftware/app-pane/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemsoftware%2Fapp-pane/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271854475,"owners_count":24834453,"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","status":"online","status_checked_at":"2025-08-24T02:00:11.135Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["launcher","luanchpad","macos"],"created_at":"2025-08-06T15:47:58.358Z","updated_at":"2025-10-15T10:27:42.767Z","avatar_url":"https://github.com/systemsoftware.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# App Pane\n\n**App Pane** is a macOS Electron application that acts as a visual app launcher and manager. It scans installed applications, allows for quick launching, pinning, hiding, and organizing apps, and includes cache management, icon indexing, and a customizable global shortcut.\n\n\n\n## 🚀 Features\n\n* 🔍 Automatically scans and indexes installed macOS applications.\n* 📌 Pin or unpin apps for quick access.\n* 🙈 Hide apps from view (but keep them searchable).\n* 🖼️ Caches and displays app icons.\n* 🗂️ Reorder apps manually or alphabetically (A–Z / Z–A).\n* 🔁 Automatic cache reloading every 5 minutes.\n* 🛠️ Reindex apps or delete the cache via the UI.\n* 🧭 Open apps or reveal them in Finder.\n* 🎛️ Dock icon visibility toggle.\n* ⌨️ Global shortcut support to quickly toggle the app's visibility.\n\n\n\n## 🧱 Built With\n\n* [Electron](https://www.electronjs.org/)\n* [Node.js](https://nodejs.org/)\n* [electron-prompt](https://www.npmjs.com/package/electron-prompt)\n\n\n\n## 📁 Folder Structure\n\n```\nAppPane/\n├── index.html              # Main UI\n├── preload.js              # Preload script for IPC\n├── main.js                 # Main Electron process (provided above)\n├── update                  # Updater executable (copied to temp folder)\n├── prompt.css              # Custom styling for prompts\n```\n\n\n\n## 🖥️ Requirements\n\n* macOS (due to `open` and `Finder`-specific features)\n* Node.js \u0026 npm installed\n* Electron (via `npm install`)\n\n\n\n## 🛠️ Installation\n\n```bash\ngit clone https://github.com/systemsoftware/app-pane.git\ncd app-pane\nnpm install\n```\n\n\n\n## 🏁 Run the App\n\n```bash\nnpm start\n```\n\n\n\n## 🔧 Customization\n\n* To **hide the dock icon**, a file named `hide-dock` is placed in `userData` path (`~/Library/Application Support/App Pane/`).\n* To **set a global shortcut**, a `shortcut` file is created in the same directory.\n* Use the right-click menu inside the app to modify these settings.\n\n\n\n## 💾 App Cache \u0026 Icon Storage\n\n* App metadata:\n  `~/Library/Application Support/App Pane/apps.json`\n* Cached app icons:\n  `~/Library/Application Support/App Pane/app-icons/`\n\n\n\n## ⚠️ Safety Notes\n\n* On reindexing or deleting cache, the app will relaunch or exit automatically.\n* Cached icon folders and metadata files will be removed.\n\n\n\n## 🧪 Development Notes\n\n* The updater is a separate executable copied to a temp directory and invoked as needed.\n* IPC handlers manage app data, UI actions, and user input securely and asynchronously.\n* Reloading happens every 5 minutes to reflect app changes.\n\n\n\n## 📚 Global Shortcut Help\n\nTo define a shortcut (e.g., `Cmd+Shift+A`), refer to [Electron Accelerator Docs](https://www.electronjs.org/docs/latest/api/accelerator#available-modifiers)\n\n## 📄 License\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystemsoftware%2Fapp-pane","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsystemsoftware%2Fapp-pane","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystemsoftware%2Fapp-pane/lists"}