Text is a primary media record for written content stored or indexed by Cove. It has its own identity and descriptive metadata, separate from the document body Cove extracts from an attached file for reading.
| Field | Meaning |
| Title | Display title for the text record; a file basename can provide a display fallback when the title is empty. |
| Date | Calendar date associated with the text record. |
| Code | Studio- or publisher-assigned catalog code. |
| Details | Longer free-text notes, separate from the document body extracted from an attached file. |
| Organized | User-managed organization state. |
| Cover | Image used to represent the text record. |
| Created and Updated | Timestamps maintained by Cove for the record. |
| Relationship | Cardinality | Behavior |
| Studio | Zero or one | Primary studio or publisher associated with the text record. |
| Tags | Zero or more | Reusable classification metadata. |
| Performers | Zero or more | Associated performer identities. |
| Groups | Zero or more | Group memberships that include the text record. |
| URLs | Zero or more | Source or external links associated with the record. |
| Custom Fields | Zero or more | Administrator-defined text fields and values. |
| File value | Meaning |
| Path and Basename | Cove-visible source location and filename for each attached file. |
| File Size | Size in bytes, formatted for display. |
| Modified | Filesystem modification time discovered during scanning. |
| Format | Document format reported during scanning and extraction. |
| Word Count | Extracted word count for an attached file; the record exposes the largest available value. |
| Page Count | Extracted page count when the format provides pages; the record exposes the largest available value. |
| Excerpt | Short text extracted from an attached file for library previews. |
| Extracted content | Reading content produced from a selected attached file when requested; it is not stored as the record title or details. |
| Fingerprints | Available file hashes, including a text perceptual hash when generated. |
| Capability | Support | Behavior |
| Library list | Built in | Supports search, filters, sorts, display modes, selection actions, and extension contributions. |
| Document reading | Built in | Extracts and presents supported plain-text, Markdown, HTML, PDF, and EPUB content. |
| Multiple attached files | Supported | One text record can retain more than one file while the reading surface selects one file for display. |
| Source PDF display | Conditional | Can embed the selected source PDF when streaming access is available; otherwise Cove can present extracted text. |
| Engagement | Supported | Ratings, bookmarks, page visits, and time open are user-specific rather than shared descriptive fields. |
| Scraping and downloading | Conditional | Configured scrapers and downloaders can supply metadata or a source file from a URL. |
| Generated media | Conditional | Generation jobs can produce text perceptual hashes for attached files. |
| Timeline playback | Not applicable | Reading activity has no audiovisual playback timeline, resume position, or time-range segments. |
| Surface or operation | Availability |
| Browsing, detail, and extracted content | Require text-read access; content rules can further determine which records are visible. |
| Editing | Requires text-write access. |
| Deletion | Requires text-delete access. |
| File Info | Requires file-read access. |
| Source PDF or file stream | Requires text-read and streaming access and an available selected file. |
| Related entities | Studio, performer, tag, and group links appear only when the corresponding entity is readable. |
| Rescan | Requires library-scan access and at least one attached file. |
| Scraping | Requires text-write and system-read access and an available scraper. |
| Downloading | Requires system-read access for matching and preflight, plus job-run and text-write access to start the download. |
| Generation | Requires text-write and job-run access. |
| Extension surfaces | Appear only when the contributing extension is installed and enabled and the operation is authorized. |
| Event or operation | Effect |
| Create without a file | A metadata-only text record can exist before a downloader or scan supplies a source file. |
| Import or download a file | Scanning attaches a text file and extracts format-specific metadata and preview content. |
| Rescan | Re-reads an attached source to refresh its file and extracted metadata. |
| Delete record | Removes the text record, attached file rows, group memberships, custom values, and cover without inherently deleting source files. |
| Delete source files | Requires an explicit deletion choice and filesystem write access. |
| Delete generated cover thumbnails | A separate choice can remove cached derivatives of the text cover independently of source files. |
| Delete a shared path | Cove retains the source path when a text record outside the deletion still references it. |
A text record can have no file or several attached files. Cove selects an attached file for the reading surface and extracts content when it is requested. The render mode follows the source format, while the title, details, relationships, provenance, and organization state remain metadata on the text record.