Spine provides many settings to customize its behavior.
To open the
Settings dialog, press
F12 or open the main menu by clicking the Spine logo in the upper left and choose
These settings affect the launcher, before a version of the Spine editor is started.
Sets the Spine editor version to use the next time Spine starts. This is the same as choosing a version on the Spine launcher dialog.
The select box shows all versions you have downloaded. You can click
See versioning for more information.
When checked, the Spine launcher will start the version of the Spine editor that was last used.
When unchecked, the Spine launcher stops to allow a version to be chosen. Clicking anywhere in the Spine launcher window when it first appears will prevent it from starting automatically.
These buttons open the corresponding folder when clicked.
This folder contains copies of project files made just before each save. Also, if auto backup is enabled, copies of the project file are saved periodically.
Windows: <user home folder>\Spine\backups
Mac: <user home folder>/Library/Application Support/Spine/backups
Linux: <user home folder>/.spine/backups
This text file contains all of Spine's hotkeys. The file can be edited to customize the hotkeys to your liking. See key names for a list of the key names that can be used.
When new hotkeys are added to Spine, they are added to the hotkeys file.
Windows: <user home folder>\Spine\hotkeys.txt
Mac: <user home folder>/Library/Application Support/Spine/hotkeys.txt
Linux: <user home folder>/.spine/hotkeys.txt
The spine.log file is written each time Spine starts. It may provide more details in case something goes wrong.
Windows: <user home folder>\Spine\spine.log
Mac: <user home folder>/Library/Application Support/Spine/spine.log
Linux: <user home folder>/.spine/spine.log
These settings affect the entire application.
When unchecked, colors are rendered to the monitor using sRGB using gamma blending. Most monitors use sRGB.
When checked, the monitor's color profile is used to render accurate colors. This is useful for monitors that use wide gamut colors or an ICC color profile other than sRGB. Enabling color management uses slightly more GPU resources.
When enabled, blending can be done in either gamma or linear space. Images are generally saved in gamma space and most game toolkits perform blending in gamma space because it requires less effort, even though the results are less accurate. When using linear blending at runtime, choosing linear blending allows you to see blending in Spine exactly as it will render at runtime.
Color management is not available for Linux.
|Editor frame rate
Sets the maximum frames per second that Spine can render at. Generally it should be set to the refresh rate of your monitor. This setting does not affect the timeline FPS.
Spine only renders when necessary, which is usually much less often than the editor frame rate, except when playing animations.
The editor frame rate may be overridden by GPU settings.
When checked, if a file is opened via an OS file explorer, it is opened in an existing Spine instance, if one is running.
When unchecked, a new Spine instance is started to open the file.
This setting is not available for Mac, where double clicking a file always reuses an existing Spine instance if possible. To open multiple instances of Spine on Mac, this command can be used:
open -n -a /Applications/Spine.app
When checked, the editor framerate is shown in the title bar as frames per second during animation playback. When not playing an animation, the FPS is not shown.
When checked, Spine will show the welcome screen on startup.
When unchecked, Spine will open the last opened project on startup. The welcome screen can still be accessed by clicking the mail button in Spine's titlebar:
These settings affect all of Spine's views and other parts of the user interface.
The language of the Spine user interface. It is set by default to the OS language, if possible.
Sets the font used by Spine's user interface. Some language require their own font.
Sets the font size used by Spine's user interface. Smaller font sizes allow more to be fit on screen at once, but may be harder to read. The
|Default timeline FPS
Sets the default timeline FPS for new projects.
Scales Spine's entire user interface larger or smaller. This allows the user interface to be a comfortable size for the size of monitor you are using.
When set higher than 100%, Spine uses 2x graphics so the user interface stays looking sharp. Scales other than 100% or 200% may appear less sharp.
Sets the height of each row in the dopesheet and graph. The default setting is the most visually appealing, but more rows can be shown at once with a smaller setting.
Allows customizing the toolbar position to maximize the usable editor space for your window size by placing the main toolbar on the left, center, or right.
|Toolbar text labels
The text labels on the main toolbar can be hidden to take up less space.
The amount in pixels to indent tree nodes in the tree view hierarchy. Lower indentation allows more to be shown in the tree horizontally, but makes it less obvious which tree nodes are underneath others.
These settings affect rendering of the skeletons and tools in the viewport.
Sets the colors and patterns to use for the editor background. The alpha can be set to zero for some colors to hide that part of the background, such as the gradient.
When doing screen capture to a lossy format, like GIF, it can be helpful to use a solid background color.
When unchecked, all triangles are drawn.
When checked, triangles facing away from the screen are not drawn. This can be useful to hide portions of a mesh that are not facing the screen. The same effect can be enabled in some game toolkits.
Scales the size of the bones and zoom levels so they better match the size of the skeletons. This is helpful when working with very small or very large skeletons.
When greater than zero, when images are loaded color bleeding is performed to copy neighboring colors into transparent pixels. This prevents artifacts when downscaling, meaning when the images are zoomed out or otherwise displayed smaller than their actual size. Higher values increase image loading time but may be needed when downscaling a large amount.
|Dim unselected skeletons
When checked and a project has multiple skeletons, skeletons that are not selected are drawn with more dimly. This can reduce clutter if many skeletons are visible at once.
When checked, edges of attachment images are highlighted when hovered or selected. When images have a lot of translucency, this may make the images difficult to see.
When checked, the attachment highlight is smoothed when zoomed in.
When unchecked, the attachment highlight is pixelated when zoomed in. This may be desirable when working with pixel art.
When checked, a red "missing" image is displayed when an image cannot be found for region and mesh attachments.
When unchecked, the image is shown as black.
GPU support for the chosen MSAA setting is required, else it will have no effect.
When checked, the viewport rendering is rasterized to simulate pixel art. When enabled, the rendering for each skeleton is limited to 2048x2048.
Sets the smoothing to apply to images in the viewport. Smoothing is a way of blurring the image to hide the pixel structure when upscaling, meaning when images are zoomed in or otherwise displayed larger than their actual size.
These settings affect the behavior of Spine's user interface.
When checked, the project is saved periodically in the backup folder, if it has changes since the last save. This is normally very fast, but for extremely large projects this may introduce unwanted pauses and can be disabled.
When unchecked and you choose to delete an item, Spine will no longer ask if you are sure you want to delete it. If an item is deleted accidentally, you can always use undo by pressing
|Double click shortcuts
Spine uses double click for a number of optional shortcuts, for example to rename an item in the tree or deselect in the viewport. When unchecked, those shortcuts are disabled. This can be useful when using a pen tablet, where it may be easy to accidentally double click.
When unchecked, Spine will not use animations in the user interface. This means menus will not open using an animation, dialogs will not fade in, etc.
|Middle mouse pans
When unchecked, the middle mouse button is used to make a new selection, regardless of the current selection. This is the default.
When checked, the middle mouse button is used for panning instead. This can be useful if coming from other software that uses the middle mouse button to pan.
When checked, panning a large amount continues for a very short amount of time to make the movement smoother.
When unchecked, panning always stops abruptly.
When checked, scrollbars are animated smoothly when scrolled instead of jumping instantly into position.
When unchecked, tooltips will not be shown by hovering the mouse. Tooltips can still be shown on demand by pressing
|Zoom to mouse
When checked, the mouse wheel or
When unchecked, zooming in/out uses the center of the viewport.
These settings affect the behavior of the dopesheet view.
|Jump to frame
When checked, the timeline position is set when empty space is clicked in the dopesheet.
|Jump to key
When checked, the timeline position is set to the key's frame when a key is clicked in the dopesheet.
These settings affect the behavior of the graph view.
|Drag to edit
When checked, dragging in empty space manipulates the graph selection. Like in the viewport, this reduces fatigue from using the mouse to animate for long hours.
When unchecked, keys and curve handles in the graph must be dragged to manipulate them.
|Jump to frame
When checked, the timeline position is set when empty space is clicked in the graph.
|Jump to key
When checked, the timeline position is set to the key's frame when a key is clicked in the graph.