{"id":17527029,"url":"https://github.com/angelespejo/umac","last_synced_at":"2025-07-16T16:32:36.424Z","repository":{"id":148783040,"uuid":"601319752","full_name":"angelespejo/umac","owner":"angelespejo","description":"⚡️🍎🐢 Terminal utilities for MacOS: install apps, force close apps, clear cache, add desk notifications, change shell, etc.","archived":false,"fork":false,"pushed_at":"2025-03-07T01:31:31.000Z","size":4285,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-14T16:16:08.263Z","etag":null,"topics":["apple","applescript","bash","bin","darwin","macos","shell","terminal"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/angelespejo.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":"2023-02-13T20:24:21.000Z","updated_at":"2025-07-08T05:20:56.000Z","dependencies_parsed_at":"2023-05-29T00:15:18.549Z","dependency_job_id":null,"html_url":"https://github.com/angelespejo/umac","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/angelespejo/umac","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angelespejo%2Fumac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angelespejo%2Fumac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angelespejo%2Fumac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angelespejo%2Fumac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/angelespejo","download_url":"https://codeload.github.com/angelespejo/umac/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angelespejo%2Fumac/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265334160,"owners_count":23748960,"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":["apple","applescript","bash","bin","darwin","macos","shell","terminal"],"created_at":"2024-10-20T15:03:00.232Z","updated_at":"2025-07-16T16:32:36.372Z","avatar_url":"https://github.com/angelespejo.png","language":"TypeScript","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# umac\n\n[![Web](https://img.shields.io/badge/Web-grey?style=for-the-badge\u0026logoColor=white)](https://pigeonposse.com)\n[![About Us](https://img.shields.io/badge/About%20Us-grey?style=for-the-badge\u0026logoColor=white)](https://pigeonposse.com/about)\n[![Donate](https://img.shields.io/badge/Donate-pink?style=for-the-badge\u0026logoColor=white)](https://pigeonposse.com/contribute)\n[![Twitter](https://img.shields.io/badge/Twitter-black?style=for-the-badge\u0026logoColor=white\u0026logo=twitter)](https://twitter.com/pigeonposse_)\n[![Instagram](https://img.shields.io/badge/Instagram-black?style=for-the-badge\u0026logoColor=white\u0026logo=instagram)](https://www.instagram.com/pigeon.posse/)\n[![Medium](https://img.shields.io/badge/Medium-black?style=for-the-badge\u0026logoColor=white\u0026logo=medium)](https://medium.com/@pigeonposse)\n\n[![BANNER](https://github.com/angelespejo/umac/blob/main/docs/public/banner.png?raw=true)](https://github.com/angelespejo/umac)\n\n[![License](https://img.shields.io/github/license/pigeonposse/umac?style=for-the-badge\u0026color=green\u0026logoColor=white)](/LICENSE)\n[![Version](https://img.shields.io/npm/v/umac?style=for-the-badge\u0026color=blue\u0026label=Version)](https://www.npmjs.com/package/umac)\n\nTerminal utilities for MacOS: install apps, force close apps, clear cache, add desk notifications, change shell, etc.\n\n## Table of contents\n\n- [What can we do with `umac`?](#what-can-we-do-with-umac)\n- [🗝 Prerequesites](#-prerequesites)\n- [🔢 Use Executable](#-use-executable)\n- [🟢 JavaScript / Typescript library](#-javascript--typescript-library)\n- [🚀 CLI](#-cli)\n- [🔑 Installation](#-installation)\n- [⚙️ Usage](#-usage)\n  - [Apps](#apps)\n    - [Install](#install)\n    - [Uninstall](#uninstall)\n    - [Search](#search)\n    - [Unidentified apps](#unidentified-apps)\n    - [Close](#close)\n  - [Cache](#cache)\n    - [Open cache Directory in Finder](#open-cache-directory-in-finder)\n    - [Remove](#remove)\n  - [Open](#open)\n    - [Examples](#examples)\n  - [Desktop](#desktop)\n  - [Interact / Interacting](#interact--interacting)\n    - [Notification](#notification)\n    - [Dialog](#dialog)\n    - [Alert](#alert)\n    - [Say](#say)\n    - [Prompt](#prompt)\n  - [Terminal](#terminal)\n    - [Change](#change)\n    - [List](#list)\n    - [Current](#current)\n  - [Spotlight](#spotlight)\n  - [Run](#run)\n    - [jxa](#jxa)\n    - [osascript](#osascript)\n    - [JS or TS](#js-or-ts)\n    - [bash](#bash)\n    - [Python](#python)\n  - [System](#system)\n    - [Update](#update)\n    - [Shutdown](#shutdown)\n    - [Reboot](#reboot)\n    - [Hardware](#hardware)\n    - [Version](#version)\n  - [Finder](#finder)\n  - [Workflow](#workflow)\n  - [Appearance](#appearance)\n    - [Dark mode](#dark-mode)\n    - [Color](#color)\n- [☑️ TO DO](#-to-do)\n- [➕ More](#-more)\n- [👨‍💻 Development](#-development)\n- [❤️ Donate](#-donate)\n- [📜 License](#-license)\n- [✨ About us](#-about-us)\n\n\n## What can we do with `umac`?\n\n[![HELP](https://github.com/angelespejo/umac/blob/main/docs/public/help.png?raw=true)](https://github.com/angelespejo/umac)\n\n- Set dialogs\n- Set notifications\n- Set voice messages\n- open files \u0026 URLs\n- Close apps\n- Clear cache\n- Install apps\n- Change terminal shell\n- Add workflows \n- Run scripts\n- ...\n\n## 🗝 Prerequesites\n\nHave a system based on **DarwinOS**, that is, any **Apple** computer 🍎\n\n## 🔢 Use Executable\n\nYou can download the binary directly from the [releases](https://github.com/angelespejo/umac/releases) section\n\n## 🟢 JavaScript / Typescript library \n\n\u003e Now You can use `umac` on your **JS** / **TS** project\n\n## 🚀 CLI\n\nExecute cli with:\n\n```bash\numac \u003ccommand\u003e [...flags]\n```\n\n\n\n## 🔑 Installation\n\n```bash \nnpm install umac\n# or\npnpm install umac\n# or\nyarn add umac\n# or\nbun add umac\n# or\ndeno add umac\n```\n\n## ⚙️ Usage\n\n```bash\numac [option/s] [--flags/s]\n```\n\n```bash\numac [option/s] [--flags/s] --help\n```\n\nWith **umac** you can do many different things. The idea could be to add more and more, who knows 😎\n\nHere is a list of how to use **umac** \n\n### Apps\n\n```bash\numac app --help\n```\n\n#### Install\n\nInstall apps using ```Homebrew```. \n\n\u003e Don't worry if ```Homebrew``` is not installed on your system, **umac** should do it for you automatically 🔮\n\n```bash\numac app install appName1 appName2\n# or\numac app i appName1 appName2\n```\n\n#### Uninstall\n\nUninstall apps using ```Homebrew```.\n\n```bash\numac app uninstall appName1 appName2\n# or\numac app u appName1 appName2\n```\n\n#### Search\n\nSearch apps in HomeBrew.\n\n```bash\numac app search appName\n# or\numac app s appName\n```\n\n#### Unidentified apps\n\n```bash\numac app undev --help\n```\n\nChange or show status for unidentificated apps.\n\nShow status for no identificated apps\n\n```bash\numac app undev \n```\n\nChange status for no identificated apps\n\n```bash\numac app dev --enable\n```\n\n```bash\numac app dev --disable\n```\n\n#### Close\n\n```bash\numac app close --help\n```\n\n##### Examples\n\nClose apps from a list\n\n```bash\numac app close --ask\n```\n\nClose all apps\n\n```bash\numac app close '*'\n```\n\nClose specific apps\n\n```bash\numac app close app1 app2\n```\n\nClose all apps that contains avast name\n\n```bash\numac app close \"*Avast*\"\n```\n\n### Cache\n\n```bash\numac cache --help\n```\n\n#### Open cache Directory in Finder\n\n```bash\numac cache open\n```\n\n#### Remove\n\nRemove macOS cache from a list.\n\n```bash\numac cache rm\n```\n\n### Open\n\n```bash\numac open --help\n```\n\n#### Examples\n\n```bash\n# Open path in Finder or URL in default browser.\numac open {URL/path} \n# Open in Safari\numac open {URL/path} --safari \n# Open in Firefox\numac open {URL/path} --firefox \n# Open in Chrome\numac open {URL/path} --chrome \n# Open in Visual Studio Code\numac open {path} --vscode \n# ...\n\n```\n\n### Desktop \n\n```bash\numac desktop --help\n# or (short command)\numac desk -h\n```\n\n### Interact / Interacting\n\n```bash\numac interacting --help\n# or (short command)\numac interact -h\n```\n\n#### Notification  \n\nSet a macOS notification  \n\n```bash\numac interact notification --help\n```\n\n#### Dialog  \n\nSet a macOS dialog  \n\n```bash\numac interact dialog --help\n```\n\n#### Alert  \n\nSet a macOS alert  \n\n```bash\numac interact alert --help\n```\n\n#### Say  \n\nDisplay voice message  \n\n```bash\numac interact say --help\n```\n\n#### Prompt  \n\nSet custom prompts like text, choices, files, color, etc.  \n\n```bash\numac interact prompt --help\n```\n\n\n### Terminal\n\n```bash\numac terminal --help\n# or (short command)\numac term --help\n```\n\n#### Change\nChange shell.\n\n```bash\numac terminal shell change\n```\n\n#### List\n\nList available shells.\n\n```bash\numac terminal shell list\n```\n\n#### Current\n\nView current shell.\n\n```bash\numac terminal shell current\n```\n\n### Spotlight\n\nMacOS Spotlight utils\n\n```bash\numac spotlight--help\n```\n\nTo see Spotlight status.\n\n```bash\numac spotlight \u003cpath\u003e\n```\n\nTo enable Spotlight.\n\n```bash\numac spotlight --enable\n```\n\n\nTo disable Spotlight.\n\n```bash\numac spotlight --disable\n```\n\nToggle Spotlight status.\n\n```bash\numac spotlight --toggle\n```\n\n### Run\n\nRun multiple language scripts (applescript, jxa, osascript, python, js, bash etc)\n\n```bash\numac run --help\n```\n#### jxa\n\nRun jxa file script\n\n```bash\numac run jxa --help\n```\n\n#### osascript\n\nRun osascript file script\n\n```bash\numac run osascript --help\n```\n\n#### JS or TS\n\nRun js|ts file script\n\n```bash\numac run node|js|ts --help\n```\n\n#### bash\n\nRun bash file script\n\n```bash\numac run bash --help\n```\n\n#### Python\n\nRun python file script\n\n```bash\numac run python --help\n```\n\n### System\n\nRun multiple language scripts (applescript, jxa, osascript, python, js, bash etc)\n\n```bash\numac system --help\n# or (short command)\numac sys -h\n```\n\n#### Update\n\nSystem updates\n\n```bash\numac system update --help\n# or (short command)\numac sys up -h\n```\n\n#### Shutdown\n\nClose down the system at a given time\n\n```bash\numac system shutdown --help\n# or (short command)\numac sys down -h\n```\n\n#### Reboot\n\nReboot system\n\n```bash\numac system reboot --help\n# or (short command)\numac sys reboot -h\n```\n\n#### Hardware\n\nShow hardware information\n\n```bash\numac system hardware --help\n# or (short command)\numac sys hardware -h\n```\n\n#### Version\n\nShow system version\n\n```bash\numac system version --help\n# or (short command)\numac sys version -h\n```\n\n### Finder\n\nMacOS Finder utils\n\n```bash\numac finder --help\n```\n\n### Workflow\n\nMacOS Workflow utils\n\n```bash\numac workflow --help\n# or (short command)\numac wf -h\n```\n\n### Appearance\n\nMacOS Appearance utils\n\n```bash\numac appearance --help\n```\n\n#### Dark mode\n\n```bash\numac appearance dark-mode --help\n```\n\n#### Color\n\n```bash\numac appearance color --help\n```\n\n## ☑️ TO DO\n\n- [Read more](https://github.com/angelespejo/umac/blob/main/docs/todo/v2.md)\n## ➕ More\n\n- 🍎 [Umac](https://github.com/angelespejo/umac/tree/main/packages/umac)\n- ⚒️ [Utils](https://github.com/angelespejo/umac/tree/main/packages/utils)\n- 🔌 [Plugins](https://github.com/angelespejo/umac/tree/main/packages/plugin)\n  - [App](https://github.com/angelespejo/umac/tree/main/packages/plugin/app)\n  - [Appearance](https://github.com/angelespejo/umac/tree/main/packages/plugin/appearance)\n  - [Cache](https://github.com/angelespejo/umac/tree/main/packages/plugin/cache)\n  - [Desktop](https://github.com/angelespejo/umac/tree/main/packages/plugin/desktop)\n  - [Finder](https://github.com/angelespejo/umac/tree/main/packages/plugin/finder)\n  - [Interacting](https://github.com/angelespejo/umac/tree/main/packages/plugin/interacting)\n  - [Open](https://github.com/angelespejo/umac/tree/main/packages/plugin/open)\n  - [Run](https://github.com/angelespejo/umac/tree/main/packages/plugin/run)\n  - [Spotlight](https://github.com/angelespejo/umac/tree/main/packages/plugin/spotlight)\n  - [System](https://github.com/angelespejo/umac/tree/main/packages/plugin/system)\n  - [Terminal](https://github.com/angelespejo/umac/tree/main/packages/plugin/terminal)\n  - [Workflow](https://github.com/angelespejo/umac/tree/main/packages/plugin/workflow)\n\n\n---\n\n## 👨‍💻 Development\n\n__umac__ is an open-source project and its development is open to anyone who wants to participate.\n\n[![Issues](https://img.shields.io/badge/Issues-grey?style=for-the-badge)](https://github.com/angelespejo/umac/issues)\n[![Pull requests](https://img.shields.io/badge/Pulls-grey?style=for-the-badge)]({{const.pkg.repository.url}}/pulls)\n[![Read more](https://img.shields.io/badge/Read%20more-grey?style=for-the-badge)]({{const.pkg.homepage}})\n\n## ❤️ Donate\n\nHelp us to develop more interesting things.\n\n[![Donate](https://img.shields.io/badge/Donate-grey?style=for-the-badge)](https://pigeonposse.com/contribute)\n\n## 📜 License\n\nThis software is licensed with __[GPL-3.0](https://github.com/angelespejo/umac/blob/main/LICENSE)__.\n\n[![Read more](https://img.shields.io/badge/Read-more-grey?style=for-the-badge)](https://github.com/angelespejo/umac/blob/main/LICENSE)\n\n## ✨ About us\n\n*PigeonPosse* is a __code development collective__ focused on creating practical and interesting tools that help developers and users enjoy a more agile and comfortable experience. Our projects cover various programming sectors and we do not have a thematic limitation in terms of projects.\n\n[![More](https://img.shields.io/badge/Read-more-grey?style=for-the-badge)](https://github.com/pigeonposse)\n\n---\n\n\n\n[![Web](https://img.shields.io/badge/Web-grey?style=for-the-badge\u0026logoColor=white)](https://pigeonposse.com)\n[![About Us](https://img.shields.io/badge/About%20Us-grey?style=for-the-badge\u0026logoColor=white)](https://pigeonposse.com/about)\n[![Donate](https://img.shields.io/badge/Donate-pink?style=for-the-badge\u0026logoColor=white)](https://pigeonposse.com/contribute)\n[![Twitter](https://img.shields.io/badge/Twitter-black?style=for-the-badge\u0026logoColor=white\u0026logo=twitter)](https://twitter.com/pigeonposse_)\n[![Instagram](https://img.shields.io/badge/Instagram-black?style=for-the-badge\u0026logoColor=white\u0026logo=instagram)](https://www.instagram.com/pigeon.posse/)\n[![Medium](https://img.shields.io/badge/Medium-black?style=for-the-badge\u0026logoColor=white\u0026logo=medium)](https://medium.com/@pigeonposse)\n\n\u003c!--\n\n██████╗ ██╗ ██████╗ ███████╗ ██████╗ ███╗   ██╗██████╗  ██████╗ ███████╗███████╗███████╗\n██╔══██╗██║██╔════╝ ██╔════╝██╔═══██╗████╗  ██║██╔══██╗██╔═══██╗██╔════╝██╔════╝██╔════╝\n██████╔╝██║██║  ███╗█████╗  ██║   ██║██╔██╗ ██║██████╔╝██║   ██║███████╗███████╗█████╗  \n██╔═══╝ ██║██║   ██║██╔══╝  ██║   ██║██║╚██╗██║██╔═══╝ ██║   ██║╚════██║╚════██║██╔══╝  \n██║     ██║╚██████╔╝███████╗╚██████╔╝██║ ╚████║██║     ╚██████╔╝███████║███████║███████╗\n╚═╝     ╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═╝  ╚═══╝╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝\n                                                                                        \n                                                                                        \n                                                                                        \n█████╗█████╗█████╗█████╗█████╗█████╗█████╗                                              \n╚════╝╚════╝╚════╝╚════╝╚════╝╚════╝╚════╝                                              \n                                                                                        \n                                                                                        \n                                                                                        \n██╗   ██╗███╗   ███╗ █████╗  ██████╗                                                    \n██║   ██║████╗ ████║██╔══██╗██╔════╝                                                    \n██║   ██║██╔████╔██║███████║██║                                                         \n██║   ██║██║╚██╔╝██║██╔══██║██║                                                         \n╚██████╔╝██║ ╚═╝ ██║██║  ██║╚██████╗                                                    \n ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝                                                    \n                                                                                        \n- Author: [Angelo](https://github.com/angelespejo)\n\n\n\n--\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fangelespejo%2Fumac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fangelespejo%2Fumac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fangelespejo%2Fumac/lists"}