Using GIN

You need to use the terminal emulator to use Gin offline.

There is the web interface for Gin that can be used to manage repositories online, but with some limitations (only up to 100 files with <1GB/file can be uploaded).

Installation

https://gin.g-node.org/achilleas/gin-cli-builds/

Windows

1. Download the version 1.12dev ZIP file (either "gin-cli-1.12dev-windows32.zip" or "gin-cli-1.12dev-windows64.zip", depending on your CPU architecture).
2. Inspect the archive, and move the content of the archive to e.g. "C:\Programs\Gin".
3. Double-click "C:\Programs\Gin\set-global.bat".

Now open your terminal emulator. Running "where gin" should show the path, e.g. "C:\Programs\Gin\gin.bat".

MacOS

1. Download the "gin-cli-latest-macos.zip" and double click the downloaded file to extract the contents.
2. Place the extracted contents under e.g. "/Users/<your name>/Gin". You will see the program file with the path "/Users/<your name>/Gin/gin".
3. Add the parent directory (e.g. "/Users/<your name>/Gin") to PATH.

Now open your terminal emulator. Running "which gin" should show the path to the program file, e.g. "/Users/<your name>/Gin/gin".

Linux

Only Debian-based distributions (Raspberry Pi OS, Ubuntu, Linux Mint etc.) are supported.

1. Download "gin-cli-latest.deb", and double click the ".deb" file.

Now open your terminal emulator. Running "which gin" should show the path to the gin program, e.g. "/usr/local/bin/gin".

Making gin command-line client available for you

1. Make sure that you have a Gin account online at https://gin.g-node.org
2. Open your terminal emulator in your computer, and run `gin login`. It will ask you your login details (it will happen only once). After it says "successfully logged in", you can manage your repositories that you see online.

Preparation of a local repository

Creating a repository online

The simplest way of creating a new repository is to do it online, using the web interface.

After logging in, click on the "+" button appearing at the top-right of the page.

- "New repository" - "Import repository"

Management of a repository

(Not recommended) the simplest way

Although the "simplest" way of using gin is as follows, it often results in a weird behavior which can ruin your repository very easily. So this way of using gin is not recommended...

- Checking in all the changes you have made so far: `gin commit` - Reflecting your changes in the on-line copy: `gin upload` - Locally reflecting the changes made in other computers: `gin download`