======The Ini File======

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


===== Work Section =====

==== WorkFolderRoot ====

**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.

==== WorkFolderWarn ====

**Purpose:** Controls warning when working outside the designated work folder.
  * **1** = Show warning when attempting to work outside work folder
  * **0** = No warning displayed

==== AutoReadNotes ====

**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)

===== System Section =====

==== Display Settings ====

**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

==== System Configuration ====

**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

==== Server URLs ====

**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/

==== Localization ====

**TrLanguage**
Translation language code for translating help. ml stands for Malayalam
  * TrLanguage=ml
For the full set of language codes, refer to [[https://cloud.google.com/translate/docs/languages|Google Cloud Translation language codes]]. 

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

-----

[[/concepts?do=export_xhtml | Learn the concepts]] | [[/configuration?do=export_xhtml|Configuration]] | [[/advantages?do=export_xhtml | Advantages]] | [[/tsManage2?do=export_xhtml|Management]]  | [[ /advanced?do=export_xhtml | Advanced uses]] | [[ /troubleshooting?do=export_xhtml | Troubleshooting ]] | [[/topics?do=export_xhtml | Table of Contents]]