Spine Troubleshooting

Having trouble running Spine? Is Spine unable to start or crashes while you are using it? You have come to the right place!

While we strive for Spine to run flawlessly on all computers, sometimes things go wrong or Spine is run on configurations that we've never seen before. On this page you'll find a number of things you can check to get Spine running.

spine.log

When Spine runs, the first thing it does is create a log file at this location:

Windows

  • <user home folder>\Spine\spine.log

macOS

  • ~/Library/Application Support/Spine/spine.log

Linux

  • ~/.spine/spine.log

If any errors occur, they will appear in this file. Sometimes the error message is mixed with what looks like unintelligible information, so read carefully. If you can't make any sense of the errors, you can it post on the forum or send it to us. Please post or email the entire log, not just part of it (the forum will automatically remove your name and email from the log). Also, it helps a great deal to tell what you were doing when the error occurred. We love to fix bugs in Spine and are very grateful if you can help us reproduce any problem you might find.

Each time Spine runs it deletes the spine.log file and creates a new, empty one. If Spine crashes you should check the spine.log file before running Spine again.

spine.log is missing

If the spine.log file is never created, it means that something went wrong Spine very early in Spine's start up process. You may need to run Spine from the command line:

Windows

  • Open Command Prompt and type: "C:\Program Files (x86)\Spine\Spine.com"

macOS

  • Open Terminal and type: /Applications/Spine/Spine.app/Contents/MacOS/Spine
  • Alternatively, on macOS you can run the Console app, choose All Messages, then start Spine and watch the output in the Console app.

Linux

  • Run: Spine.sh

When you run Spine this way, Spine's logging is output in the command line window and you may see errors that give clues about why Spine is unable to start.

On macOS some other software may conflict with Spine. For example, some screen mirroring software or Finder "enhancements", such as Default Folder X, can prevent Spine from running. Also, Rescue Time needs to be closed when Spine is started.

Antivirus and anti-malware

Some antivirus or anti-malware software, such as Bit Defender or 360 Browser, will unjustifiably modify or delete Spine's files. This can cause Spine to fail to run completely, or to run only to fail later. You'll need to disable such software or whitelist Spine's folders so Spine won't get ruined. Spine's folders are:

Windows

  • C:\Program Files (x86)\Spine\ (or the folder where you installed Spine)
  • <user home folder>\Spine

macOS

  • /Applications/Spine/
  • ~/Library/Application Support/Spine/

Linux

  • The folder where you decompressed and placed Spine.
  • ~/.spine/

Firewall

When you install Spine, you are actually installing the Spine launcher. When you run Spine, it needs to download the version of Spine you want to run. If you have a firewall on your router or other network hardware or a software firewall that blocks Spine from reaching the server, then you'll need to disable the firewall or add rules to allow Spine's communication. Spine connects to esotericsoftware.com using ports 443 and 80.

Hosts file

Spine will be unable to run if your hosts file contains an entry that redirects network traffic for esotericsoftware.com. You'll see an error message about it in your spine.log file and you'll need to edit your hosts file to remove the entry:

Windows

  • C:\Windows\System32\drivers\etc\hosts

macOS and Linux

  • /etc/hosts

Proxy

If you require internet connections to use a proxy server, you'll need to start Spine with a special command to specify the proxy server. If you don't know if you need to configure Spine to use your proxy server, then you probably don't need to.

Slow internet

Our servers are located in Japan and Europe. If you are located in China or your internet connection to our servers is very slow, you may need to try multiple times or try again later.

Outdated launcher

One of the first things to check is that you are running the latest Spine launcher. To do that, go to your Spine license page which you received when you purchased Spine, then download and reinstall Spine. If you can't find your Spine license page, please contact us.

Outdated audio and video drivers

Spine uses hardware accelerated audio and video (OpenAL and OpenGL). Any bugs in the drivers for your audio or video hardware can cause Spine to crash or be unable to run at all. Make sure you have the latest drivers by going to the manufacturer's website for both your audio and video hardware, then download and install the latest drivers provided.

Disable audio

If you don't need Spine's audio capabilities, you can disable Spine's use of the audio hardware by starting Spine with the --disable-audio command line parameter. We've had reports of some bad audio drivers for gaming laptops.

User files

Spine stores settings and other files in your user folder:

Windows

  • <user home folder>\Spine

macOS

  • ~/Library/Application Support/Spine/

Linux

  • ~/.spine/

You can safely delete this entire folder and everything in it, which may help with some kinds of problems. However, you may want to first save some of the files:

  • The backup subfolder is where Spine stores copies of your projects each time you save.
  • The .json files are where Spine stores your settings. Delete them resets Spine to the default settings.
  • The hotkeys.txt file is where Spine stores the hotkeys to use for various actions. If you have customized this file, you probably want to keep it safe.
  • The updates subfolder is where Spine stores downloaded updates. Deleting them will cause Spine to download the updates again.

Outdated Spine version

You can choose which version of Spine to run in Spine's settings. If Spine is crashing, you may want to try the latest update. Please note that if you save your projects with a newer version, older versions won't be able to open it.

To run the latest version, choose Latest in Spine's settings. If you can't get to the settings dialog, you can delete the version.txt file here:

Windows

  • <user home folder>\Spine\version.txt

macOS

  • ~/Library/Application Support/Spine/version.txt

Linux

  • ~/.spine/version.txt

If the file doesn't exist, then Spine will use the latest version. If the file does exist, Spine will use the version specified in the file.

You can also specify the version via the command line. First choose a version from the changelog, for example 3.7.94, then run Spine this way:

Windows

  • Open Command Prompt and type: "C:\Program Files (x86)\Spine\Spine.com" --update 3.7.94

macOS

  • Open Terminal and type: /Applications/Spine/Spine.app/Contents/MacOS/Spine --update 3.7.94

Linux

  • Run: Spine.sh --update 3.7.94

If the latest version has problems for you, you might try going back to an older version (if you haven't yet saved your project with the newer version, or you get an older version of your project from your backups). We fix bugs very quickly, often within days (especially when users show us how to reproduce a problem!), but if you are having trouble with the latest version you may want to use an older version so you can be productive, rather than wait for a fix.

Still have problems?

If you have gone through the information above and you still have problems running Spine, please on the forum or contact us.