Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
prasmussen committed May 26, 2021
1 parent dc59083 commit 37c0dab
Showing 1 changed file with 24 additions and 11 deletions.
35 changes: 24 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,23 +3,36 @@ chrome-cli


## Overview
chrome-cli is a command line utility for controlling Google Chrome on OS X.
It is a native binary that uses the Scripting Bridge to communicate
with Chrome.
chrome-cli is a command line utility for controlling Google Chrome compatible browsers on OS X.
It is a native binary that uses the Scripting Bridge to communicate with Chrome.
chrome-cli has been tested with the following browsers:
* Chrome
* Chrome Canary
* Chromium
* Brave
* Vivaldi


### Other browsers
By default chrome-cli communicates with Chrome, but you can use it with other browsers by settings
the `CHROME_BUNDLE_IDENTIFIER` environment variable. I.e. to use chrome-cli with Brave you can run the following command:
```bash
CHROME_BUNDLE_IDENTIFIER="com.brave.Browser" chrome-cli list tabs
```
Check the [scripts directory](scripts) for some convenient wrappers.


#### How do I find the bundle identifier?
The following command will print out the bundle identifier for Brave
```bash
mdls -name kMDItemCFBundleIdentifier -raw /Applications/Brave\ Browser.app
```

## Installation

#### Homebrew
brew install chrome-cli

#### Manual
- Save the 'chrome-cli' binary to a location in your PATH (i.e. `/usr/local/bin/`)

##### Downloads
- [chrome-cli-darwin-1.6.0-x64](https://github.com/prasmussen/chrome-cli/releases/download/1.6.0/chrome-cli)
- [canary-cli-darwin-1.5.0-x64](https://drive.google.com/uc?id=0B3X9GlR6EmbnTmZ2VmxRdmxRaFU)
- [chromium-cli-darwin-1.5.0-x64](https://drive.google.com/uc?id=0B3X9GlR6EmbnXy1BTF9fQ0ZVN00)


## JavaScript execution
To execute javascript you must first allow it under `View > Developer > Allow JavaScript from Apple Events`.
Expand Down

0 comments on commit 37c0dab

Please sign in to comment.