{"id":15050670,"url":"https://github.com/neved4/applist","last_synced_at":"2025-07-29T22:11:30.543Z","repository":{"id":246890374,"uuid":"824613701","full_name":"Neved4/applist","owner":"Neved4","description":" List app directories in macOS!","archived":false,"fork":false,"pushed_at":"2025-01-13T14:59:31.000Z","size":13,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-10T02:16:22.550Z","etag":null,"topics":["cli","command-line","darwin","macos","objective-c","shell-script","swift","terminal"],"latest_commit_sha":null,"homepage":"","language":"Objective-C++","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/Neved4.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-07-05T14:08:50.000Z","updated_at":"2025-01-13T14:59:36.000Z","dependencies_parsed_at":"2025-02-16T10:42:26.747Z","dependency_job_id":null,"html_url":"https://github.com/Neved4/applist","commit_stats":null,"previous_names":["neved4/listapps","neved4/applist"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neved4%2Fapplist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neved4%2Fapplist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neved4%2Fapplist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neved4%2Fapplist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Neved4","download_url":"https://codeload.github.com/Neved4/applist/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248142906,"owners_count":21054672,"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":["cli","command-line","darwin","macos","objective-c","shell-script","swift","terminal"],"created_at":"2024-09-24T21:28:50.211Z","updated_at":"2025-04-10T02:16:31.129Z","avatar_url":"https://github.com/Neved4.png","language":"Objective-C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"![macOS](https://img.shields.io/badge/macOS-000000?style=flat\u0026logo=apple\u0026logoColor=fff)\n![Swift Badge](https://img.shields.io/badge/Swift-F05138?logo=swift\u0026logoColor=fff\u0026style=flat)\n![Shell Script](https://img.shields.io/badge/Shell_Script-9DDE66?logo=gnubash\u0026logoColor=000\u0026style=flat)\n\n## `applist` - List app directories in macOS! 🚀\n\nThese utilities list app locations in [macOS]\n\nThe [Swift] (`68.2 ms`) and [Objective-C] (`78.4 ms`) implementations try to mimic\n`mdfind`'s (`29.1 ms`) behavior, but run slower than it.\n\n## Getting Started\n\n\u003e [!NOTE]\n\u003e _**This utility is only intended to run in [macOS].**_\n\n### Prerequisites\n\nWhen you are building [`applist`], ensure you have either:\n- A [Swift] compiler\n- An [Objective-C] compiler.\n\n### Installing\n\nIf you have [`brew`] installed, just run:\n```sh\n$ brew install Neved4/tap/applist\n```\n\nOtherwise, first clone the repo:\n```sh\n$ git clone https://github.com/Neved4/applist\n```\n\nTo build all variants, go to the project directory and run:\n```sh\n$ make all\n```\n\nAlternatively, to build the [Objective-C] version run:\n```sh\n$ clang -framework Cocoa -o applist-objc applist.mm\n```\n\nFor the [Swift] version, run:\n```sh\n$ swiftc -O applist.swift -o applist-swift\n```\n\nDone!\n\nAlternatively, if you'd rather not install or compile anything, feel free to\nadd it as a function to your shell `.profile`:\n```sh\napplist() {\n    mdfind \"kMDItemContentType == 'com.apple.application-bundle'\"\n}\n```\n\n## Usage\n\n```sh\n$ applist | grep \"Docker.app\"\n/Applications/Docker.app\n```\n\nThis comes handy for manual [Homebrew][`brew`] reinstalls that lie outside\nthe default install path:\n```sh\n$ brew reinstall --cask docker --applist $(applist | grep Docker)\n```\n\n## Benchmarks\n\nAll programs were benchmarked with [`hyperfine`] under [`arm64`]:\n\n| Command         |  Mean [ms] | Min [ms] | Max [ms] |    Relative |\n| :-------------- | ---------: | -------: | -------: | ----------: |\n| `applist-sh`    | 29.1 ± 1.7 |     27.2 |     33.7 |        1.00 |\n| `applist-objc`  | 68.2 ± 3.5 |     63.7 |     81.5 | 2.34 ± 0.18 |\n| `applist-swift` | 78.4 ± 4.2 |     71.0 |     89.9 | 2.69 ± 0.21 |\n\n## See Also\n\nFor other shell functions like `applist`, check out [apputils].\n\n## License\n\n[`applist`] is licensed under the terms of the [MIT License].\n\nSee the [LICENSE](LICENSE) file for details.\n\n[`applist`]: https://github.com/Neved4/applist\n[`arm64`]: https://en.wikipedia.org/wiki/AArch64\n[`brew`]: https://brew.sh/\n[`hyperfine`]: https://github.com/sharkdp/hyperfine\n[macOS]: https://www.apple.com/macos/\n[MIT License]: https://opensource.org/license/mit/\n[apputils]: https://github.com/Neved4/apputils\n[Objective-C]:\n    https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Introduction/Introduction.html\n[Swift]: https://www.swift.org/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneved4%2Fapplist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneved4%2Fapplist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneved4%2Fapplist/lists"}