Skip to content

Commit

Permalink
Add a readme, add opera browser and prepare for publishing
Browse files Browse the repository at this point in the history
  • Loading branch information
mmmichl committed Sep 26, 2018
1 parent 6f489a6 commit 3232893
Show file tree
Hide file tree
Showing 3 changed files with 55 additions and 3 deletions.
38 changes: 38 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Browser Router

Open your desired browser when clicking on a link based on the URL. This is a desktop application which registers itself
as the default browser. When clicking on a link in an application - e.g. your email program - you can specify rules
expressed in JavaScript regular expressions to decide based on the URL which browser should be opened.

This macOS appication is open-source and based on Electron.

## Installation

TBA

After installation you need to run `Browser Router` once manually. You will be prompted if the application should be
registered as default browser. Confirm this to start using `Browser Router`.

## Configuration

This is unfortunately still a bit complicated. In your Finder select "Browser Router" in "Applications" folder.
Right click and select "Show Package Contents".

Navigate to `Contents/Resources/app/src`. Open `config.json` and edit the content or add a new entry.

`default`: if no rules are matched, this browser is used.

`url`: should be a JavaScript RegExp expression to match an URL. You can test your regular expression e.g. online here https://www.regexpal.com/

### Recognized Browsers
| Keyword | Browser |
|---------------|----------------------|
| chrome | Google Chrome |
| chrome-canary | Google Chrome Canary |
| chromium | Chromium |
| firefox | Firefox |
| opera | Opera |
| safari | Safari |
| vivaldi | Vivaldi |

If your browser is missing, please create a new issue.
16 changes: 13 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,9 @@
"start": "ENV=DEV electron-forge start",
"package": "electron-forge package",
"make": "electron-forge make",
"lint": "eslint src"
"lint": "eslint src",
"prepublish": "yarn run lint",
"publish": "electron-forge publish --auth-token=$GITHUB_TOKEN"
},
"keywords": [
"Electron",
Expand All @@ -22,12 +24,20 @@
"config": {
"forge": {
"make_targets": {
"darwin": ["dmg"]
"darwin": [
"dmg"
]
},
"electronPackagerConfig": {
"packageManager": "yarn",
"icon": "icons/browser-router.icns",
"ignore": [".idea"]
"ignore": [
".idea"
]
},
"github_repository": {
"owner": "mmmichl",
"name": "browser-router"
},
"protocols": [
{
Expand Down
4 changes: 4 additions & 0 deletions src/knownBrowsers.js
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,10 @@ export default [
key: 'firefox',
osName: 'Firefox',
},
{
key: 'opera',
osName: 'Opera',
},
{
key: 'safari',
osName: 'Safari',
Expand Down

0 comments on commit 3232893

Please sign in to comment.