Configuration

Global configuration applies to IDE, project configuration applies to a project only.

General configuration

For most of the features to work repository roots must be correctly configured in:

• File / Settings / Version Control
• IntelliJ IDEA / Preferences… / Version Control

Windows/Linux configuration locations

• File / Settings / Appearance & Behavior / Notifications
• File / Settings / Editor / Color Scheme / GitToolBox Colors
• File / Settings / Version Control / GitToolBox
• File / Settings / Version Control / GitToolBox / GitToolBox Project

MacOS configuration locations (with project open)

• IntelliJ IDEA / Settings… / Appearance & Behavior / Notifications
• IntelliJ IDEA / Settings… / Editor / Color Scheme / GitToolBox Colors
• IntelliJ IDEA / Settings… / Version Control / GitToolBox
• IntelliJ IDEA / Settings… / Version Control / GitToolBox / GitToolBox Project

Global configuration

Notifications

Notifications shown by the plugin can be configured on Appearance & Behavior / Notifications IDE config page.

See IDE Help > Notifications for more details.

Notable notification groups

• GitToolBox actions info - feedback from plugin actions
• GitToolBox blame - unregistered Git roots prompt
• GitToolBox fetch info - auto-fetch success prompt
• GitToolBox fetch error - auto-fetch error prompt

How to mute notifications

Group can be muted (no notifications and entries in tool window) by selecting follow options

IDE 2022.1+:

• Popup type: No popup
• Show in tool window - disabled

IDE 2021.3+:

• Popup type: No popup
• Log - disabled

Notifications tips & tricks

Some tips regarding notifications:

• Balloon type - shortens the message and disappears after some time
• Tool window balloon - shows full message and disappears on click anywhere

Project configuration

Defaults for a new project

Default configuration for newly created projects can be setup with standard IDE functionality available under:

Overrides for project

Some configurations have two levels - global and project. Project ones have Override checkboxes next to them that allow setting values that differ in particular project from global ones.

Disable auto-fetch for a project

1. Open Settings... / Version Control / GitToolBox / GitToolBox Project > Auto Fetch tab
2. Enable Override checkbox for Auto fetch
3. Disable Auto fetch
4. Enable Override checkbox for Auto fetch on branch switch
5. Disable Auto fetch on branch switch

Result should look similar as below