Desktop readers, local archive analytics, and a search integration patch for ThreadShelf.
Reader 1.4.7 · Analytics 1.4.7 · Alternative 1.4.7 · Windows x64 · GNU/Linux amd64
Version 1.4.7 improves archived ChatGPT cards, charts, saved assets and supported local widgets in Reader and Alternative. Reading preferences can hide intermediate JSON-only responses visually, including search results that target a hidden response, while retaining the original queries, indexing, counts, sorting and analytics. Reader adds a themed conversation header that rolls into a thin strip and remembers its last position. Analytics keeps its 1.4.6 functionality. Node 26.13.1 LTS, Electron 45.3.0 stable and the existing build workflow remain in use. The embedded manual content remains 1.4.5; the application READMEs describe the new reading controls. See the changes, validation record, and GitHub checks.
| Application | Choose it when you want… |
|---|---|
| ThreadShelf Local Reader | A full reading workspace with a local archive, optional server connection, search, rich conversation rendering, and extensive appearance settings. |
| ThreadShelf Local Analytics | Read-only analysis of a Reader archive through captures, filters, charts, relationships, and exportable reports. |
| ThreadShelf Local Alternative | A separate, focused server-reading interface with saved searches, pins, a prompt outline, and a built-in demonstration. |
| Server patch | Complete paginated search integration for the desktop clients on the exact supported upstream ThreadShelf 1.3.0 and 1.4.1 baselines. |
Choose one package for your application and operating system. These are direct file downloads; Node.js and npm are not needed to run the desktop apps.
| Application | Version | Windows x64 | Linux amd64 | Debian / Ubuntu amd64 |
|---|---|---|---|---|
| Reader | 1.4.7 | Portable ZIP | Portable TAR.GZ | DEB package |
| Alternative | 1.4.7 | Portable ZIP | Portable TAR.GZ | DEB package |
| Analytics | 1.4.7 | Portable ZIP | Portable TAR.GZ | DEB package |
Verify downloads with 1.4.7 SHA256SUM.txt. The verification report and checksum instructions describe the tested files and their limits. Current application dependencies are recorded in their package lockfiles and the build guide. The historical 1.3.0 inventory does not describe the updated runtime. MathJax remains 4.1.3; speech dependencies are pinned in the CPU speech asset manifest.
- Windows: extract the entire portable ZIP and run the application EXE at the extraction root. Keep the runtime files beside it.
- Linux portable: extract the TAR.GZ and run the extracted root
threadshelf-local-*executable. Preserve the extracted directory structure and executable permissions. - Debian/Ubuntu: install the appropriate
.debwithsudo apt install ./<package-name>.deb, then launch it from the application menu.
The packages are unsigned. Linux needs the desktop libraries listed in the application's build/install guide. Analytics reads a compatible Reader archive or supported conversation exports; Alternative connects to a ThreadShelf server or runs the built-in synthetic demo. Semantic search requires the relevant search/embedding setup described in the manual.
Download and open the self-contained Reader 1.4.7 HTML preview or Alternative 1.4.7 HTML demo in a browser. They use synthetic examples and demonstrate the interface; native archive, server, disk-cache and speech operations require the desktop application.
Light and dark views of the public application renderers, captured with synthetic demonstration data. Click an image for its full resolution. Capture details.
| Reader · dark conversation view | Reader · light speech-cache controls |
|---|---|
 |
 |
| Alternative · dark reading workspace | Analytics · light dashboard |
|---|---|
 |
 |
