qTe Docs — Collections & Archive

Collections & Archive

Collection management, export/import, merge modes, and the recycle bin

Collections

Collections group related encoded items (Symphs) together by a shared GUID. Each collection has a name, description, tags, and category. Collections are stored in collections.json inside the qte_offsets folder and optionally synced to AT Proto.

COLLECTION STRUCTURE Collection GUID | Name | Description | Tags | Category Stored in qte_offsets/collections.json Symph Item A Symph Item B Symph Item C Symph Item D

Collection Operations

OperationDescription
CreateNew collection with name, description, tags, and category
Add ItemAssociate a Symph's metadata GUID with the collection
Remove ItemDisassociate a Symph from the collection
SearchFilter collections by name, tag, or category
Detail ViewShow all items in a collection with metadata
DeleteRemove collection definition (items remain in offsets)

Collection Types

The CollectionTypes class defines the available collection type categories, each with a Material Design icon identifier.

Standard Types

  • Documents
  • Images
  • Audio
  • Video
  • Archives

Custom Types

  • User-defined categories
  • Custom Material Design icon
  • Tag-based grouping
  • GUID-based filtering

Archive System

The archive system allows exporting and importing collections of encoded data as ZIP archives. Archives contain offset files, metadata, and an ArchiveManifest that describes the contents.

ARCHIVE EXPORT / IMPORT Export 1. Collect offset files (.qTe) 2. Collect metadata (JSON) 3. Build ArchiveManifest → ZIP Import 1. Extract ZIP archive 2. Validate ArchiveManifest 3. Merge with selected mode archive.qte.zip

ArchiveManifest

The manifest describes the archive contents: version, creation date, item count, total size, and a list of all included Symph identifiers with their metadata.

ArchiveValidator

Validates archive integrity before import: checks manifest structure, verifies all referenced files exist in the ZIP, and validates metadata format.

Merge Modes

When importing an archive that contains items already present locally, the merge mode determines behavior:

ModeBehavior
SkipSkip items that already exist locally (default, safest)
OverwriteReplace local items with imported versions
MergeKeep both — import creates new entries alongside existing ones

Recycle Bin

The RecycleBin provides soft-delete with restore capability. Deleted items are moved to a recycle folder and tracked in a JSON index. Items can be restored to their original location or permanently deleted.

Active File qte_offsets/ Delete Recycle Bin qte_recyclebin/ + index.json Restore Original Location Purge Permanently Deleted RecycledItem tracks: Symph, OriginalPath, DeletedDate, Filename, Size

RecycleBin Operations

OperationDescription
Recycle(path)Move file to recycle folder, add to index
Restore(id)Move file back to original location
Delete(id)Permanently delete a recycled item
EmptyBin()Permanently delete all recycled items
GetItems()List all items currently in the recycle bin