qTe Docs — Symph System

Symph System

Symph generation, metadata, embedding, phonetic syllables, series, and blockchain

What Is a Symph?

A Symph (short for Symphony) is a 128-character string that uniquely identifies and represents encoded data. It is generated from the 64 encoded bytes produced by the qTeByte bijection, where each pair of bytes maps to a phonetic syllable through the coordinate system.

Think of a Symph as a musical address — each character encodes frequency, position, and cycle information derived from the original data. Combined with frequency offsets, the Symph can be used to perfectly reconstruct the original input.

Symph Example

KaRiMoSuTeNaLuPiZoFaHeWiDoBuXeJaCr...

128 characters, each pair representing a syllable mapped from coordinate positions

Symph Structure

Symph Properties

Property	Type	Description
`Value`	String	Numeric representation derived from coordinate position
`Words`	Word[]	Array of Word structures containing syllable data
`Bytes`	Byte[]	The raw byte representation
`Cycle`	Long	The frequency cycle number in the coordinate system
`Position`	Long	The position within the cycle
`Location`	String	Combined cycle+position string
`ValueOffset`	Decimal	The offset between location and frequency value

Syllable & Phonetic System

The phonetic layer converts byte values into two-character syllables built from consonant-vowel pairs. Each Syllable maps a single byte (0–255) to a unique consonant+vowel combination. Word structures group syllables, and Sonon wraps the full coordinate mapping.

Class	Role
`Syllable`	Maps a single byte to a consonant+vowel pair
`Consonant`	Consonant phoneme definitions
`Vowel`	Vowel phoneme definitions
`Word`	Groups syllables into word structures
`Sonon`	Wraps coordinate → sonic mapping (contains syllables + coordinates)

SymphMetadata

Every encoded item has a SymphMetadata object that stores descriptive information alongside the Symph. This metadata is persisted as JSON and synced to AT Proto.

Field	Type	Description
`Symph`	String	The 128-character Symph identifier (first 128 chars)
`Title`	String	Human-readable title
`Filename`	String	Original filename (if file-based)
`Extension`	String	Original file extension
`Author`	String	Creator/author
`Tags`	String	Comma-separated tags
`Category`	String	Material Design icon category identifier
`Summary`	String	Brief description
`DataLength`	Integer	Original data size in bytes
`Remainder`	Integer	Remainder bytes for chunk alignment
`Packets`	Integer	Number of encoding packets (ceil(DataLength/1024))
`TimeStamp`	Long	UTC ticks when encoded
`Privacy`	Integer	Privacy level (0=public, 1=contacts, 2=private)
`RequiresPassword`	Boolean	Whether password is needed for decoding
`GUID`	String	Unique identifier for collection grouping
`Fields`	String	Custom field data (JSON-encoded)
`Workflow`	String	Workflow state information

SymphEmbed — The Encoding Engine

SymphEmbed is the high-level encoding orchestrator. It takes input (file stream, text, or binary data), processes it through the encoding pipeline, generates the Symph and metadata, and stores offset files.

Key Methods

Method	Description
`EmbedMultiThreaded(addBlock, useOffline, originaldatalength)`	Main encoding method — processes stream through parallel pipeline, returns SymphMetadata
`Convert136charSymphToSymphBytes(symph, resourcesPath, useOffline, offsetDbPath)`	Decoding method — converts Symph string back to original bytes
`EncodeMetadataSymph(metadata, password, addBlock, privacy)`	Encodes metadata itself as a Symph for blockchain entries

SymphSeries & Groups

When encoding large files, multiple Symphs may be generated (one per chunk/layer). These are tracked as SymphGroup and SymphSeries structures.

SymphGroup

Represents a single encoding group containing multiple Symphs produced from one layer of hierarchical encoding. Tracks the group's encoding result including all chunk Symphs and their offsets.

SymphSeries

A collection of SymphGroups across all layers for a single file encoding operation. The series terminates at the final Symph that represents the entire file.

Symph Blockchain

The Symph blockchain is a chain of encoded blocks where each block contains a metadata Symph, a reference to the previous block, and a UTC timestamp. Blocks are synced via the BlockchainSync class.

Block Contents (136 bytes total)

Segment	Size	Content
Metadata Symph	64 bytes	The Symph-encoded metadata for this block's entry
Previous Block	64 bytes	The Symph of the previous block in the chain
Timestamp	8 bytes	UTC binary timestamp (`DateTime.UtcNow.ToBinary`)

SymphMetadataStore

SymphMetadataStore is a static singleton that persists all SymphMetadata objects. It provides lookup by Symph identifier and stores data as JSON in the qte_metadata folder. The store is used by both encoding (writing new metadata) and decoding (looking up titles, filenames, tags).

Key Operations

GetMetadata(symph) — Retrieve metadata by Symph string
SaveMetadata(metadata) — Persist metadata to the store
GetAllMetadata() — List all stored metadata entries
DeleteMetadata(symph) — Remove a metadata entry