Mirrors/mas
2
0
Fork 0
mirror of https://github.com/mas-cli/mas synced 2024-11-24 20:43:10 +00:00
Code Issues Projects Releases Packages Wiki Activity

🎨 Simplify fenced code blocks, use footer link definitions

Browse source
This commit is contained in:
Ben Chatelain 2019-04-30 07:40:29 -06:00
parent bf7b68fe00
commit 06190db44b
1 changed files with 70 additions and 47 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

117
README.md
View file

@ -16,7 +16,9 @@ A simple command line interface for the Mac App Store. Designed for scripting an
[Homebrew](http://brew.sh) is the preferred way to install: [Homebrew](http://brew.sh) is the preferred way to install:
brew install mas ```bash
brew install mas
```
### ☎️ Older macOS Versions ### ☎️ Older macOS Versions
@ -42,73 +44,88 @@ Each application in the Mac App Store has a product identifier which is also
used for mas-cli commands. Using `mas list` will show all installed used for mas-cli commands. Using `mas list` will show all installed
applications and their product identifiers. applications and their product identifiers.
$ mas list ```bash
446107677 Screens $ mas list
407963104 Pixelmator 446107677 Screens
497799835 Xcode 407963104 Pixelmator
497799835 Xcode
```
It is possible to search for applications by name using `mas search` which It is possible to search for applications by name using `mas search` which
will search the Mac App Store and return matching identifiers. will search the Mac App Store and return matching identifiers.
Include the `--price` flag to include prices in the result. Include the `--price` flag to include prices in the result.
$ mas search Xcode ```bash
497799835 Xcode $ mas search Xcode
688199928 Docs for Xcode 497799835 Xcode
449589707 Dash 3 - API Docs & Snippets. Integrates with Xcode, Alfred, TextWrangler and many more. 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 To install or update an application simply run `mas install` with an
application identifier: application identifier:
$ mas install 808809998 ```bash
==> Downloading PaintCode 2 $ mas install 808809998
==> Installed PaintCode 2 ==> Downloading PaintCode 2
==> Installed PaintCode 2
```
If you want to install the first result that the `search` command returns, use the `lucky` command. If you want to install the first result that the `search` command returns, use the `lucky` command.
$ mas lucky twitter ```bash
==> Downloading Twitter $ mas lucky twitter
==> Installed Twitter ==> Downloading Twitter
==> Installed Twitter
```
> Please note that this command will not allow you to install (or even purchase) an app for the first time: > Please note that this command will not allow you to install (or even purchase) an app for the first time:
it must already be in the Purchased tab of the App Store. it must already be in the Purchased tab of the App Store.
Use `mas outdated` to list all applications with pending updates. Use `mas outdated` to list all applications with pending updates.
$ mas outdated ```bash
497799835 Xcode (7.0) $ mas outdated
446107677 Screens VNC - Access Your Computer From Anywhere (3.6.7) 497799835 Xcode (7.0)
446107677 Screens VNC - Access Your Computer From Anywhere (3.6.7)
```
> `mas` is only able to install/update applications that are listed in the Mac App Store itself. > `mas` is only able to install/update applications that are listed in the Mac App Store itself.
Use [`softwareupdate(8)`](https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man8/softwareupdate.8.html) Use [`softwareupdate(8)`] utility for downloading system updates (like iTunes, Xcode Command Line Tools, etc)
utility for downloading system updates (like iTunes, Xcode Command Line Tools, etc)
To install all pending updates run `mas upgrade`. To install all pending updates run `mas upgrade`.
$ mas upgrade ```bash
Upgrading 2 outdated applications: $ mas upgrade
Xcode (7.0), Screens VNC - Access Your Computer From Anywhere (3.6.7) Upgrading 2 outdated applications:
==> Downloading Xcode Xcode (7.0), Screens VNC - Access Your Computer From Anywhere (3.6.7)
==> Installed Xcode ==> Downloading Xcode
==> Downloading iFlicks ==> Installed Xcode
==> Installed iFlicks ==> Downloading iFlicks
==> Installed iFlicks
```
Updates can be performed selectively by providing the app identifier(s) to Updates can be performed selectively by providing the app identifier(s) to
`mas upgrade` `mas upgrade`
$ mas upgrade 715768417 ```bash
Upgrading 1 outdated application: $ mas upgrade 715768417
Xcode (8.0) Upgrading 1 outdated application:
==> Downloading Xcode Xcode (8.0)
==> Installed Xcode ==> Downloading Xcode
==> Installed Xcode
```
### 🚏📥 Sign-in ### 🚏📥 Sign-in
To sign into the Mac App Store for the first time run `mas signin`. To sign into the Mac App Store for the first time run `mas signin`.
$ mas signin mas@example.com ```bash
==> Signing in to Apple ID: mas@example.com $ mas signin mas@example.com
Password: ==> Signing in to Apple ID: mas@example.com
Password:
```
> ⚠️ Due to breaking changes in the underlying API that mas uses to interact with the Mac App Store, > ⚠️ Due to breaking changes in the underlying API that mas uses to interact with the Mac App Store,
> the `signin` command has been temporarily disabled on macOS 10.13+ ⛔. > the `signin` command has been temporarily disabled on macOS 10.13+ ⛔.
@ -116,20 +133,24 @@ To sign into the Mac App Store for the first time run `mas signin`.
If you experience issues signing in this way, you can ask to signin using a graphical dialog (provided by Mac App Store application): If you experience issues signing in this way, you can ask to signin using a graphical dialog (provided by Mac App Store application):
$ mas signin --dialog mas@example.com ```bash
==> Signing in to Apple ID: mas@example.com $ mas signin --dialog mas@example.com
==> Signing in to Apple ID: mas@example.com
```
You can also embed your password in the command. You can also embed your password in the command.
$ mas signin mas@example.com "ZdkM4f$gzF;gX3ABXNLf8KcCt.x.np" ```bash
==> Signing in to Apple ID: mas@example.com $ 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. Use `mas signout` to sign out from the Mac App Store.
## 🍺 Homebrew integration ## 🍺 Homebrew integration
`mas` is integrated with [homebrew-bundle](https://github.com/Homebrew/homebrew-bundle). If `mas` is installed, and you run `brew bundle dump`, `mas` is integrated with [homebrew-bundle]. If `mas` is installed, and you run `brew bundle dump`,
then your Mac App Store apps will be included in the Brewfile created. See the [homebrew-bundle](https://github.com/Homebrew/homebrew-bundle) then your Mac App Store apps will be included in the Brewfile created. See the [homebrew-bundle]
docs for more details. docs for more details.
## 💥 When something doesn't work ## 💥 When something doesn't work
@ -149,17 +170,17 @@ fix pasteboard behaviour which also works for `mas`.
You should consider configuring `tmux` to use the wrapper but if you do not wish You should consider configuring `tmux` to use the wrapper but if you do not wish
to do this it can be used on a one-off basis as follows: to do this it can be used on a one-off basis as follows:
``` ```bash
$ brew install reattach-to-user-namespace brew install reattach-to-user-namespace
$ reattach-to-user-namespace mas install reattach-to-user-namespace mas install
``` ```
## ℹ️ Build from source ## ℹ️ Build from source
You can now build from Xcode by opening `mas-cli.xcodeproj`, or from the Terminal: You can now build from Xcode by opening `mas-cli.xcodeproj`, or from the Terminal:
``` ```bash
$ script/build script/build
``` ```
Build output can be found in the `build/` directory within the project. Build output can be found in the `build/` directory within the project.
@ -176,5 +197,7 @@ Tests are written using [Quick].
mas-cli was created by [@argon](https://github.com/argon). mas-cli was created by [@argon](https://github.com/argon).
Code is under the [MIT license](LICENSE). Code is under the [MIT license](LICENSE).
[homebrew-bundle]: https://github.com/Homebrew/homebrew-bundle
[mas-cli]: https://github.com/mas-cli/mas [mas-cli]: https://github.com/mas-cli/mas
[`softwareupdate(8)`]: https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man8/softwareupdate.8.html
[Quick]: https://github.com/Quick/Quick [Quick]: https://github.com/Quick/Quick