User Interface

User Interface Settings

Custom tab colors

A comma-delimited list of colors (can either be a valid CSS color name or hex value specified as #RRGGBB) that will be used for the assigning colors to tabs feature.

See here for a list of CSS colors.

Close tabs with a double click

If checked tabs have to be closed with a double click of the close buttons instead of a single click.

Theme

Themes

This is the list of current thems installed in Jancy. The theme currently selected are used by the follow buttons:

Edit

Edit the currently selected theme using the theme editor.

Copy

Prompts the user for a new theme name and then copies the currently selected theme to a new theme that you can then edit with the theme editor.

Delete

Delete the currently selected theme.

You can only delete themes you created. You cannot delete the default Jancy themes.

Default theme

Sets the default color theme Jancy will use always or the theme that will be used when Follow OS theme is enabled and light colors is preferred at the OS level.

• jancy light default light Jancy color theme
• jancy dark default dark Jancy color theme
• any other user defined color themes will show up here.

Dark theme

Sets the dark color theme Jancy will use when Follow OS theme is enabled and dark colors is preferred at the OS level.

• jancy light default light Jancy color theme
• jancy dark default dark Jancy color theme
• any other user defined color themes will show up here.

Follow OS theme

If checked, Jancy will set the current theme based on whether light or dark colors is set as a preference at the OS level.

Font Settings

Family

Sets the font family to use.

The available fonts are determined by the fonts installed in your OS.

Size

Sets the font size to use.

Tabbed Windows

Prompt for confirmation before closing a window

If checked a confirmation dialog box will be shown before a window is closed.

Show bookmark bar

If checked, the bookmark bar will be displayed in all tabbed windows.

Show icons only in the bookmark bar

If checked, the bookmark bar will display the favicon of the bookmark instead of the label for the bookmark.

If the bookmark doesn’t have a favicon, the label will be displayed.

Tab view open by default

If checked, tab view will be open by default when a tabbed window is created.

Tab iteration mode

Determines how Jancy will iterate through tabs in a window via key binds or other methods.

• ignore tab view sort order iterating through tabs never considers how tabs are sorted in tab view
• honor tab view sort order only when open if tab view is open, iterating through tabs will follow how the tabs are sorted in tab view
• always honor tab view sort order regardless if tab view is open or not, iterating through tabs will follow how the tabs are sorted in tab view

Tab auto sort

Determines if Jancy will auto sort tabs in the main tab area as tabs are resorted by tab view.

• off don’t auto sort tabs
• mirror tab view auto sort tabs in the main tab area as tabs resort themselves in tab view
• mirror tab view only when open same as mirror tab view but auto sorts only when tab view is open otherwise it’s off

Tabs

Tab panel open by default

If checked the tab panel will be open by default in new tabs.

Show subtitles in tabs

If checked a tab’s subtitle will be visible in the tab.

Prompt for confirmation when turning the proxy off

If checked a confirmation dialog box will be shown when attempting to turn a proxy off.

Color related tabs

If checked all related tabs will have the same strip of color at the top of each tab.

Color tabs by priority

If checked all tabs will be colored by the current priority value.

Color tabs by priority group

If checked all tabs will be colored by the current priority group value.

Priority group color style

Sets how the priority group color is applied to the tab.

• vertical gradient
• vertical
• horizontal gradient
• horizontal

Custom color width in pixels

The amount of space a custom color assigned to the tab takes up in the tab element in the main tab area.

Default zoom level

Sets the default zoom level for new tabs.

Zoom step

Sets the amount the zoom level of a tab is adjusted when it’s stepped up or down.

Tab View

Show subtitles in tabs

If checked a tab’s subtitle will be visible in the tabs in tab view.

Color related tabs

If checked all related tabs will have the same strip of color on the right side of each tab.

Color tabs by priority

If checked tabs in tab view will be colored by the current priority value.

Color tabs by priority group

If checked tabs in tab view will be colored by the current priority group value.

Priority group color style

Sets how the priority group color is applied to the tab.

• vertical gradient
• vertical
• horizontal gradient
• horizontal

Custom color width in pixels

The amount of space a custom color assigned to the tab takes up in the tab element in tab view.

Default sort order

Sets the default tab view sort order.

• created time (oldest first) tabs will be sorted by the order they were created. The default sort order is oldest tabs first.
• tab priority (highest first) tabs will be sorted by the priority value assigned to the tab. The default sort order is highest values first.
• tab priority group (highest first) tabs will be sorted by priority group value assigned to the tab and second order sorted by the priority value assigned to the tab. The default sort order is highest values first.
• profile email (alphabetical) tabs will be sorted by email of the profile assgined to the tab then second order sorted by the order they were created.
• tab title (alphabetical) tabs will be sorted by the title of the tab. The default sort order is alphabetical.
• tab URL (alphabetical) tabs will be sorted by the URL of the tab. The default sort order is alphabetical.
• recent update (newer first) tabs will be sorted by the time when either priority, priority group, title, or URL changes. Default sort order is most recent change first.
• custom sort function tabs will be sorted by the logic described by the custom sort function (see the Edit custom sort function below)

Sort tabs in descending order by default

If checked, tab view will sort tabs in descending order by default instead of ascending.

Edit custom sort function

Specify the contents of a Javascript function that accepts 2 tab objects (a and b) and returns -1, 0, or 1 if a is less than b, a and b are equal, or if a is greater than b. The purpose of this feature is to let you customize how tab view sorts tabs by introducing your own sorting logic.

This is an example of a function that first order sorts tabs by priority group, second order sorts them by priority, and third order sorts by actual queue position.

// first order sort by priority group (highest first)
// second order sort by priority (highest first)
// third order sort by queue position (lowest first)

let d = b.priorityGroup - a.priorityGroup
if (d === 0) {
  d = b.priority - a.priority
  if (d === 0) {
    const ql = a.data?.queue_it_current_position
    const q2 = b.data?.queue_it_current_position
    if (q1 && q2) {
      d = q1 - q2
    } else if (q1) {
      d = 1
    } else {
      d = -1
    }
  }
}
return d

Resort debounce timeout in seconds

Sets a timeout value that delays updating tab view when a one or more tab’s priority changes causing tab view to resort.

Smaller values update the UI more frequently but could increases CPU usage.

Profiles

Show passcode labels

If checked labels associated with profile passcodes will be displayed throughout the application instead of the default #<number> placeholder.

Depending on the length of the label, you may notice some UI artifacting especially in the profile panel.

Hide timestamp fields on the profile tab panel

If checked the timestamp fields on the profile tab panel will be hidden freeing up some space.

Mask password

If checked the password will be masked for display purposes.

This setting has no effect on how the password appears on websites.

Mask credit card CVV

If checked the credit card CVV will be masked for display purposes.

This setting has no effect on how the credit card CVV appears on websites.

Credit card number

Sets if and how the credit card number is masked for display purposes.

• don’t mask
• mask entire number
• mask all but last 4

This setting has no effect on how credit card numbers are displayed on websites.

Max number of profiles to return when searching

Sets the number of profiles to return when searching for profiles via the profile panel.

Tab Dialogs

Sort profiles in tab dialogs alphabetically

If checked, the groups in the new and duplicate tab dialogs will be sorted alphabetically. If unchecked, they will show up in the order they’re specified in the source (profile CSVs, Google sheets, etc) of the profiles.

Sort profiles in tab dialogs alphabetically

If checked, the profiles in groups in the new and duplicate tab dialogs will be sorted alphabetically.

Filter groups (and optionally profiles) by matching anywhere in the string

If checked, we’ll find matching groups (and optionally profiles) by searching anywhere in the string when searching. If not checked we only look at the start of the string for matches.

Format Strings

Format strings give you the ability to customize how certain strings are built and displayed in various parts of the user interface.

Think of a format string as the body of a Javascript function that looks like this:

function format(ctx) {
  str = 'some value'      // <-- this is your format string
  return str
}

The function receives a ctx object as an argument. The properties of the ctx object varies based on the string being formatted. Your format string must assign a string to the special variable str.

If you want to put the tab’s priority in the title of a tab you can define the Tab title format string as:

str = `(${ ctx.tab.priority }) ${ ctx.tab.title }`

Tabbed window title

This format string lets you customize the title of the tabbed window (the main Jancy window).

The ctx object contains the following properties:

• jancy (Jancy object)
• title (string)
• tabs ([Tab object])
• closedTabs ([Tab object])
• name (string)
• uuid (string)

Tab title

This format string lets you customize the title of a tab.

The ctx object contains the following properties:

• jancy (Jancy object)
• tab (Tab object)
• partition (Partition object)

Tab subtitle

This format string lets you customize the subtitle of a tab.

The ctx object contains the following properties:

• jancy (Jancy object)
• tab (Tab object)
• partition (Partition object)

Profile panel profile title

This format string lets you customize the title of the profile panel when a profile has been selected.

The ctx object contains the following properties:

• profile (Profile object)

Table of contents

• Theme Editor