m-cli is a macOS command line tool that lets you interact with utilities and applications entirely in Terminal. It differs from other macOS command line tools in the following ways:
- You can easily manage administrative tasks
- It doesn't install 3rd party tools since it doesn't have dependencies
- Installation is easy and doesn't require intervention
- It only uses macOS commands
You can install m-cli using Homebrew, or you can manually install it.
If you have Homebrew installed, run:
brew install m-cli
If you want to manually install m-cli, run:
curl -fsSL https://raw.githubusercontent.com/rgcr/m-cli/master/install.sh | sudo sh
You can also install it to a different path, shown below:
INSTALL_DIR=$HOME/.m-cli sh <(curl -fsSL https://raw.githubusercontent.com/rgcr/m-cli/master/install.sh)
Note: You need privileges
To uninstall m-cli from your system, run:
How To Use
m to display all of the commands available.
The structure of m-cli commands is:
m + utility + command
A diagram of this structure is shown below:
m |___itunes | |___status | |___play | |___pause | | | ... | |___disk |___ls |___list |___fs ...
For example, running
m itunes will display the commands available for iTunes, as shown below:
usage: m itunes [ status | play | pause | next | prev | mute | unmute | vol up | vol down | vol #| stop | quit | help ] Examples: m itunes status # Show status m itunes play # Play track m itunes pause # Pause track m itunes next # Play next track m itunes prev # Play previous track m itunes mute # Mute iTunes m itunes unmute # Unmute iTunes m itunes vol up # Volume Up m itunes vol down # Volume Down m itunes vol # # Set volume level m itunes stop # Stop track m itunes quit # Quit iTunes
In this example, running
m itunes play will play the current selected track in your iTunes music library.
m-cli currently supports the following:
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -m 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request
- Add more plugins
- Improve the help
- Improve the installation script
guarinogabriel/Mac-CLI was a great source of inspiration.
MIT License © Rogelio Cedillo