qTe Documentation — Overview
What Is qTe?
qTe (Quantum Text Encoding) is a data encoding system that converts arbitrary files and text into
compact mathematical representations called Symphs. Each Symph is a 128-character string derived from
a bijective 65→64 byte compression that maps data through quantum-inspired coordinate systems, frequency offsets,
and syllable phonetics.
The system is entirely file-based and decentralized. There is no central database.
All data is stored locally as files and optionally synced to a personal AT Protocol (atproto) repository — the same
decentralized protocol that powers Bluesky. Your data lives in your PDS (Personal Data Server) using
private custom lexicon collections that are never indexed by the public Bluesky feed.
Architecture Overview
The qTe platform follows a shared-library architecture. The core encoding/decoding logic, networking,
blockchain, and all business workflows live in the qTe shared library. Two UI front-ends consume it:
qTeLite WinForms
Desktop-only Windows application. Code-behind pattern. The reference implementation — every feature works here first.
qTeApp MAUI
Cross-platform app (Windows, Android, iOS, macOS). MVVM architecture using CommunityToolkit.Mvvm. Calls the exact same qTe library methods.
Key Principle: qTeApp is ONLY the UI/UX layer. ALL workflows and logic are in the qTe shared library.
When something in qTeApp is broken, the fix is always in how qTeApp calls qTe, never in qTe itself.
Project Structure
| Project | Type | Framework | Purpose |
|---|
qTe |
Library |
.NET 10 |
Core shared library — encoding, decoding, AT Protocol, blockchain, networking, storage |
qTeLite |
WinForms |
.NET 10 |
Desktop reference UI — all features, UserControls, code-behind |
qTeApp |
MAUI |
.NET 10 |
Cross-platform MVVM app — ViewModels, Services, Desktop/Mobile XAML |
qTeCoin |
Library |
.NET 10 |
Blockchain token system |
Core Concepts
Symph
A 128-character string that uniquely represents encoded data. Generated from the bijective 65→64 byte
compression through phonetic syllable mapping. Contains coordinates, position data, cycle information, and
can be decoded back to the original data when combined with frequency offsets.
65→64 Byte Bijection (qTeByte)
The fundamental encoding operation. Takes 65 bytes (1 data byte + 64 carrier bytes) and produces 64 encoded
bytes through LSB bit-swapping. The data byte's 8 bits replace the LSBs of 8 carrier chunks, while the
original LSBs form a "stolen byte" that chains into the next encoding cycle. This is a lossless, reversible
information exchange — not compression.
Frequency Offsets
The difference between the mathematical coordinates of encoded data and the original carrier values.
Stored as .qTe files in the qte_offsets folder. Required for decoding — without
offsets, data cannot be restored.
AT Protocol Storage
All data syncs to your personal AT Protocol PDS using private lexicon collections
(app.qte.storage.*). Data is stored as encrypted blobs (up to 1MB each). These collections
are invisible to the public Bluesky feed — they exist only in your repository.
Hierarchical Chunked Encoding
Files larger than 8KB use a multi-layer parallel encoding system. Data is split into 4KB chunks, each
processed in parallel to produce a symph. Symphs from one layer become input for the next. This continues
until a single final symph represents the entire file.
Documentation Map
🔢 Encoding Pipeline
qTeByte, qTeBlock, qTeDouble, bijective mapping, hierarchical chunking, offset generation
🎵 Symph System
Symph generation, metadata, SymphEmbed, syllable phonetics, SymphSeries, blockchain
🌐 AT Protocol Network
ATProtocolClient, QteNetworkManager, sync, contacts, messaging, file sharing
🔒 Security & Protection
File protection (.qTe→.qTp), encryption, password chains, security phrases
📡 Syndication
Feed system, publishing, import, dynamic filters, deduplication
📂 Collections & Archive
Collection management, export/import, merge modes, recycle bin
🖼️ Memes
Meme storage, thumbnail generation, AT Proto blob sync, deduplication
📱 App Architecture
MAUI MVVM, ViewModels, Services, Desktop/Mobile views, navigation
📁 File Structure
Storage paths, folder layout, file formats, AT Proto collections
Technology Stack
| Component | Technology | Version |
|---|
| Runtime | .NET | 10 |
| Core Library Language | VB.NET | — |
| App Language | C# | — |
| Cross-Platform UI | .NET MAUI | — |
| Desktop UI | WinForms | — |
| MVVM Framework | CommunityToolkit.Mvvm | — |
| Decentralized Protocol | AT Protocol (atproto) | — |
| Decentralized Network | Bluesky PDS | — |
| Local Storage | JSON files + binary offsets | — |