- Read the manual on GitHub.
- Built HTML manual files: download or clone the complete repository, then open
docs/index.htmllocally. - Online user manual.
- Download the offline manual ZIP (1.4.7).
- Offline: open
docs/index.htmlin the source distribution, ormanual/index.htmlin the combined release distribution.
The illustrated Gopher manual covers installation, first use, workflows, settings, speech playback and providers, charts, search, data management, troubleshooting, and the server patch. Screenshots use synthetic demonstration data. See the manual's screenshot provenance for the precise capture method.
The hosted manual is published from the separate manual website repository. That repository contains the generated documentation and required notices; the application sources and releases remain here.
Reader and Alternative recognize saved Grok grok:render, grok-card, grok, and xaiArtifact content. Available metadata supplies citations, image cards and supported charts. Other cards show a labelled archive view with original source inspection; missing data stays visibly unavailable. Embedded scripts, forms, automation requests and application actions are never executed.
ChatGPT source references, line-ranged file citations, entities, source lists and archived widget markers are resolved from available export metadata. Unknown widgets retain readable fallback content. Rendering markers inside inline or fenced code remain literal, and whole-message copying/export preserves the original source. Images use each application's existing loading and privacy controls.
Reader and Alternative offer an SVG / Code toggle for chat code blocks with no language tag or an svg or xml tag. Eligible blocks contain one complete, valid SVG document; whitespace and XML comments may appear before or after the root. Raw SVG, strict Base64 and data:image/svg+xml;base64, input are supported. HTML containing embedded SVG, extra prose or elements, malformed content and other language tags keep their code presentation.
Blocks start in Code view. Select SVG to show the image, then Code to return. Copy keeps its existing source text, including the original Base64 representation. Previews use isolated image rendering: scripts and external resources do not run or load. Existing code, math, Mermaid and speech controls retain their behavior. See the Reader and Alternative guides.
Reader and Alternative include Pocket TTS and Kokoro for local CPU speech. Their models and runtimes are bundled in the desktop packages; first use does not download a model or require a system Python installation. Optional provider connections send the selected spoken text to the configured service. Choose voices, streaming, speed, volume, text inclusion and audio-cache settings in the application's Text-to-Speech settings. Pinned recordings take priority for an unchanged full message; a default-on cache preference also keeps existing API audio when a different provider, voice or code/citation selection is chosen. Reused audio preserves the original reading, and pinned files are never overwritten. See the manual for setup and privacy details.
Acquire ThreadShelf itself from ChrystianSchutz/ThreadShelf. Read server-patch/README.md before applying the supplied patcher. Separate 1.3.0 and 1.4.1 targets share the same root command. It checks the selected baseline, offers a dry run, backs up affected files, detects a previously applied patch, and supports rollback.
The 1.4.1 server target is available in the current master source tree; existing desktop release archives remain unchanged.
This repository contains the integration changes and patching tools. Configuration and archive data belong to each person's own server installation.
| Path | Purpose |
|---|---|
apps/reader/ |
Reader source, tests, assets and native packaging tools |
apps/analytics/ |
Analytics source, tests, assets and native packaging tools |
apps/alternative/ |
Alternative source, offline renderer dependencies and native packaging tools |
server-patch/ |
Versioned 1.3.0 and 1.4.1 integration patches, shared dispatcher and tests |
manual/ |
Editable manual content, fresh screenshots and Gopher 3.0.0 publisher |
docs/ |
Generated static user manual; README banner and screenshots in docs/extras/ |
maintainer/ |
GitHub setup, builds, release procedure and verification |
tools/ |
Suite-level build and source verification helpers |
Start with maintainer/BUILD.md. The suite pins Node.js 26.13.0 and a managed npm 12.2.2 toolchain with verified bundled-dependency fixes for development builds. Electron is pinned separately for each application; the embedded Node.js is part of that runtime.
Watch the real terminal build of Reader 1.2.0, Analytics 1.0.0, and Alternative 1.2.0 from commit c1030b0f0143. The recording covers dependency installation, tests, all nine Windows/Linux packages, archive validation, and SHA-256 checks.
ThreadShelf-Local-Suite-Real-Build-125x30.mp4
Download the MP4 · Interactive recording on asciinema · Download the asciinema cast
The 125×30 terminal capture preserves the original timing; the matching video is 1080p at 30 fps. The recorded run passed 951 tests, skipped 4, and verified all nine packages. Windows packages were cross-built on Linux; native Windows GUI execution is not shown. One public dependency-maintainer contact address is masked for publication.
For the repository owner, maintainer/GITHUB-SETUP.md explains the first upload, repository description/settings, private Git commit email, Pages, Actions and release assets. Tag pushes build all three applications and publish only after the native validation and release-integrity gates succeed.
ThreadShelf Local Suite is an independent companion project maintained by davoda1. It is not a fork of the upstream server and does not imply upstream endorsement. ThreadShelf server code is maintained by the original project. The integration patch identifies the upstream base and preserves applicable notices.
Original suite code is available under the MIT license, Copyright (c) 2026 davoda1. Third-party components, fonts, codecs, rendering libraries, and runtime files retain their own terms. See THIRD-PARTY-NOTICES.md and each application's included notices/source offers.
| Download | Version | Contents |
|---|---|---|
| Suite Source ZIP · Source TAR.GZ | 1.4.7 | Exact tagged application source, build tools, tests, notices, manual and server patch |
| Runtime sources: part 01 · part 02 · part 03 · part 04 · part 05 · part 06 · metadata/assembler | Electron 45.1.0 baseline | Historical selected Linux x64/Windows x64 source collection; current runtime additionally requires the versioned source supplement described in the source-access notice |
| Runtime Source Update TAR.GZ | Electron 45.2.3 | Verified changed source trees, deltas and offline update tools; requires the historical runtime parts and metadata above |
| ONNX sources: part 01 · part 02 · metadata/assembler | ONNX 1.31.1 | Native/Web/common source, active dependency closure, original recipes and verification |
| Native-Sources TAR.GZ | 1.0.0, unchanged scope | Reused sharp 0.35.5/libvips 8.18.7 source material only; original provenance limits retained |
Normal installation needs only an application package. For source access, keep every numbered part and the corresponding metadata ZIP. Extract the metadata ZIPs; the offline assemblers read the numbered source ZIPs directly. Use the 1.4.7 checksum manifest for new application assets and the runtime source update, the 1.3.0 checksum manifest for the historical Runtime baseline and unchanged ONNX source companions, and the original 1.0.0 checksum manifest for the unchanged Native-Sources download. Preserve matching sources, original notices and rebuild instructions alongside redistributed binaries. Rebuilding also needs the documented compilers, SDKs and build utilities; a complete binary rebuild or byte-identical reproduction is not claimed. See source verification, runtime source access, and ONNX source access.
Read the troubleshooting chapters, then open an issue with a minimal synthetic reproduction. Do not attach real conversation archives, access tokens, private URLs or personal configuration. See CONTRIBUTING.md and SECURITY.md.