Threadbare uses Git Large File Storage (LFS) to store large assets, such as music and artwork, more efficiently. Git LFS is an extension to Git, and depending on which operating system you are using, it may not be installed & configured automatically. If you do not have Git LFS installed & configured, you will not be able to edit & run Threadbare after cloning the repository.

If you see errors like the following when opening Threadbare in the Godot Engine editor, this normally means that you have cloned the repository without Git LFS:

To solve this problem, you will need to install and configure Git LFS, and then re-clone the Threadbare repository. The steps to take depend on which operating system you are using. Once you have completed the steps below, close Godot, delete your clone of the Threadbare repository and clone it again.

Windows

Git LFS is included with Git for Windows, so no special action should be needed. Please let us know if this is not the case.

macOS

If you have followed our Set up Git guide, you will have installed git using Homebrew. Install Git LFS as follows:

1. Open Terminal
2. Run this command:

brew install git-lfs

3. Run this command:

git lfs install

4. You should see this message:

Git LFS initialized.

5. Now delete your clone of the Threadbare repository, and clone it again.

Linux

Depending on your Linux distribution, you may be able to install git-lfs through your package manager. If you are unable to do that:

1. Navigate to https://git-lfs.com/ and click Download
2. Unzip the file you downloaded
3. Open a Terminal window
4. Change directory to the folder you unzipped (the path will be different depending on exactly where you downloaded & unzipped the file):

cd ~/Downloads/git-lfs-1.x.x

6. Run this command:

./install.sh --local

7. Run this command:

git lfs install

8. You should see this message:

Git LFS initialized.

9. Now delete your clone of the Threadbare repository, and clone it again.