https://github.com/u-c-s/hurl

Choose the browser on the click of a link
https://github.com/u-c-s/hurl

browser-chooser browser-extension browser-tools csharp named-pipes native-messaging windows winui3

Last synced: 4 days ago
JSON representation

Choose the browser on the click of a link

• Host: GitHub
• URL: https://github.com/u-c-s/hurl
• Owner: U-C-S
• License: mit
• Created: 2021-08-04T06:05:39.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-01-08T19:08:05.000Z (16 days ago)
• Last Synced: 2025-01-13T04:02:57.450Z (11 days ago)
• Topics: browser-chooser, browser-extension, browser-tools, csharp, named-pipes, native-messaging, windows, winui3
• Language: C#
• Homepage:
• Size: 3.02 MB
• Stars: 317
• Watchers: 7
• Forks: 13
• Open Issues: 41
• Metadata Files:
  • Readme: Docs/README.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# User settings

When Hurl is lauched for the first time, it automatically detects the installed browsers and creates a _UserSettings.json_ file at `C:\Users\{USER}\AppData\Roaming\Hurl` filling it with browsers it detected. A typical UserSettings.json file looks like this:

```json

{

  "LastUpdated": "22-Feb-22 2:22:22 AM",

  "Version": "0.6.2",

  // "AppSettings: {...},

  "Browsers": [

    {

      "Name": "Brave",

      "ExePath": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe",

      "Hidden": false

    },

    {

      "Name": "Google Chrome Dev",

      "ExePath": "C:\\Program Files\\Google\\Chrome Dev\\Application\\chrome.exe",

      "AlternateLaunches": [

        {

          "ItemName": "Profile 1",

          "LaunchArgs": "--profile-directory=\"Default\""

        },

        {

          "ItemName": "Incognito",

          "LaunchArgs": "-incognito"

        }

      ]

    }

  ]

}

```

## App settings

The following snippet shows the default options:

```json

"AppSettings": {

    "LaunchUnderMouse": false,

    "MinimizeOnFocusLoss": true,

    "NoWhiteBorder": false,

    "BackgroundType": "mica",

    "RuleMatching": false,

    "WindowSize": [460,210]

}

```

### Available options

- `LaunchUnderMouse` default is **false**, can be used to launch the Hurl window under the mouse when enabled

- `MinimizeOnFocusLoss` default is **true**

- `NoWhiteBorder` set **true** or **false** to enable or disable the white border around the window

- `BackgroundType` supports **mica**, **acrylic**, **none**

  - Windows 11 22H2 or above supports all options

  - Windows 11 build 22000 supports only mica

  - Windows 10 default is **none** irrespective of option

- `RuleMatching` default is **false**. On enabling, it supports the features from [Rulesets](https://github.com/U-C-S/Hurl/wiki/Rulesets)

- `WindowSize` is to store the size of Hurl BrowserSelect window. You dont need to set this, it will be saved automatically when the window is resized.

## Feature Documentation

- [Browser Configuration](./Features/BrowserConfiguration.md)

- [Rule Matching](./Features/RuleMatching.md)