# tagstudiodev/tagstudio **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/tagstudiodev-tagstudio).** 6,766 stars · 445 forks · Python · gpl-3.0 ## Links - GitHub: https://github.com/TagStudioDev/TagStudio - Homepage: https://docs.tagstud.io/ - awesome-repositories: https://awesome-repositories.com/repository/tagstudiodev-tagstudio.md ## Topics `document-management-system` `file-manager` `metadata` `organizer` `photo-gallery` `photo-organizer` `tagger` `tagging` `tags` ## Description TagStudio is a database-driven digital asset manager designed to organize and categorize files without altering their physical location on disk. It utilizes a non-destructive metadata store to attach tags and custom fields to files via a separate database rather than modifying original file headers. The project is distinguished by a hierarchical tagging system that supports parent-child relationships and custom color palettes for visual organization. It includes a multi-format media previewer that generates thumbnails and playback for images, videos, audio, documents, and archives, as well as a boolean file search engine for complex metadata filtering. The system provides comprehensive capabilities for local file indexing, including automatic synchronization, relative path tracking for library relocation, and schema-based custom fields. Additional tools cover bulk workflow automation via a command-line interface and data pack imports for sharing tags and macros. ## Tags ### Data & Databases - [Flexible Metadata Stores](https://awesome-repositories.com/f/data-databases/flexible-metadata-stores.md) — Implements a flexible, non-destructive metadata store that attaches tags and custom fields to files without altering original binaries. - [Hierarchical Tags](https://awesome-repositories.com/f/data-databases/tagging-systems/hierarchical-tags.md) — Implements a hierarchical tagging system supporting parent-child relationships, inheritance, and custom colors. ([source](https://docs.tagstud.io/roadmap/)) - [Boolean Query Languages](https://awesome-repositories.com/f/data-databases/boolean-query-languages.md) — Implements a search engine using boolean operators, grouping, and nesting for complex metadata filtering. ([source](https://docs.tagstud.io/search/)) - [File Path Synchronization](https://awesome-repositories.com/f/data-databases/file-path-synchronization.md) — Automatically detects file renames, moves, and deletions to keep library metadata linked to the actual file locations. ([source](https://docs.tagstud.io/roadmap)) - [Metadata-Based Organization](https://awesome-repositories.com/f/data-databases/metadata-based-organization.md) — Categorizes files using a non-destructive metadata layer instead of physical directory paths. ([source](https://docs.tagstud.io/libraries)) - [Directory Walkers](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/directory-walkers.md) — Utilizes a high-performance directory walker to index files and folders with glob-style exclusion patterns. ([source](https://docs.tagstud.io/install)) - [Filesystem Directory Walkers](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-and-indexing/indexing-exclusion-filters/filesystem-directory-walkers.md) — Provides a fast directory-walking indexer to build the asset database using glob-style exclusion patterns. - [Automatic Background Indexing](https://awesome-repositories.com/f/data-databases/search-indexing/automatic-background-indexing.md) — Automatically triggers index updates upon directory scanning to keep the local library synchronized with the filesystem. ([source](https://docs.tagstud.io/libraries/)) - [Sidecar Metadata Tracking](https://awesome-repositories.com/f/data-databases/sidecar-metadata-tracking.md) — Attaches structured data and custom fields to files for descriptive tracking without modifying the original file binary. - [Tag-Based Search](https://awesome-repositories.com/f/data-databases/tag-based-search.md) — Filters library entries using tag names, shorthands, and aliases, including automatic matching for parent tags. ([source](https://docs.tagstud.io/search/)) - [Virtual Library Indexing](https://awesome-repositories.com/f/data-databases/virtual-library-indexing.md) — Scans folders to create a local database for tracking files without altering the physical filesystem. ([source](https://docs.tagstud.io/usage/)) - [Boolean Logic Engines](https://awesome-repositories.com/f/data-databases/boolean-logic-engines.md) — Provides a boolean logic engine to filter assets using complex operators and metadata predicates. - [Data Import and Export](https://awesome-repositories.com/f/data-databases/data-import-and-export.md) — Provides a system to export and import tags, colors, and macros using standardized, human-readable formats. ([source](https://docs.tagstud.io/roadmap/)) - [File Rename Tracking](https://awesome-repositories.com/f/data-databases/file-rename-tracking.md) — Tracks file properties like dimensions and duration while maintaining historical references during file renames. ([source](https://docs.tagstud.io/roadmap/)) - [Property-Based Filtering](https://awesome-repositories.com/f/data-databases/property-based-filtering.md) — Provides conditional searches based on file properties such as dates, durations, sizes, and dimensions. ([source](https://docs.tagstud.io/roadmap)) - [Relative Path Tracking](https://awesome-repositories.com/f/data-databases/relative-path-tracking.md) — Tracks file locations relative to the library root to allow moving content folders between drives without breaking links. ([source](https://docs.tagstud.io/libraries/)) - [Directory-to-Tag Conversion](https://awesome-repositories.com/f/data-databases/tagging-systems/hierarchical-tags/directory-to-tag-conversion.md) — Transforms directory hierarchies into nested tag systems by applying folder names as tags to files. ([source](https://docs.tagstud.io/macros/)) - [Visual Tag Coding](https://awesome-repositories.com/f/data-databases/tagging-systems/hierarchical-tags/visual-tag-coding.md) — Links specific colors from a palette to tags to visually categorize and identify files. ([source](https://docs.tagstud.io/colors/)) ### Software Engineering & Architecture - [Non-Destructive Editing Workflows](https://awesome-repositories.com/f/software-engineering-architecture/non-destructive-editing-workflows.md) — Implements a non-destructive metadata layer that stores tags in a separate database without modifying source files. - [Relative Path Indexing](https://awesome-repositories.com/f/software-engineering-architecture/runtime-path-resolvers/path-normalizers/path-relation-calculations/relative-path-indexing.md) — Tracks file locations using relative paths to allow moving content folders between drives without breaking links. ### Business & Productivity Software - [Digital Asset Managers](https://awesome-repositories.com/f/business-productivity-software/digital-asset-managers.md) — Serves as a digital asset manager for organizing and categorizing large media collections using non-destructive metadata. - [File Tagging Systems](https://awesome-repositories.com/f/business-productivity-software/file-tagging-systems.md) — Organizes and categorizes files and folders using a non-destructive system of descriptive tags, colors, and icons. ([source](https://docs.tagstud.io/roadmap)) - [Logical Asset Grouping](https://awesome-repositories.com/f/business-productivity-software/logical-asset-grouping.md) — Clusters files into non-exclusive, nestable groups that can be tagged and sorted independently. ([source](https://docs.tagstud.io/roadmap)) - [Path and Filename Search](https://awesome-repositories.com/f/business-productivity-software/path-and-filename-search.md) — Locates files by searching for specific strings within the complete filepath or filename. ([source](https://docs.tagstud.io/search/)) ### Content Management & Publishing - [Media Thumbnail Management](https://awesome-repositories.com/f/content-management-publishing/media-management/media-thumbnail-management.md) — Integrates with external system tools to extract and store visual preview assets for audio, video, and archive files. ([source](https://docs.tagstud.io/install)) ### Development Tools & Productivity - [Local Filesystem Indexers](https://awesome-repositories.com/f/development-tools-productivity/search-indexing-tools/local-file-indexers/local-filesystem-indexers.md) — Scans local or network directories to build a searchable database of files with automatic refresh capabilities. - [Item Detail Views](https://awesome-repositories.com/f/development-tools-productivity/github-integration-tools/item-detail-views.md) — Provides dedicated detail panels for viewing file statistics, metadata, and thumbnails. ([source](https://docs.tagstud.io/entries/)) - [Bulk Asset Maintenance](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-triggers/metadata-workflow-automators/bulk-asset-maintenance.md) — Combines CLI utilities and trigger-based actions to perform mass tagging and library maintenance. ### Graphics & Multimedia - [Asset Preview Generators](https://awesome-repositories.com/f/graphics-multimedia/asset-preview-generators.md) — Generates thumbnails and previews for a diverse range of formats including images, videos, audio, and archives. - [Asset Previews](https://awesome-repositories.com/f/graphics-multimedia/multi-format-media-players/asset-previews.md) — Provides a multi-format previewer for images, videos, audio, and documents to facilitate rapid asset identification. ### User Interface & Experience - [Custom Data Fields](https://awesome-repositories.com/f/user-interface-experience/field-customization/custom-data-fields.md) — Allows users to define custom structured data fields, such as dates and titles, for descriptive file tracking. ([source](https://docs.tagstud.io/)) - [File Previewers](https://awesome-repositories.com/f/user-interface-experience/file-previewers.md) — Provides a unified system for inspecting various file formats including images, videos, and audio without opening the primary application. ([source](https://cdn.jsdelivr.net/gh/tagstudiodev/tagstudio@main/README.md)) - [Customizable Collection Views](https://awesome-repositories.com/f/user-interface-experience/customizable-collection-views.md) — Supports customizable grid and list views with infinite scrolling for browsing library entries and the filesystem. ([source](https://docs.tagstud.io/roadmap)) - [Color Palette Management](https://awesome-repositories.com/f/user-interface-experience/ui-architecture/design-utilities/design-systems/color-system-utilities/color-palette-management.md) — Provides a system for defining custom color palettes and organizing them into namespaces for visual organization. ([source](https://docs.tagstud.io/colors/)) ### Operating Systems & Systems Programming - [Broken Link Resolvers](https://awesome-repositories.com/f/operating-systems-systems-programming/broken-link-resolvers.md) — Detects files that have been moved or deleted and relinks database entries to their new paths. ([source](https://docs.tagstud.io/usage/)) ### System Administration & Monitoring - [Library Scan Exclusions](https://awesome-repositories.com/f/system-administration-monitoring/file-listing-exclusions/library-scan-exclusions.md) — Supports glob-style patterns to exclude specific files and directories from being indexed during library scans. ([source](https://docs.tagstud.io/ignore/)) - [Library Maintenance](https://awesome-repositories.com/f/system-administration-monitoring/library-maintenance.md) — Includes tools to identify unlinked entries and resolve obsolete backups to maintain the integrity of the library index. ([source](https://docs.tagstud.io/roadmap)) ### Web Development - [External Previews](https://awesome-repositories.com/f/web-development/search-result-management/external-previews.md) — Integrates external system tools to render media previews and thumbnails within the asset browser.