You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/updates/schema_changes.md
+22-8Lines changed: 22 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,12 +4,16 @@ icon: material/database-edit
4
4
5
5
# :material-database-edit: Save Format Changes
6
6
7
-
This page outlines the various changes made to the TagStudio save file format over time, sometimes referred to as the "database" or "database file".
7
+
This page outlines the various changes made to the TagStudio library save file format over time, sometimes referred to as the "database" or "database file".
8
8
9
9
---
10
10
11
11
## JSON
12
12
13
+
Legacy (JSON) library save format versions were tied to the release version of the program itself. This number was stored in a `version` key inside the JSON file.
@@ -20,42 +24,52 @@ Replaced by the new SQLite format introduced in TagStudio [v9.5.0 Pre-Release 1]
20
24
21
25
---
22
26
23
-
## DB_VERSION 6
27
+
## SQLite
28
+
29
+
Starting with TagStudio [v9.5.0-pr1](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.0-pr1), the library save format has been moved to a [SQLite](https://sqlite.org) format. Legacy JSON libraries are migrated (with the user's consent) to the new format when opening in current versions of the program. The save format versioning is now separate from the program's versioning number and stored inside a `DB_VERSION` attribute inside the SQLite file.
30
+
31
+
### Versions 1 - 5
32
+
33
+
These versions were used while developing the new SQLite file format, outside any official or recommended release. These versions **were never supported** in any official capacity and were actively warned against using for real libraries.
The first public version of the SQLite save file format.
30
44
31
45
Migration from the legacy JSON format is provided via a walkthrough when opening a legacy library in TagStudio [v9.5.0 Pre-Release 1](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.0-pr1) or later.
- Adds the `color_border` column to the `tag_colors` table. Used for instructing the [secondary color](../library/tag_color.md#secondary-color) to apply to a tag's border as a new optional behavior.
53
67
- Adds three new default colors: "Burgundy (TagStudio Shades)", "Dark Teal (TagStudio Shades)", and "Dark Lavender (TagStudio Shades)".
54
68
- Updates Neon colors to use the new `color_border` property.
0 commit comments