_Setup/Install Git.md

@@ -280,6 +280,44 @@ These are important as some of the videos have long names, and this will trigger
                 - Value data = `1`
 
 
+# Troubleshooting if repo "hangs" while cloning
+
+
+When cloning, if the repo 'hangs' or doesn't download fully, the following are a few things worth trying, roughly in order of which one will most likely fix the problem.
+
+1. **Increase the HTTP post buffer and Disable compression** (most common fix).  *These settings were mentioned in [the settings](#git-settings-for-windows-mac-linux) section above. We recommend setting all those listed there*:
+
+
+    ```bash
+    git config --global http.postBuffer 1048576000
+    git config --global http.compression 0
+    ```
+    Then retry the clone.
+
+
+2. **Try a shallow clone first** to see if the repo itself clones at all:
+
+
+    ```bash
+    git clone --recursive --depth 1 https://hub.openingdesign.com/OpeningDesign/Bonsai_Tutorials.git
+    ```
+
+3. **Clone without `--recursive`** first, then init submodules separately — this isolates whether the problem is the main repo or a submodule:
+
+
+    ```bash
+    git clone https://hub.openingdesign.com/OpeningDesign/Bonsai_Tutorials.git
+    cd Bonsai_Tutorials
+    git submodule update --init --recursive
+    ```
+
+4. **Use SSH instead of HTTPS** if you have an account on that Gitea instance — SSH avoids the HTTP chunked transfer issue entirely.
+    ```bash
+    git clone --recursive --depth 1 git@hub.openingdesign.com:OpeningDesign/Bonsai_Tutorials.git
+    ```
+
+
+
 <!--
 
         ```

_Setup/readme.md

@@ -13,11 +13,9 @@ The videos are currently encrypted--the following steps will allow you to unlock
 3. Sync the [Bonsai_Tutorials](https://hub.openingdesign.com/OpeningDesign/Bonsai_Tutorials) repo to your machine.  *(This will take some time, as it's a pretty big repo.)*
     - If using **TortoiseGit**, [Here's](https://youtu.be/riP1MDAagLM) a video.
     - If using **Gitnuro**, [Here's](https://youtu.be/auwdkWhnI1c) a video.
-      - *there's been reports, when using Gitnuro, that it freezes up when syncing the repo. If so, try pulling manually, instead.*
-        - command: `git.exe clone --progress --recursive -v "https://hub.openingdesign.com/OpeningDesign/Bonsai_Tutorials.git"`
-        -  *[Here's](https://www.dropbox.com/scl/fi/p78v6hyyyxxtjplpyorrl/20250910_1139.mp4?rlkey=w2xb97yzamtndl6gvvmroieyx&dl=0) a video of how do it via Windows, but this command works on all OS systems.*
-  
+      - *there's been reports, when using Gitnuro, that it freezes up when syncing the repo. If so, try pulling manually, instead. Instructions [Here](Install%20Git.md#troubleshooting-if-repo-hangs-while-cloning)*
 
+  
 2. Go [here](GPG%20Keys.md) to create a GPG key (will need this to unlock the videos).  
     - Email me (ryan@openingdesign.com) with your public key.
       - The file will have an `.asc` extension.