Skip to content

TagStudio Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[9.5.2] - 2024-03-06

Added

Settings

UI

  • feat(ui): merge media controls by @csponge in #805
    • fix: Remove border from video preview top and left by @zfbx in #900
  • feat(ui): add more default icons and file type equivalencies by @CyanVoxel in #882
  • ui: recent libraries list improvements by @CyanVoxel in #881

Misc

Fixed

Internal Changes

  • refactor!: change layout; import and build change by @xarvex and @CyanVoxel in #844
  • fix: log all problems in translation test by @Computerdores in #839
  • refactor: split translation keys for about screen by @CyanVoxel in #845
  • feat(ci): development tooling refresh and split documentation by @xarvex in #867
  • refactor: type hints and improvements in file_opener.py by @VasigaranAndAngel in #876
  • build: update spec file to use proper pathex and datas paths by @Leonard2 in #895
  • refactor: fix various missing and broken type hints@VasigaranAndAngel in #901
  • refactor: fix type hints and overrides in flowlayout.py by @VasigaranAndAngel in #880

Documentation

Translations

[9.5.1] - 2024-03-06

Fixed

  • Fixed translations crashing the program and preventing it from being reopened (#827)
  • Removed empty parentheses from the "About" screen title
    • fix: separate about screen title from translations by @CyanVoxel in #836

Translations

Documentation

[9.5.0] - 2024-03-03

Added

Overhauled Search Engine

Boolean Operators
Filetype, Mediatype, and Glob Path + Smartcase Searches
Sortable Results
Autocomplete

Replaced "Tag Fields" with Tag Categories

Instead of tags needing to be added to a tag field type such as "Meta Tags", "Content Tags", or just the "Tags" field, tags are now added directly to file entries with no intermediary step. While tag field types offered a way to further organize tags, it was cumbersome, inflexible, and simply not fully fleshed out. Tag Categories offer all of the previous (intentional) functionality while greatly increasing the ease of use and customization.

Thumbnails and File Previews

New Thumbnail Support
Audio Playback
Thumbnail Caching

Tags

Delete Tags (Finally!)
  • feat: remove and create tags from tag database panel by @DandyDev01 in #569
Custom User-Created Tag Colors

Create your own custom tag colors via the new Tag Color Manager! Tag colors are assigned a namespace (group) and include a name, primary color, and optional secondary color. By default the secondary color is used for the tag text color, but this can also be toggled to apply to the border color as well!

  • feat(ui)!: user-created tag colors@CyanVoxel in #801

New Tag Colors + UI

Screenshot 2025-01-04 at 04 23 43

New Tag Alias UI
  • fix: preview panel aliases not staying up to date with database by @DandyDev01 in #641
  • fix: subtags/parent tags & aliases update the UI for building a tag by @DandyDev01 in #534

Translations

TagStudio now has official translation support! Head to the new settings panel and select from one of the initial languages included. Note that many languages currently have incomplete translations.

Translation hosting generously provided by Weblate. Check out our project page to help translate TagStudio! Thank you to everyone who's helped contribute to the translations so far!

Initial Languages:

Miscellaneous

Fixed

Changed

SQLite Save File Format

This was the main focus of this update, and where the majority of development time and resources have been spent since v9.4. These changes include everything that was done to migrate from the JSON format to SQLite starting from the initial SQLite PR, while re-implementing every feature from v9.4 as the initial SQLite PR was based on v9.3.x at the time.

UI/UX

  • feat(ui): pre-select default tag name in BuildTagPanel by @Cool-Game-Dev in #592
  • feat(ui): keyboard navigation for editing tags by @Computerdores in #407
  • feat(ui): use tag query as default new tag name by @CyanVoxel in 29c0dfd
  • feat(ui): shortcut to add tags to selected entries; change click behavior of tags to edit by @CyanVoxel in #749
  • fix(ui): use consistent dark mode colors for all systems by @CyanVoxel in #752
  • fix(ui): use camera white balance for raw images by @CyanVoxel in 6ee5304
  • Mixed field editing has been limited due to various bugs in both the JSON and SQL implementations. This will be re-implemented in a future release.
  • fix(ui): improve tagging ux by @CyanVoxel in #633
  • fix(ui): hide library actions when no library is open by @CyanVoxel in #787
  • refactor(ui): recycle tag list in TagSearchPanel by @CyanVoxel in #788
    • feat(ui): add tag view limit dropdown
  • fix(ui): expand usage of esc and enter for modals by @CyanVoxel in #793

Performance

Internal Changes

  • refactor: combine open launch args by @UnusualEgg in #364
  • feat: add date_created, date_modified, and date_added columns to entries table by @CyanVoxel in #740

[9.5.0 Pre-Release 4] - 2025-02-17

Added

Custom User-Created Tag Colors (@CyanVoxel in #801)

Create your own custom tag colors via the new Tag Color Manager! Tag colors are assigned a namespace (group) and include a name, primary color, and optional secondary color. By default the secondary color is used for the tag text color, but this can also be toggled to apply to the border color as well!

Screenshot 2025-02-16 at 17 34 22

Screenshot 2025-02-16 at 17 32 56

Translations

TagStudio now has official translation support! Head to the new settings panel and select from one of the initial languages included. Note that many languages currently have incomplete translations.

Translation hosting generously provided by Weblate. Check out our project page to help translate TagStudio! Thank you to everyone who's helped contribute to the translations so far!

Initial Languages:

Fixed

  • feat(about): clickable links to docs/discord/etc in about modal by @SkeleyM in #799

Internal Changes

This release increases the internal DB_VERSION to 8. Libraries created with this version of TagStudio can still be opened in earlier v9.5.0 pre-release versions, however the behavior of custom color borders will not be identical to the behavior in this PR. Otherwise it should still be possible to use any custom colors created in this version in these earlier pre-releases (but not really recommended).

[9.5.0 Pre-Release 3] - 2025-02-10

Added

#743 by @CyanVoxel

Added "Smartcase" and Globless Path Search

  • path: temp: Returns all paths that have "temp" (Case insensitive) somewhere in the name.

  • path: Temp: Returns all paths that have "Temp" (Case sensitive) somewhere in the name.

Glob Patterns w/ Smartcase

  • path: *temp*: Returns all paths that have "temp" (Case insensitive) somewhere in the name.

  • path: *Temp*: Returns all paths that have "Temp" (Case sensitive) somewhere in the name.

  • path: temp*: Returns all paths that start with "temp" (Case insensitive) somewhere in the name.

  • path: Temp*: Returns all paths that start with "Temp" (Case sensitive) somewhere in the name.

  • path: *temp: Returns all paths that end with "temp" (Case insensitive) somewhere in the name.

  • path: *TEmP: Returns all paths that end with "TEmP" (Case sensitive) somewhere in the name.

#788 by @CyanVoxel
  • Added a "View Limit" dropdown to tag search boxes to limit the number of on-screen tags. Previously this limit was hardcoded to 100, but now options range from 25 to unlimited.

Changed

  • fix(ui): expand usage of esc and enter for modals by @CyanVoxel in #793
  • perf: optimize query methods and reduce preview panel updates by @CyanVoxel in #794
#788 by @CyanVoxel
  • Improved performance of tag search boxes, including the tag manager

Fixed

Docs

  • Added references to alternative POSIX shells, as well as pyenv to CONTRIBUTING.md by @ChloeZamorano in #791

[9.5.0 Pre-Release 2] - 2025-02-03

Added

#784 by @CyanVoxel
  • Add Ctrl+M shortcut to open the "Tag Manager"

Fixed

#784 by @CyanVoxel
  • Reset tag search box and focus each time a tag search panel is opened
  • Include tag parents in tag search results (v9.4 parity)
  • Lowercase tag names now get properly sorted with uppercase ones
  • Don't include tag display names in "closeness" factor when searching
  • Escape "&" characters inside tag names so Qt doesn't treat them as mnemonics
  • Set minimum tag width
  • Fix "Add Tags" panel missing its window title when accessing from the keyboard shortcut

Changed

#784 by @CyanVoxel
  • The "use for disambiguation" button has been moved to the right-hand side of parent tags in order to prevent accidental clicks involving the left-hand "remove tag" button
  • Add "Create & Add" button to the bottom of all non-whitespace searches, even if they return some tags
  • The awkward "+" button next to tags in the "Add Tags" panel has been removed in favor of clicking on tags themselves
  • Improved visual feedback for highlighting, keyboard focusing, and clicking tags
  • The clickable area of the "-" button on tags has been increased and has visual feedback when you hover and click it
  • You can now tab into the tag search list and add tags with a spacebar press (previously possible but very janky)
  • In tag search panels, pressing the Esc key will return your focus to the search bar and highlight your previous query. If the search box is already highlighted, pressing Esc will close the modal
  • In modals such as the "Add Tag" and "Edit Tag" panels, pressing Esc will cancel the operation and close the modal

Internal Changes

  • refactor: wrap migration_iterator lambda in a try/except block by @CyanVoxel in #773

Docs

[9.5.0 Pre-Release 1] - 2025-01-31

Added

Overhauled Search Engine

Boolean Operators
Filetype, Mediatype, and Glob Path Searches
Sortable Results
Autocomplete

Replaced "Tag Fields" with Tag Categories

Instead of tags needing to be added to a tag field type such as "Meta Tags", "Content Tags", or just the "Tags" field, tags are now added directly to file entries with no intermediary step. While tag field types offered a way to further organize tags, it was cumbersome, inflexible, and simply not fully fleshed out. Tag Categories offer all of the previous (intentional) functionality while greatly increasing the ease of use and customization.

Thumbnails and File Previews

New Thumbnail Support
Audio Playback
Thumbnail Caching

Tags

Delete Tags (Finally!)
  • feat: remove and create tags from tag database panel by @DandyDev01 in #569
New Tag Colors + UI

Screenshot 2025-01-04 at 04 23 43

New Tag Alias UI
  • fix: preview panel aliases not staying up to date with database by @DandyDev01 in #641
  • fix: subtags/parent tags & aliases update the UI for building a tag by @DandyDev01 in #534

Miscellaneous

Fixed

Changed

SQLite Save File Format

This was the main focus of this update, and where the majority of development time and resources have been spent since v9.4. These changes include everything that was done to migrate from the JSON format to SQLite starting from the initial SQLite PR, while re-implementing every feature from v9.4 as the initial SQLite PR was based on v9.3.x at the time.

UI/UX

  • feat(ui): pre-select default tag name in BuildTagPanel by @Cool-Game-Dev in #592
  • feat(ui): keyboard navigation for editing tags by @Computerdores in #407
  • feat(ui): use tag query as default new tag name by @CyanVoxel in 29c0dfd
  • feat(ui): shortcut to add tags to selected entries; change click behavior of tags to edit by @CyanVoxel in #749
  • fix(ui): use consistent dark mode colors for all systems by @CyanVoxel in #752
  • fix(ui): use camera white balance for raw images by @CyanVoxel in 6ee5304
  • Mixed field editing has been limited due to various bugs in both the JSON and SQL implementations. This will be re-implemented in a future release.

Performance

Internal Changes

  • refactor: combine open launch args by @UnusualEgg in #364
  • feat: add date_created, date_modified, and date_added columns to entries table by @CyanVoxel in #740

[9.4.2] - 2024-12-01

Added/Fixed

[9.4.1] - 2024-09-14

Added

  • Warn user if FFmpeg is not installed
  • Support for .raf and .orf raw image thumbnails and previews

Fixed

  • Use birthtime for file creation time on Mac & Windows
  • Use audio icon fallback when FFmpeg is not detected
  • Retain search query upon directory refresh

Changed

  • Significantly improve file re-scanning performance

[9.4.0] - 2024-09-04

Added

  • Copy and paste fields
  • Add multiple fields at once
  • Drag and drop files in/out of the program
  • Files can be shared by dragging them from the thumbnail grid to other programs
  • Files can be added to library folder by dragging them into the program
  • Manage Python virtual environment in Nix flake
  • Ability to create tag when adding tags
  • Blender preview thumbnail support
  • File deletion/trashing
  • Added right-click option on thumbnails and preview panel to delete files
  • Added Edit Menu option for deleting files
  • Added Delete key shortcut for deleting files
  • Font preview thumbnail support
  • Short "Aa" previews for thumbnails
  • Full alphabet preview for the preview pane
  • Sort tags by alphabetical/color
  • File explorer action follows OS naming
  • Preview Source Engine files
  • Expanded thumbnail and preview features
  • Add album cover art thumbnails
  • Add audio waveform thumbnails for audio files without embedded cover art
  • Add new default file thumbnails, both for generic and specific file types
  • Change the unlinked file icon to better convey its meaning
  • Add dropdown for different thumbnail sizes
  • Show File Creation and Modified dates; Restyle file path label

Fixed

  • Backslashes in f-string on file dupe widget
  • Tags not shown when none searched
  • Avoid error from eagerly grabbing data values
  • Correct behavior for tag search options
  • Load Gallery-DL sidecar files correctly
  • Correct duplicate file matching
  • GPU hardware acceleration in Nix flake
  • Suppress command prompt windows for FFmpeg in builds

Internal Changes

  • Move type constants to media classes
  • Combine open launch arguments
  • Revamp Nix flake with devenv/direnv in cb4798b
  • Remove impurity of Nix flake when used with direnv in bc38e56

[9.3.2] - 2024-07-19

Fixed

  • Fix signal log warning
  • Fix "Folders to Tags" feature
  • Fix search ignoring case of extension list

Internal Changes

  • Add tests into CI by
  • Create testing library files ad-hoc
  • Refactoring: centralize field IDs
  • Update to pyside6 version 6.7.1

[9.3.1] - 2024-06-13

Fixed

  • Separately pin QT nixpkg version
  • Bugfix for #252, don't attempt to read video file if invalid or 0 frames long
  • Toggle Mouse Event Transparency on ItemThumbs
  • Refactor video_player.py

[9.3.0] - 2024-06-09

Added

  • Added playback previews for video files
  • Added Boolean "and/or" search mode selection
  • Added ability to scan and fix duplicate entries (not to be confused with duplicate files) from the "Fix Unlinked Entries" menu
  • Added “Select All” (Ctrl+A / ⌘ Command+A) hotkey for the library grid view
  • Added "Clear Selection" hotkey (Esc) for the library grid view
  • Added the ability to invert the file extension inclusion list into an exclusion list
  • Added default landing page when no library is open

Fixed

  • TagStudio will no longer attempt to or allow you to reopen a library from a missing location
  • Fixed PermissionError when attempting to access files with a higher permission level upon scanning the library directory
  • Fixed RAW image previews sometimes not loadingand
  • Fixed most non-UTF-8 encoded text files from not being able to be previewed
  • Fixed "Refresh Directories"/"Fix Unlinked Entries" creating duplicate entries
  • Other miscellaneous fixes

Changed

  • Renamed "Subtags" to "Parent Tags" to help better describe their function
  • Increased number of tags shown by default in the "Add Tag" modal from 29 to 100
  • Documentation is now split into individual linked files and updated to include future features
  • Replaced use of os.path with pathlib
  • .cr2 files are now included in the list of RAW image file types
  • Minimum supported macOS version raised to 12.0

[9.2.1] - 2024-05-23

Added

  • Basic thumbnail/preview support for RAW images (currently .raw, .dng, .rw2, .nef, .arw, .crw, .cr3)
  • NOTE: These previews are currently slow to load given the nature of rendering them. In the future once thumbnail caching is added, this process should only happen once.
  • Thumbnail/preview support for HEIF images

Fixed

  • Fixed sidebar not expanding horizontally
  • Fixed "Recent Library" list not updating when creating a new library
  • Fixed palletized images not loading with alpha channels
  • Low resolution images (such as pixel art) now render with crisp edges in thumbnails and previews
  • Fixed visual bug where the edit icon would show for incorrect fields

[9.2.0] - 2024-05-14

Added

  • Full macOS and Linux support
  • Ability to apply tags to multiple selections at once
  • Right-click context menu for opening files or their locations
  • Support for all filetypes inside of the library
  • Configurable filetype blacklist
  • Option to automatically open last used library on startup
  • Tool to convert folder structure to tag tree
  • SIGTERM handling in console window
  • Keyboard shortcuts for basic functions
  • Basic support for plaintext thumbnails
  • Default icon for files with no thumbnail support
  • Menu action to close library
  • All tags now show in the "Add Tag" panel by default
  • Modal view to view and manage all library tags
  • Build scripts for Windows and macOS
  • Help menu option to visit the GitHub repository
  • Toggleable "Recent Libraries" list in the entry side panel

Fixed

  • Fixed errors when performing actions with no library open
  • Fixed bug where built-in tags were duplicated upon saving
  • QThreads are now properly terminated on application exit
  • Images with rotational EXIF data are now properly displayed
  • Fixed "truncated" images causing errors
  • Fixed images with large resolutions causing errors

Changed

  • Updated minimum Python version to 3.12
  • Various UI improvements
  • Improved legibility of the Light Theme (still a WIP)
  • Updated Dark Theme
  • Added hand cursor to several clickable elements
  • Fixed network paths not being able to load
  • Various code cleanup and refactoring
  • New application icons

Known Issues

  • Using and editing multiple entry fields of the same type may result in incorrect field(s) being updated
  • Adding Favorite or Archived tags via the thumbnail badges may apply the tag(s) to incorrect fields
  • Searching for tag names with spaces does not currently function as intended
    • A temporary workaround it to omit spaces in tag names when searching
  • Sorting fields using the "Sort Fields" macro may result in edit icons being shown for incorrect fields

[9.1.0] - 2024-04-22

Added

  • Initial public release