waveterm/homebrew-cask
0
0
Fork 0
mirror of https://github.com/wavetermdev/homebrew-cask.git synced 2026-08-05 13:43:24 -07:00
Code Issues Packages Projects Releases Wiki Activity

README & USAGE: update examples

Browse Source
This commit is contained in:
Eric Knibbe
2023-09-11 14:16:13 -04:00
parent 6e9ea5e833
commit c80af0887c
2 changed files with 51 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+1 -1
View File
@@ -16,7 +16,7 @@ To start using Homebrew Cask, you just need [Homebrew](https://brew.sh) installe
Slower, now:
```
```console
$ brew install alfred
==> Downloading https://cachefly.alfredapp.com/Alfred_4.2.1_1187.dmg
######################################################################## 100.0%
USAGE.md
+50 -53
View File
@@ -4,27 +4,27 @@
Homebrew Cask is implemented as part of [Homebrew](https://brew.sh). All Homebrew Cask commands begin with `brew`, which works for both casks and formulae. The most frequently-used commands are:
* `install` — installs the given Cask.
* `uninstall` — uninstalls the given Cask.
* `reinstall` — reinstalls the given Cask.
* `list --casks` — lists installed Casks.
* `install --cask` — installs the given cask.
* `uninstall --cask` — uninstalls the given cask.
* `reinstall --cask` — reinstalls the given cask.
* `list --cask` — lists installed casks.
## Searching for Casks
To search for Casks, use `brew search`. Let’s see if there’s a Cask for Google Chrome:
```bash
$ brew search google-chrome
```console
$ brew search --cask google-chrome
==> Casks
google-chrome google-chrome-beta google-chrome-canary google-chrome-dev
```
## Installing Casks
The command `brew install` accepts one or multiple Cask tokens. Let’s try to install Google Chrome:
The command `brew install --cask` accepts one or multiple cask tokens. Let’s try to install Google Chrome:
```bash
$ brew install google-chrome
```console
$ brew install --cask google-chrome
==> Downloading https://dl.google.com/chrome/mac/stable/GGRO/googlechrome.dmg
######################################################################## 100.0%
==> Verifying SHA-256 checksum for Cask 'google-chrome'.
@@ -37,30 +37,32 @@ $ brew install google-chrome
Easy peasy:
```bash
$ brew uninstall google-chrome
```console
$ brew uninstall --cask google-chrome
```
This will both uninstall the Cask and remove applications which were moved to `/Applications`.
## Other Commands
* `info` — displays information about the given Cask.
* `fetch` — downloads remote application files for the given Cask to the local cache (with `--force`, re-download even if already cached).
* `--cache` — displays the path to Homebrew's local cache.
* `doctor` — checks for configuration issues.
* `style` — checks Cask style using RuboCop.
* `home` — opens the homepage of the given Cask; or with no arguments, the Homebrew project page.
* `uninstall --zap` — try to remove *all* files associated with a Cask (may include resources shared with other applications).
* `outdated` — lists all outdated Casks.
* `upgrade` — updates all outdated Casks.
Unless noted, these are run with `--cask <cask_token>` to apply to Homebrew Cask.
The following commands are for Cask authors:
* `info` — displays information about the given cask.
* `fetch` — downloads remote application files for the given cask to the local cache (with `--force`, re-downloads even if already cached).
* `--cache` — displays the expected path to Homebrew's local cache of application files.
* `doctor` — checks for configuration issues (run with no arguments).
* `style` — checks style for the given cask using RuboCop.
* `home` — opens the homepage of the given cask; or with no arguments, the Homebrew project page.
* `uninstall --zap` — try to remove *all* files associated with a cask (may include resources shared with other applications).
* `outdated` — lists all outdated casks (run with just `--cask`).
* `upgrade` — updates all outdated casks (run with just `--cask`).
* `audit` — verifies installability of Casks.
* `cat` — dumps the given Cask to the standard output.
* `create --cask` — creates a Cask and opens it in an editor.
* `edit` — edits the given Cask.
The following commands are for cask authors:
* `audit` — verifies installability of casks.
* `cat` — dumps the given cask to the standard output.
* `create --cask` — creates a cask and opens it in an editor.
* `edit` — edits the given cask.
The following aliases and abbreviations are provided for convenience:
@@ -73,44 +75,39 @@ The following aliases and abbreviations are provided for convenience:
## Tab Completion
Homebrew Cask comes with `bash` and `zsh` completion for the `brew` command.
See https://docs.brew.sh/Shell-Completion for more information.
`fish` completions can be installed with:
```bash
$ brew install brew-cask-completion
```
Homebrew comes with `bash`, `zsh` and `fish` tab completion for the `brew` command. See [`brew` Shell Completion](https://docs.brew.sh/Shell-Completion) for more information.
## Inspecting Installed Casks
List all installed Casks:
List staged files for an installed cask:
```bash
$ brew list --casks
atom google-chrome 1password
```console
$ brew list --cask firefox
==> App
/Applications/Firefox.app (112 files, 360MB)
```
With `--full-name` the Tap name will also be included, _e.g._: `purple/monkey/dishwasher` for the Cask `dishwasher` installed from the Tap `purple/monkey`.
List all installed casks:
Given an installed Cask, `brew list --casks <cask_name>` lists the staged files.
```console
$ brew list --cask
firefox google-chrome opera
```
Show details about a specific Cask:
With `--full-name` any external tap names will also be included, _e.g._: `purple/monkey/dishwasher` for the cask `dishwasher` installed from the tap `purple/monkey`.
```bash
Show details about a specific cask:
```console
$ brew info keepingyouawake
Error: No available formula with the name "keepingyouawake"
Found a cask named "keepingyouawake" instead.
keepingyouawake: 1.5.2 (auto_updates)
==> keepingyouawake: 1.6.4 (auto_updates)
https://keepingyouawake.app/
/usr/local/Caskroom/keepingyouawake/1.5.2 (129B)
From: https://github.com/Homebrew/homebrew-cask/blob/HEAD/Casks/keepingyouawake.rb
/usr/local/Caskroom/keepingyouawake/1.6.4 (129B)
From: https://github.com/Homebrew/homebrew-cask/blob/HEAD/Casks/k/keepingyouawake.rb
==> Name
KeepingYouAwake
==> Description
Prevents your computer from going to sleep
Tool to prevent the system from going into sleep mode
==> Artifacts
KeepingYouAwake.app (App)
```
@@ -135,7 +132,7 @@ The primary Homebrew Cask Tap includes most of the Casks that a typical user wil
You can tap any of the above with a `brew tap` command:
```bash
$ brew tap <tap_name>
brew tap <tap_name>
```
after which, Casks from the new Tap will be available to `search` or `install` just like Casks from the main Tap. `brew update` will automatically keep your new Tap up to date.
@@ -143,7 +140,7 @@ after which, Casks from the new Tap will be available to `search` or `install` j
You may also specify a fully-qualified Cask token (which includes the Tap) for any `brew` command. This will implicitly add the Tap if you have not previously added it with `brew tap`:
```bash
$ brew install homebrew/cask-fonts/font-symbola
brew install homebrew/cask-fonts/font-symbola
```
## Options
@@ -174,9 +171,9 @@ export HOMEBREW_CASK_OPTS="--appdir=~/Applications --fontdir=/Library/Fonts"
Note that you still can override the environment variable `HOMEBREW_CASK_OPTS` by _explicitly_ providing options in the command line:
```bash
# Will force the Chrome app to be moved to /Applications
# Will force the Google Chrome app to be moved to /Applications
# even though HOMEBREW_CASK_OPTS specified ~/Applications
$ brew install --appdir="/Applications" google-chrome
brew install --appdir="/Applications" google-chrome
```
## Other Ways to Specify a Cask