This section explains how to configure the gitwinch.ini file settings before launching the Git Winch application. All these settings are stored in the application's gitwinch.ini file.

Understanding the ini file

The ini file contains several lines which has the following format:

<name>=<value>

i.e. you will see a name of the setting (one word), an equals-to sign and a value after that. Do NOT change the name. That is important. You can only change the values after the equals-to sign.\

These setting lines are gathered into various sections. Each section name (one word) is inside square brackets. Do NOT change the names of the sections.

Configuration Steps

• Close Git Winch if it was running
• Locate the Git Winch gitwinch.ini file in the application folder
• Open the file in any text editor (e.g. Notepad, Notepad++, VS-Code)
• Modify the required settings as per your needs
• Save the file
• Launch Git Winch application and the settings would take effect

Purpose: Defines the root folder that Git Winch monitors for changes.

Configuration:

• WorkFolderRoot=D:\data\

Important: Replace the path with a folder that has read/write permissions. Use absolute path (e.g., D:\data\) or relative path (e.g., data)If distributing to others, tell them they must update this path for their own system.

Purpose: Controls warning when working outside the designated work folder.

• 1 = Show warning when attempting to work outside work folder
• 0 = No warning displayed

Purpose: Controls automatic loading of notes when selecting files.

• 1 = Auto-load notes for selected files
• 0 = Manual note loading (recommended for slow/no internet)

ShowHints

• 1 = Enable context-sensitive help and hints
• 0 = Disable all hints and help

Greeting

• 1 = Show greeting message on application launch
• 0 = Skip greeting message

GreetMessage Custom greeting text displayed on application launch

• GreetMessage=Have a nice day

ShowStatusHints

• 1 = Show status bar
• 0 = Hide status bar (double-click to show)

ShowFloatingHints

• 1 = Show popup hints below UI elements
• 0 = Hide popup hints

GitSys Specifies the Git server type. For Gitlab its “Gitlab” for Github its “Github”

• GitSys=Gitlab

LockOnLaunch

• 1 = Automatically lock files on launch
• 0 = Locks only after user starts editing a file

LaunchOnlyExe

• 1 = Use only desktop shortcuts for executables
• 0 = Use only desktop shortcuts

pauseCapture

• 1 = Start clipboard queue system in paused state
• 0 = Start clipboard queue system as active

SystemAPIurl URL of the coordination server

• SystemAPIurl=https://xxx.yyy.com/api/v1/

Dashboardurl Login URL used by this app

• Dashboardurl=https://xxx.yyy.com/qlogin.html

InfoHTML HTML file for info page display

• InfoHTML=defaultOffice.html

HelpSite Main help documentation URL

• HelpSite=https://help.gitwinch.com/

SaaSHelpSite Kanban board help site URL

• SaaSHelpSite=https://help.spoke.today/

TrLanguage Translation language code for translating help. ml stands for Malayalam

• TrLanguage=ml

For the full set of language codes, refer to Google Cloud Translation language codes.

Note: Ensure all folder paths exist and you should be able to save here before starting the application.

Learn the concepts | Configuration | Advantages | Management | Advanced uses | Troubleshooting | Table of Contents