Git Winch Guide

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
installation [2025/07/02 14:56] – admininstallation [2025/07/29 17:46] (current) – admin
Line 11: Line 11:
 //Git Winch// works ONLY on Windows. So the entire office that uses //Git Winch// must be using Windows. (We may release Linux and Mac versions later, if there is serious demand)  //Git Winch// works ONLY on Windows. So the entire office that uses //Git Winch// must be using Windows. (We may release Linux and Mac versions later, if there is serious demand) 
  
-**//Chrome (or a browser similar to Chrome) is needed!//**\\+**//1. Chrome (or a browser similar to Chrome) is needed!//**\\
 Your computer MUST have //Chrome// browser installed at its default location in the computer. You can also use browser such as //Brave, Edge and Chromium// too. But those would need the //gitwinch.ini// file to be changed ...//explained later as you read below//. Your computer MUST have //Chrome// browser installed at its default location in the computer. You can also use browser such as //Brave, Edge and Chromium// too. But those would need the //gitwinch.ini// file to be changed ...//explained later as you read below//.
  
 The first time you start //Git Winch// it will start Chrome browser in //app// mode. That startup will result in over 100Mb (approx) of files needed by Chrome in a sub-folder inside the application folder. That is a normal activity and so you don't have to get worried. The first time you start //Git Winch// it will start Chrome browser in //app// mode. That startup will result in over 100Mb (approx) of files needed by Chrome in a sub-folder inside the application folder. That is a normal activity and so you don't have to get worried.
  
-**//Git is needed!//**\\+**//2. Git is needed!//**\\
 You also need to install //Git// To check if you have that utility installed, please open a command-line window (console window or "cmd" window) and just give this command:  You also need to install //Git// To check if you have that utility installed, please open a command-line window (console window or "cmd" window) and just give this command: 
  
Line 23: Line 23:
 If you see the version number in the output, that means Git has been installed. If not, you should download Git installer and install it https://git-scm.com/downloads/win and do the above check again. If you see the version number in the output, that means Git has been installed. If not, you should download Git installer and install it https://git-scm.com/downloads/win and do the above check again.
  
-**//Curl is needed!//**\\+**//3. Curl is needed!//**\\
 You should also check if the //curl// command is working globally on your computer. Again, you should open a cmd window and give this command: You should also check if the //curl// command is working globally on your computer. Again, you should open a cmd window and give this command:
    
Line 29: Line 29:
  
 If you do not get any output or if it says "not recognized as an internal or external command" that means your Windows installation is probably not compatible. You should upgrade Windows. But you can also try installing Curl globally from the installer available from https://curl.se/windows/ If you do not get any output or if it says "not recognized as an internal or external command" that means your Windows installation is probably not compatible. You should upgrade Windows. But you can also try installing Curl globally from the installer available from https://curl.se/windows/
 +
 +
 +**//4. Translation file is needed//**\\
 +By default the language set for //Git Winch// is English ('en') and you would see the setting in the default gitwinch.ini file in the [System] section the following setting:
 +
 +//trLanguage=en//
 +
 +For //Git Winch// to work, it should be able access the translations file whose filename is based on the above //trLanguage// setting. And such files must be present in the //translations// folder within the application folder. In the above example, //Git Winch// will try to load the file //translations\**en**.translations.txt// If that file is NOT present, //Git Winch// will complain and quit! 
 +
 +**//5.Anti-virus and other blockers//**\\
 +When you run any application (not just //Git Winch//) that you have downloaded from the Internet, Windows would usually block it. In many cases, Windows would pop-up a dialog of this nature. You will have to click on //**More info...**// link in the dialog. On clicking that, you will see the button to run the downloaded application. In case of //Git Winch// we are very sure it does not cause any harm. But you must take ample caution before running any application downloaded from the Internet.
 +
 +
 +{{ :firsttimerun.jpeg?400 |}}
 +
 +We have thoroughly checked the application for any virus that may have crept in accidentally. But there can still be some anti-virus program that may still block it. So make sure you request your anti-virus to allow the running of //Git Winch.//
 +
 +====Registration=====
 +
 +To use //Git Winch// you not only need to install the software, but you should //also register.// And even the rest of your office who uses //Git Winch// should ALSO individually register. This is explained in detail [[regform?do=export_xhtml|here.]]
 +
  
 ====First steps==== ====First steps====
-You MUST set a suitable organization/division code for yourself. This is a simple text written in a text file named //"orgname.txt"// which must be kept in the same folder where you installed //Git Winch.// Read more about this [[org?do=export_xhtml|here.]]+You MUST set a suitable organization/division code for yourself. This is a simple text written in a text file named //"orgname.txt"// which must be kept in the same folder where you installed //Git Winch.// This special file is usually generated by the owner of the office and distributed to all those who work in that office. Read more about this [[org?do=export_xhtml|here.]]
    
 There is a special file named //gitwinch.ini// in the application folder. It is used to finely configure your own //Git Winch// as per your own office requirements. Use a text editor such as Notepad, Notepad++, VSCode, etc to edit it. How to set various configuration values in this ini file is explained [[inifile?do=export_xhtml|here]]. There is a special file named //gitwinch.ini// in the application folder. It is used to finely configure your own //Git Winch// as per your own office requirements. Use a text editor such as Notepad, Notepad++, VSCode, etc to edit it. How to set various configuration values in this ini file is explained [[inifile?do=export_xhtml|here]].
Line 54: Line 75:
 And of course; everyone in the office, including you, should register. Explained next. And of course; everyone in the office, including you, should register. Explained next.
  
-====Registration===== 
- 
-To use //Git Winch// you not only need to install the software, but you should //also register.// And even the rest of your office who uses //Git Winch// should ALSO individually register.  
- 
-Note that //Git Winch// can be privately hosted too. So you need to check where you have to register. If you got the zip file from our website; then the registration is done from a link given on our main website for //Git Winch// namely; https://gitwinch.com  
- 
-If you are running a privately hosted version of //Git Winch// you would need to ask the person who gave you the zip file (or you could look inside the //gitwinch.ini// file and read the value given for entry named: //"SystemAPIurl"// and go to the website mentioned there) 
  
 ====Payments==== ====Payments====
installation.1751460972.txt.gz · Last modified: by admin

Page Tools