{"id":17685744,"url":"https://github.com/neved4/apputils","last_synced_at":"2026-03-03T14:34:32.382Z","repository":{"id":247562970,"uuid":"826171287","full_name":"Neved4/apputils","owner":"Neved4","description":" Find macOS app paths!","archived":false,"fork":false,"pushed_at":"2025-01-13T14:59:26.000Z","size":11,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-13T00:07:03.087Z","etag":null,"topics":["cli","command-line","darwin","fish-shell","macos","posix-shell","script","shell-script","terminal"],"latest_commit_sha":null,"homepage":"","language":"Shell","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-09T07:57:38.000Z","updated_at":"2025-01-13T14:59:31.000Z","dependencies_parsed_at":"2024-10-24T13:05:56.713Z","dependency_job_id":"c4bc5c77-9c18-48dc-bbc5-c55183eb7cbb","html_url":"https://github.com/Neved4/apputils","commit_stats":null,"previous_names":["neved4/apputils"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neved4%2Fapputils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neved4%2Fapputils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neved4%2Fapputils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neved4%2Fapputils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Neved4","download_url":"https://codeload.github.com/Neved4/apputils/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253843215,"owners_count":21972873,"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","fish-shell","macos","posix-shell","script","shell-script","terminal"],"created_at":"2024-10-24T10:28:55.207Z","updated_at":"2026-03-03T14:34:27.359Z","avatar_url":"https://github.com/Neved4.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n![macOS](https://img.shields.io/badge/macOS-000000?style=flat\u0026logo=apple\u0026logoColor=fff)\n![POSIX.1%2D2017](https://img.shields.io/badge/POSIX.1\u0026#8209;2017-00629B?logo=ieee\u0026logoColor=fff\u0026style=flat)\n![Shell Script](https://img.shields.io/badge/Shell_Script-4EAA25?logo=gnubash\u0026logoColor=fff\u0026style=flat)\n![Fish Shell](https://img.shields.io/badge/fish%20shell-34C534?logo=fishshell\u0026logoColor=fff\u0026style=flat)\n\n## `apputils` - Find macOS app paths! 🚀\n\n[`apputils`] is a collection of shell functions to find application bundle\npaths.\n\nAvailable for POSIX shells (e.g. [`bash`], [`ksh`], [`zsh`]) and [`fish`].\nBuilt on `mdfind`.\n\n## Getting Started\n\n\u003e [!NOTE]  \n\u003e This utility is meant to only be run on [macOS].\n\n### Prerequisites\n\nBefore using [`apputils`], ensure you have:\n\n- A _POSIX compatible shell_, or [`fish`].\n- [macOS] with `mdfind` command available.\n\n### Installation\n\nTo directly source the scripts and use their functions in your environment:\n```sh\n$ . /path/to/repo/app.sh\n$ appdir 'Docker'\n```\n\nIf you have [`brew`] installed, just run:\n```console\n$ brew install Neved4/tap/apputils\n```\n\nOtherwise, clone the repository or download the script files directly:\n```console\n$ git clone https://github.com/Neved4/apputils.git\n```\n\nNavigate with `cd` into the project directory and then run:\n```console\n$ ./install.sh\n```\n\n## Usage\n\nThe following options are available:\n```sh\nusage: app command [options] \u003capp\u003e\n\nOptions:\n    -i  Perform case-insensitive matching\n\nCommands:\n    list  List all installed apps.\n    find  List application full path.\n    dir   List application parent directory.\n```\n\nWhen added to your shell profile, the following functions are in your\nenvironment:\n```sh\napplist  List all installed apps.\nappfind  List application full path.\nappdir   List application parent directory.\n```\n\n## Examples\n\n_List all installed application bundles_:\n```sh\n$ app list\n```\n\n_Find the path of the application bundle, case-insensitive_:\n```sh\n$ app find -i 'Docker'\n```\n\n_Retrieve the directory containing the application bundle_:\n```sh\n$ app dir 'Docker'\n```\n\n_Call the former commands as functions in your shell profile_:\n```sh\n$ applist\n/Applications/Safari.app\n/System/Applications/Notes.app\n/System/Applications/Preview.app\n\n$ appfind -i 'docker'\n/Applications/Docker.app\n\n$ appdir 'Docker'\n/Applications\n```\n\n## Standards\n\nThe [app.sh](app.sh) script is compatible with [ISO\n9945:2009][POSIX.1-2017], also known as [POSIX.1-2017].[^posix]\n\n## License\n\n[`apputils`] is licensed under the terms of the [MIT License].\n   \nSee the [LICENSE](LICENSE) file for details.\n\n[^posix]: _IEEE Std 1003.1-2017: Standard for Information Technology — Portable_\n    _Operating System Interface (POSIX®)_, ISO/IEC/IEEE 9945:2009/COR\n    2:2017. URL: https://pubs.opengroup.org/onlinepubs/9699919799/\n\n[`apputils`]: https://github.com/Neved4/apputils\n[`bash`]: https://www.gnu.org/software/bash/\n[`brew`]: https://brew.sh/\n[`fish`]: https://fishshell.com/\n[`ksh`]: http://kornshell.com/\n[`zsh`]: https://www.zsh.org/\n[macOS]: https://www.apple.com/macos/\n[MIT License]: https://opensource.org/license/mit/\n[POSIX.1-2017]: https://pubs.opengroup.org/onlinepubs/9699919799/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneved4%2Fapputils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneved4%2Fapputils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneved4%2Fapputils/lists"}