2015-09-20 23:47:42 +00:00
|
|
|
# mas-cli
|
|
|
|
|
|
2015-09-20 23:55:58 +00:00
|
|
|
A simple command line interface for the Mac App Store. Designed for scripting
|
|
|
|
|
and automation.
|
2015-09-20 23:47:42 +00:00
|
|
|
|
|
|
|
|
## Install
|
|
|
|
|
|
|
|
|
|
[Homebrew](hb) is the preferred way to install:
|
|
|
|
|
|
|
|
|
|
brew install argon/mas/mas
|
|
|
|
|
|
|
|
|
|
Alternatively binaries are available in the [GitHub Releases](ghreleases)
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
Each application in the Mac App Store has a product identifier which is also
|
2015-09-20 23:55:58 +00:00
|
|
|
used for mas-cli commands. Using `mas list` will show all installed
|
|
|
|
|
applications and their product identifiers.
|
2015-09-20 23:47:42 +00:00
|
|
|
|
|
|
|
|
$ mas list
|
|
|
|
|
446107677 Screens
|
|
|
|
|
407963104 Pixelmator
|
|
|
|
|
497799835 Xcode
|
|
|
|
|
|
2016-04-17 00:26:52 +00:00
|
|
|
It is possible to search for applications by name using `mas search` which
|
|
|
|
|
will search the Mac App Store and return matching identifiers
|
|
|
|
|
|
|
|
|
|
$ mas search Xcode search Xcode
|
|
|
|
|
497799835 Xcode
|
|
|
|
|
688199928 Docs for Xcode
|
|
|
|
|
449589707 Dash 3 - API Docs & Snippets. Integrates with Xcode, Alfred, TextWrangler and many more.
|
|
|
|
|
[...]
|
|
|
|
|
|
|
|
|
|
To install or update an application simply run `mas install` with an
|
|
|
|
|
application identifier:
|
2015-09-20 23:47:42 +00:00
|
|
|
|
|
|
|
|
$ mas install 808809998
|
|
|
|
|
==> Downloading PaintCode 2
|
|
|
|
|
==> Installed PaintCode 2
|
|
|
|
|
|
|
|
|
|
Use `mas outdated` to list all applications with pending updates.
|
|
|
|
|
|
|
|
|
|
$ mas outdated
|
|
|
|
|
497799835 Xcode (7.0)
|
|
|
|
|
446107677 Screens VNC - Access Your Computer From Anywhere (3.6.7)
|
|
|
|
|
|
2015-12-30 21:03:45 +00:00
|
|
|
To install all pending updates run `mas upgrade`.
|
|
|
|
|
|
|
|
|
|
$ mas upgrade
|
|
|
|
|
Upgrading 2 outdated applications:
|
|
|
|
|
Xcode (7.0), Screens VNC - Access Your Computer From Anywhere (3.6.7)
|
|
|
|
|
==> Downloading Xcode
|
|
|
|
|
==> Installed Xcode
|
|
|
|
|
==> Downloading iFlicks
|
|
|
|
|
==> Installed iFlicks
|
|
|
|
|
|
2016-02-14 01:42:18 +00:00
|
|
|
To sign into the Mac App Store for the first time run `mas signin`.
|
|
|
|
|
|
|
|
|
|
$ mas signin mas@example.com "ZdkM4f$gzF;gX3ABXNLf8KcCt.x.np"
|
|
|
|
|
==> Signing in to Apple ID: mas@example.com
|
|
|
|
|
|
|
|
|
|
Use `mas signout` to sign out from the Mac App Store.
|
|
|
|
|
|
2015-12-30 21:45:36 +00:00
|
|
|
## Build from source
|
|
|
|
|
|
|
|
|
|
`mas` currently requires the [bundler](http://bundler.io/) RubyGem in order to
|
|
|
|
|
bootstrap and build the project. There are a number ways to install bundler but
|
|
|
|
|
if you have never used it before then installing it with `gem` should be enough.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ gem install bundler
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
You can now bootstrap the project by executing the `bootstrap` script
|
|
|
|
|
from the mas sources script directory:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ script/bootstrap
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
You can now build from Xcode by opening `mas-cli.xcodeproj`, or from the Terminal:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ script/build
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Build output can be found in the `build/` directory within the project.
|
|
|
|
|
|
2015-09-20 23:47:42 +00:00
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
Code is under the MIT license.
|
|
|
|
|
|
|
|
|
|
[hb]: https://brew.sh
|
|
|
|
|
[ghreleases]: https://github.com/argon/mas/releases
|
|
|
|
|
|
