|
2 | 2 |
|
3 | 3 | This page outlines the various changes made the TagStudio save file format over time, sometimes referred to as the "database" or "database file". |
4 | 4 |
|
| 5 | +--- |
| 6 | + |
5 | 7 | ## JSON |
6 | 8 |
|
7 | | -| First Used | Last Used | Format | Location | |
8 | | -| ---------- | ----------------------------------------------------------------------- | ------ | --------------------------------------------- | |
9 | | -| v1.0.0 | [v9.4.2](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.4.2) | JSON | `<Library Folder>`/.TagStudio/ts_library.json | |
| 9 | +| Used From | Used Until | Format | Location | |
| 10 | +| --------- | ----------------------------------------------------------------------- | ------ | --------------------------------------------- | |
| 11 | +| v1.0.0 | [v9.4.2](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.4.2) | JSON | `<Library Folder>`/.TagStudio/ts_library.json | |
10 | 12 |
|
11 | 13 | The legacy database format for public TagStudio releases [v9.1](https://github.com/TagStudioDev/TagStudio/tree/Alpha-v9.1) through [v9.4.2](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.4.2). Variations of this format had been used privately since v1.0.0. |
12 | 14 |
|
13 | 15 | Replaced by the new SQLite format introduced in TagStudio [v9.5.0 Pre-Release 1](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.0-pr1). |
14 | 16 |
|
| 17 | +--- |
| 18 | + |
15 | 19 | ## DB_VERSION 6 |
16 | 20 |
|
17 | | -| First Used | Last Used | Format | Location | |
| 21 | +| Used From | Used Until | Format | Location | |
18 | 22 | | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------ | ----------------------------------------------- | |
19 | 23 | | [v9.5.0-PR1](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.0-pr1) | [v9.5.0-PR1](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.0-pr1) | SQLite | `<Library Folder>`/.TagStudio/ts_library.sqlite | |
20 | 24 |
|
21 | 25 | The first public version of the SQLite save file format. |
22 | 26 |
|
23 | 27 | 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. |
24 | 28 |
|
| 29 | +--- |
| 30 | + |
25 | 31 | ## DB_VERSION 7 |
26 | 32 |
|
27 | | -| First Used | Last Used | Format | Location | |
| 33 | +| Used From | Used Until | Format | Location | |
28 | 34 | | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------ | ----------------------------------------------- | |
29 | 35 | | [v9.5.0-PR2](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.0-pr2) | [v9.5.0-PR3](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.0-pr3) | SQLite | `<Library Folder>`/.TagStudio/ts_library.sqlite | |
30 | 36 |
|
31 | | -### Changes |
32 | | - |
33 | 37 | - Repairs "Description" fields to use a TEXT_LINE key instead of a TEXT_BOX key. |
34 | 38 | - Repairs tags that may have a disambiguation_id pointing towards a deleted tag. |
35 | 39 |
|
36 | | -## DB_VERSION 8 |
| 40 | +--- |
37 | 41 |
|
38 | | -| First Used | Last Used | Format | Location | |
39 | | -| ------------------------------------------------------------------------------- | --------- | ------ | ----------------------------------------------- | |
40 | | -| [v9.5.0-PR4](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.0-pr4) | _Current_ | SQLite | `<Library Folder>`/.TagStudio/ts_library.sqlite | |
| 42 | +## DB_VERSION 8 |
41 | 43 |
|
42 | | -### Changes |
| 44 | +| Used From | Used Until | Format | Location | |
| 45 | +| ------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ------ | ----------------------------------------------- | |
| 46 | +| [v9.5.0-PR4](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.0-pr4) | [v9.5.1](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.1) | SQLite | `<Library Folder>`/.TagStudio/ts_library.sqlite | |
43 | 47 |
|
44 | 48 | - Adds the `color_border` column to `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. |
45 | 49 | - Adds three new default colors: "Burgundy (TagStudio Shades)", "Dark Teal (TagStudio Shades)", and "Dark Lavender (TagStudio Shades)". |
46 | 50 | - Updates Neon colors to use the new `color_border` property. |
| 51 | + |
| 52 | +--- |
| 53 | + |
| 54 | +## DB_VERSION 9 |
| 55 | + |
| 56 | +| Used From | Used Until | Format | Location | |
| 57 | +| ----------------------------------------------------------------------- | ---------- | ------ | ----------------------------------------------- | |
| 58 | +| [v9.5.2](https://github.com/TagStudioDev/TagStudio/releases/tag/v9.5.2) | _Current_ | SQLite | `<Library Folder>`/.TagStudio/ts_library.sqlite | |
| 59 | + |
| 60 | +- Adds the `filename` column to the `entries` table. Used for sorting entries by filename in search results. |
0 commit comments