Skip to content
BranchesTags

Repository files navigation

umac

Web About Us Donate Twitter Instagram Medium

BANNER

License Version

Terminal utilities for MacOS: install apps, force close apps, clear cache, add desk notifications, change shell, etc.

Table of contents

What can we do with umac?

HELP

  • Set dialogs
  • Set notifications
  • Set voice messages
  • open files & URLs
  • Close apps
  • Clear cache
  • Install apps
  • Change terminal shell
  • Add workflows
  • Run scripts
  • ...

🗝 Prerequisites

  • A system based on DarwinOS, that is, any Apple computer 🍎

🚀 Quick start

JavaScript / TypeScript library

You can also use umac as a JS / TS library directly in your project.

CLI

Quickly run the command line with:

npx umac <command> [...flags]

Use Executable

You can download the binary directly from the releases section

🔑 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

ℹ️ You can also use umac/app independently.

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*"

List

List system apps.

umac app list
# or
umac app list '!Avast*' '!*.avast*'

Cache

umac cache --help

ℹ️ You can also use umac/cache independently.

Open cache Directory in Finder

umac cache open

Remove

Remove macOS cache from a list.

umac cache rm

Open

umac open --help

ℹ️ You can also use umac/open independently.

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

ℹ️ You can also use umac/desktop independently.

Remove

Remove Desktop image.

umac desktop remove
# or
umac desktop remove imageName

Change

Change the Desktop image in the desktop pictures directory.

umac desktop change imagePath

Add

Add a Desktop image to the desktop pictures directory.

umac desktop add imagePath
# or
umac desktop add imagePath --dir
# or
umac desktop add imagePath --sys

Interact / Interacting

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

ℹ️ You can also use umac/interacting independently.

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

ℹ️ You can also use umac/terminal independently.

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

ℹ️ You can also use umac/spotlight independently.

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

ℹ️ You can also use umac/run independently.

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

ℹ️ You can also use umac/system independently.

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

ℹ️ You can also use umac/finder independently.

Close

Close all Finder windows and force exit from Finder.

umac finder close

Reload

Reload Finder.

umac finder reload

Dotfiles

Show, hide or toggle dotfiles visibility.

umac finder dotfiles
# or
umac finder dotfiles --toggle
# or
umac finder dotfiles --enable
# or
umac finder dotfiles --disable

Workflow

MacOS Workflow utils

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

ℹ️ You can also use umac/workflow independently.

List

Lists all available workflows in the services directory.

umac workflow list

Copy

Copies all workflows to the specified directory.

umac workflow copy --output <dir>

Open dir

Opens the services directory in the file explorer.

umac workflow open-dir

Open

Prompts the user to select and open a workflow with Automator.

umac workflow open

New

Opens a new project in Automator.

umac workflow new

Appearance

MacOS Appearance utils

umac appearance --help

ℹ️ You can also use umac/appearance independently.

Dark mode

Dark mode utilities. Toggle, set, get...

umac appearance dark-mode
# or
umac appearance dark-mode --toggle
# or
umac appearance dark-mode --enable
# or
umac appearance dark-mode --disable

Color

Color utilities. Like accent, highlight...

umac appearance color
# or
umac appearance color accent
# or
umac appearance color highlight

Disk

MacOS Disk utils

umac disk --help

ℹ️ You can also use umac/disk independently.

List

List disks and their partitions.

umac disk list
# or
umac disk list --res=json

Space

Show disk space usage.

umac disk space
# or
umac disk space --res=json

Info

Show detailed info about a disk or volume.

umac disk info /dev/disk0

Eject

Eject a disk or volume.

umac disk eject disk3s1

Messages

MacOS Messages.app utils

umac messages --help

ℹ️ You can also use umac/messages independently.

Open

Open the Messages app.

umac messages open

Send

Send a message to a buddy handle or a chat id.

umac messages send -t "angel@pigeonposse.com" -m "Hola!"
# or
umac messages send -t "iMessage;-;angel@pigeonposse.com" -m "Hola!"

List

List the currently open chats.

umac messages list
# or
umac messages list --name "Work"
# or
umac messages list --participants "angelo@pigeonposse.com"

Read messages

Read the messages of a chat.

umac messages messages "iMessage;-;angelo@pigeonposse.com"
# or
umac messages messages "iMessage;-;angelo@pigeonposse.com" --limit 10

Services

List the services configured in Messages.

umac messages services

Notes

MacOS Notes utils

umac notes --help

ℹ️ You can also use umac/notes independently.

Open

Open Apple Notes app or focus a specific note.

umac notes open
# or
umac notes open "Ideas"

Open new

Create and focus a new blank note or a titled note in a folder path.

umac notes open-new
# or
umac notes open-new "Quick Note"

Add

Create a new note (creates parent folders if missing).

umac notes add "Shopping List"
# or
umac notes add "Work" "Projects" "Q1 Roadmap"

Remove

Remove a note by title or path.

umac notes remove "Shopping List"
# or
umac notes remove "Work" "Projects" "Q1 Roadmap"

Add folder

Create a new folder or nested subfolders hierarchy.

umac notes add-folder "Work"
# or
umac notes add-folder "Work" "Projects" "2026"

Remove folder

Remove a folder or nested folder path.

umac notes remove-folder "Work" "Old Projects"
# or
umac notes remove-folder "Work" "Drafts" --only-notes

Move

Move a note to a target folder.

umac notes move "Shopping List" --to "Work"

Rename

Rename a note or folder.

umac notes rename "Shopping List" --name "Groceries"

Exists

Check if a note or folder exists.

umac notes exists "Work"
# or
umac notes exists "Work" "Projects" "Q1 Roadmap"

List

List all notes with their metadata.

umac notes list
# or
umac notes list --name "Meeting"
# or
umac notes list --folder "Work" "Projects"

Shortcuts

MacOS Shortcuts utils

umac shortcuts --help

ℹ️ You can also use umac/shortcuts independently.

Open

Open the Shortcuts app.

umac shortcuts open

List

List shortcuts or folders.

umac shortcuts list
# or
umac shortcuts list --folder "My Folder"
# or
umac shortcuts list --folders

Run

Run a shortcut.

umac shortcuts run "My Shortcut"
# or
umac shortcuts run "Resize Image" -i "photo.jpg" -o "resized.jpg"

View

View a shortcut in the Shortcuts app.

umac shortcuts view "My Shortcut"

☑️ TO DO

➕ More

👨‍💻 Development

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

Issues Pull requests Read more

❤️ Donate

Help us to develop more interesting things.

Donate

📜 License

This software is licensed with MIT.

Read more

✨ 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.

More

Web About Us Donate Twitter Instagram Medium

About

⚡️🍎🐢 Terminal utilities for MacOS: install apps, force close apps, clear cache, add desk notifications, change shell, etc.

www.npmjs.com/package/umac

Topics

appleapplescriptbashbindarwinmacosshellterminal

Resources

Readme
MIT license
Activity

Stars

14 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

Used by

Contributors

Languages