Settings
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 Settings
.
Application
Launcher
These settings affect the launcher, before a version of the Spine editor is started.
Setting | Description |
---|---|
Version | 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. |
Start automatically | 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. |
Files
These buttons open the corresponding folder when clicked.
Setting | Description |
---|---|
Backups | 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 |
Hotkeys | 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 |
Log | 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 |
General
These settings affect the entire application.
Setting | Description |
---|---|
Color management | 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. |
Reuse instance | 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 |
Show FPS | 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. |
Welcome screen | 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: |
User interface
These settings affect all of Spine's views and other parts of the user interface.
Setting | Description |
---|---|
Language | The language of the Spine user interface. It is set by default to the OS language, if possible. |
Font | Sets the font used by Spine's user interface. Some language require their own font.
|
Font size | 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. |
Interface scale | 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. |
Row height | 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. |
Toolbar position | 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. |
Tree indentation | 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. |
Viewport
These settings affect rendering of the skeletons and tools in the viewport.
Setting | Description |
---|---|
Background | 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. |
Backface culling | 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. |
Bone scale | 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. |
Color bleed | 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. |
Highlight attachments | 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. |
Highlight smoothing | 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. |
Missing images | 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. |
Multisample anti-aliasing | When checked, Spine will use multisample anti-aliasing. This doesn't effect most of Spine's rendering but provides antialiasing when a mesh edge or clipping cuts through an image. GPU support for the chosen MSAA setting is required, else it will have no effect. |
Pixel grid | When checked, the viewport rendering is rasterized to simulate pixel art. When enabled, the rendering for each skeleton is limited to 2048x2048. |
Smoothing | 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.
When When |
Behavior
These settings affect the behavior of Spine's user interface.
Setting | Description |
---|---|
Automatic backup | 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. |
Delete confirmation | 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. |
Interface animations | 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. |
Pan momentum | 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. |
Smooth scrolling | When checked, scrollbars are animated smoothly when scrolled instead of jumping instantly into position. |
Tooltips | 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. |
Dopesheet
These settings affect the behavior of the dopesheet view.
Setting | Description |
---|---|
Box select pause | When checked, a brief pause is required after selecting to prevent the selection box from disappearing. |
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. |
Graph
These settings affect the behavior of the graph view.
Setting | Description |
---|---|
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. |