TXT Viewer

by Viggo Meesters
5
4
3
2
1
Score: 52/100

Description

Read-only TXT viewer plugin with line numbers, search navigation, filtering, and large-file guards.

Reviews

No reviews yet.

Stats

2
stars
2,165
downloads
1
forks
165
days
3
days
3
days
4
total PRs
0
open PRs
1
closed PRs
3
merged PRs
2
total issues
0
open issues
2
closed issues
9
commits

Latest Version

4 days ago

Changelog

Maintenance 0.1.2: checked on Obsidian 1.15.1 desktop (macOS arm64), with unchanged runtime code. Adds the checked-version documentation and reproducible official lint tooling while retaining existing repository guards.

Exact reviewed source: 0ede9e0e5d11439dd380fca99cb77ad80280a1db. The QA document records actual fixture oracles, exercised actions, additional smoke coverage and limits. Clean local validation and independent source/runtime/visual review passed; the official exact-SHA source preview completed.

Mobile, minimum-version, native resize and real authentication/keychain behavior were not verified. Final public asset readback, official release review and fresh Community installation are checked separately.

README file from

Github

TXT Viewer

TXT Viewer is a read-only plugin for inspecting .txt files with line numbers, search navigation, filtering, line-ending warnings, and large-file guards.

It is not a text editor. It is built for quick inspection of plain text exports, AI output, notes from other systems, and generated files where opening a raw text file is not enough context.

TXT Viewer preview

Features

  • Opens .txt files in a dedicated view.
  • Shows stable line numbers.
  • Supports soft wrap on/off.
  • Searches within the file and navigates between matching lines.
  • Offers a filter mode that shows only matching lines while preserving original line numbers.
  • Shows line count, character count, byte count, line-ending type, wrap status, filter status, and render cap status.
  • Reports mixed line endings and possible binary content.
  • Refreshes the file after external changes.
  • Renders large files with caps to keep the view responsive.
  • Stays read-only by design: it never writes back to text files.

Large files

TXT Viewer renders the first 10,000 lines in normal text mode. Filter mode renders the first 1,000 matching lines. Additional lines are counted and reported in the status or warning area.

Privacy and security

TXT Viewer does not make network requests and does not send vault content to external services. It does not use the system clipboard. It reads files through the vault API and renders a local view.

Why read-only?

Plain text looks simple, but editing still creates risk around encodings, line endings, generated output, and accidental changes. TXT Viewer intentionally avoids writing to disk in v0.1.

Installation

Community plugin directory

Install from the Obsidian Community directory or search for TXT Viewer in Settings → Community plugins → Browse.

Manual installation

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Create this folder in your vault: .obsidian/plugins/txt-viewer/.
  3. Put the downloaded files in that folder.
  4. Reload the app.
  5. Enable TXT Viewer in Settings -> Community plugins.

BRAT installation

For beta testing, install the plugin with BRAT using this repository URL:

https://github.com/viggomeesters/obsidian-txt-viewer

Usage

Open any .txt file in your vault. The file opens with TXT Viewer.

Use the toolbar to:

  • search inside the file
  • move to the previous or next matching line
  • switch between full text and filtered lines
  • toggle soft wrap
  • refresh the file after external changes

Development

npm install
npm run build
npx tsc --noEmit
npm test

For local development, copy or symlink this repository into .obsidian/plugins/txt-viewer/ inside a test vault.

Release process

Community plugin files are installed from GitHub releases. For each release:

  1. Update manifest.json, package.json, and versions.json.
  2. Run npm install, npm run build, npx tsc --noEmit, and npm test.
  3. Create a GitHub release whose tag exactly matches manifest.json.version.
  4. Attach main.js, manifest.json, and styles.css as release assets.

The repository includes a GitHub Actions release workflow with artifact attestation support. If GitHub Actions is disabled for the owner account, manual releases are still usable, but automated review may show a recommendation about missing artifact attestations.

Community directory

TXT Viewer is listed in the Obsidian Community directory.

License

MIT

Obsidian 1.15.1 assessment: checked source, local results and remaining host validation.