Editing UserSettings.json

When Hurl is lauched for the first time, it automatically detects the installed browsers in the computer 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.

{
  "LastUpdated": "22-Feb-22 2:22:22 AM",
  "Version": "0.6.2",
  "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"
        }
      ]
    },
  ]
}

Browsers Field

• SourceType - how the browser is added into Hurl (0 for from registry, 1 for User added) (just give 1 (number, not string) if you don't understand)
• Name - you know
• ExePath - The path of browser main exe file
• CustomIconPath - Use absolute path of the image. Also, Supports URLs.
• LaunchArgs - Add the default exe launch arguments here. use param %URL% injecting the Url at runtime here.
• Hidden - set it to true to hide the current icon in the selection screen
• AlternateLaunches - This is an array .... see below

AlternateLaunches

This is a way to launch the browser when you have multiple launch methods or launch targets... like incognito, browser profiles...

Suppose you have multiple chrome profiles like this

Then you might wanna use this feature, instead of totally adding a new browser entity for each profile in settings file. The following snippet demonstrates this feature. Adding the AlternateLaunches field to browser entity will you simply right-click on the browser icon in the selection window and choose the req. option.

"AlternateLaunches": [
  {
    "ItemName": "Main Profile",
    "LaunchArgs": "--profile-directory=\"Default\""
  },
  {
    "ItemName": "Profile 2",
    "LaunchArgs": "--profile-directory=\"Profile 1\""
  },
  {
    "ItemName": "Incognito",
    "LaunchArgs": "-incognito"
  }
]

Right-Clicking on the browser that has AlternateLauches brings up the context menu with options specified as in the settings file. On selecting the the URL will also automatically included while launching the browser.

• ItemName - The name that shows up in the context menu for this launch
• LaunchArgs - Launch args. You can keep launch the browser in incognito, other browser profiles...