umac

Terminal utilities for MacOS

Table of contents

• 🍎 umac (toolkit)
• 🗝 Prerequesites
• 🟢 JavaScript / Typescript library
• 🔑 Installation
• ⚙️ Usage
  • Apps
    • Install
    • Uninstall
    • Search
    • Unidentified apps
    • Close
  • Cache
    • Open cache Directory in Finder
    • Remove
  • Open
    • Examples
  • Desktop
  • Interact / Interacting
    • Notification
    • Dialog
    • Alert
    • Say
    • Prompt
  • Terminal
    • Change
    • List
    • Current
  • Spotlight
  • Run
    • jxa
    • osascript
    • JS or TS
    • bash
    • Python
  • System
    • Update
    • Shutdown
    • Reboot
    • Hardware
    • Version
  • Finder
  • Workflow
  • Appearance
    • Dark mode
    • Color
• ☑️ TO DO
• ➕ More
• 👨‍💻 Development
• ❤️ Donate
• 📜 License
• ✨ About us

🍎 umac (toolkit)

Read more

🗝 Prerequesites

Have a system based on DarwinOS, that is, any Apple computer 🍎

🟢 JavaScript / Typescript library

Now You can use umac on your JS / TS project

🔑 Installation

npm install umac
# or
pnpm install umac
# or
yarn add umac
# or
bun add umac
# or
deno add umac

⚙️ Usage

umac [option/s] [--flags/s]

umac [option/s] [--flags/s] --help

With umac you can do many different things. The idea could be to add more and more, who knows 😎

Here is a list of how to use umac

Apps

umac app --help

Install

Install apps using Homebrew.

Don't worry if Homebrew is not installed on your system, umac should do it for you automatically 🔮

umac app install appName1 appName2
# or
umac app i appName1 appName2

Uninstall

Uninstall apps using Homebrew.

umac app uninstall appName1 appName2
# or
umac app u appName1 appName2

Search

Search apps in HomeBrew.

umac app search appName
# or
umac app s appName

Unidentified apps

umac app undev --help

Change or show status for unidentificated apps.

Show status for no identificated apps

umac app undev 

Change status for no identificated apps

umac app dev --enable

umac app dev --disable

Close

umac app close --help

Examples

Close apps from a list

umac app close --ask

Close all apps

umac app close '*'

Close specific apps

umac app close app1 app2

Close all apps that contains avast name

umac app close "*Avast*"

Cache

umac cache --help

Open cache Directory in Finder

umac cache open

Remove

Remove macOS cache from a list.

umac cache rm

Open

umac open --help

Examples

# Open path in Finder or URL in default browser.
umac open {URL/path} 
# Open in Safari
umac open {URL/path} --safari 
# Open in Firefox
umac open {URL/path} --firefox 
# Open in Chrome
umac open {URL/path} --chrome 
# Open in Visual Studio Code
umac open {path} --vscode 
# ...

Desktop

umac desktop --help
# or (short command)
umac desk -h

Interact / Interacting

umac interacting --help
# or (short command)
umac interact -h

Notification

Set a macOS notification

umac interact notification --help

Dialog

Set a macOS dialog

umac interact dialog --help

Alert

Set a macOS alert

umac interact alert --help

Say

Display voice message

umac interact say --help

Prompt

Set custom prompts like text, choices, files, color, etc.

umac interact prompt --help

Terminal

umac terminal --help
# or (short command)
umac term --help

Change

Change shell.

umac terminal shell change

List

List available shells.

umac terminal shell list

Current

View current shell.

umac terminal shell current

Spotlight

MacOS Spotlight utils

umac spotlight--help

To see Spotlight status.

umac spotlight <path>

To enable Spotlight.

umac spotlight --enable

To disable Spotlight.

umac spotlight --disable

Toggle Spotlight status.

umac spotlight --toggle

Run

Run multiple language scripts (applescript, jxa, osascript, python, js, bash etc)

umac run --help

jxa

Run jxa file script

umac run jxa --help

osascript

Run osascript file script

umac run osascript --help

JS or TS

Run js|ts file script

umac run node|js|ts --help

bash

Run bash file script

umac run bash --help

Python

Run python file script

umac run python --help

System

Run multiple language scripts (applescript, jxa, osascript, python, js, bash etc)

umac system --help
# or (short command)
umac sys -h

Update

System updates

umac system update --help
# or (short command)
umac sys up -h

Shutdown

Close down the system at a given time

umac system shutdown --help
# or (short command)
umac sys down -h

Reboot

Reboot system

umac system reboot --help
# or (short command)
umac sys reboot -h

Hardware

Show hardware information

umac system hardware --help
# or (short command)
umac sys hardware -h

Version

Show system version

umac system version --help
# or (short command)
umac sys version -h

Finder

MacOS Finder utils

umac finder --help

Workflow

MacOS Workflow utils

umac workflow --help
# or (short command)
umac wf -h

Appearance

MacOS Appearance utils

umac appearance --help

Dark mode

umac appearance dark-mode --help

Color

umac appearance color --help

☑️ TO DO

• Read more

➕ More

• 🍎 Umac
• ⚒️ Utils
• 🔌 Plugins
  • App
  • Cache
  • Finder
  • Appearance
  • Desktop
  • Interacting
  • Open
  • Run
  • Spotlight
  • System
  • Terminal
  • Workflow

👨‍💻 Development

umac is an open-source project and its development is open to anyone who wants to participate.

❤️ Donate

Help us to develop more interesting things.

📜 License

This software is licensed with GPL-3.0.

✨ About us

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.