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, chooseAll Messages
, then start Spine and watch the output in theConsole
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.