Skip to content

Changelog

9.5.7 May 5th, 2026

This update adds several bugfixes and additions that have been sitting on the main branch for quite some time.

Added

Fixed

Changed

Internal Changes

Translations

New Contributors

9.5.6 October 20th, 2025

Added

Fixed

Changed

Internal Changes

Translations

9.5.5 September 8th, 2025

Added

New Settings

  • feat(ui): add thumbnail cache size setting to settings panel by @CyanVoxel in #1088
  • feat: add cached thumbnail quality and resolution settings by @CyanVoxel in #1101
    • Only available by editing the cached_thumb_quality and cached_thumb_resolution options in the settings.toml config file
  • fix: add option to use old Windows 'start' command by @CyanVoxel in #1084
    • Only available by editing the windows_start_command option in the settings.toml file
    • Fixes niche issue on Windows systems, see #1036
  • translations: add Czech, Portuguese (Portugal), and Romanian to settings panel (2db8bed)

File Previews

Fixed

Changed

Translations

Internal Changes

9.5.4 September 1st, 2025

Added

.ts_ignore File and Folder Ignore System

The previous system for ignoring file extensions has been replaced by a new .gitignore-style pattern matching system. This uses a .ts_ignore file inside your library's .TagStudio folder with glob-like rules to give more power options than what was previously possible. This file can be edited inside within TagStudio or externally, and rules are hot-reloaded in either case. Existing extension rules have been migrated as closely as possible to this new system. For more information on this new system, visit the "Ignore Files" page on the documentation site.

Screenshot 2025-08-22 at 14 31 15

Along with this system also comes the additional features:

  • TagStudio can now traverse symlinks in your library folders
  • TagStudio can now leverage ripgrep, a rust-based directory search tool, for faster library refreshing
Pull Requests:
  • feat: add .ts_ignore pattern ignoring system by @CyanVoxel in #897
  • feat: replace extension exclusion system with .ts_ignore by @CyanVoxel in #1046

Library Information Window

A new "Library Information" window has been added and is accessible under the "View" window. This window includes statistics about your currently opened library, as well as convenient access to library cleanup tools. This includes a new tool to cleanup "ignored files", which are files that have been previously added to your library but now no longer meet the ignore pattern rules.

Screenshot 2025-08-30 at 15 53 08

Pull Requests:
  • feat: add LibraryInfoWindow with library statistics by @CyanVoxel in #1056
  • feat: add library cleanup screen and 'fix ignored files' window by @CyanVoxel in #1070

Other Additions

splash_selection_half

Fixed

Changed

Performance

Translations

Internal Changes

9.5.3 August 7th, 2025

Added

Fixed

Changed

Translations

Internal Changes

Documentation

9.5.2 March 31st, 2025

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 March 6th, 2025

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 March 3rd, 2025

TagStudio 9.5 Banner

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.

Screenshot 2025-01-04 at 04 23 43

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!

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-pr4 February 17th, 2025

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!

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-pr3 February 10th, 2025

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-pr2 February 3rd, 2025

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-pr1 January 31st, 2025

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
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 December 1st, 2024

Added/Fixed

9.4.1 September 13th, 2024

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 September 3rd, 2024

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 July 18th, 2024

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 June 13th, 2024

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 June 8th, 2024

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 May 23rd, 2024

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 May 14th, 2024

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 April 22nd, 2024

Added

  • Initial public release