Log Viewer

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

Description

Read-only log file viewer for Obsidian.

Reviews

No reviews yet.

Stats

1
stars
581
downloads
1
forks
164
days
3
days
3
days
3
total PRs
0
open PRs
0
closed PRs
3
merged PRs
2
total issues
0
open issues
2
closed issues
10
commits

Latest Version

3 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: 83472c7c999d289e592cf0ef33321d682473fa8d. 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

Log Viewer

Log Viewer is a read-only plugin for browsing .log files in Obsidian. It is built for AI-output, agent logs, build logs, local automation output, and quick inspection of plaintext logs without leaving the vault.

Log Viewer preview

Features

  • Opens .log files in a dedicated view.
  • Shows a structured log table by default.
  • Detects common timestamps, including ISO 8601, YYYY-MM-DD HH:mm:ss, YYYYMMDD-HHmm, and epoch values.
  • Detects severity labels such as FATAL, ERROR, WARN, INFO, DEBUG, and TRACE.
  • Filters visible lines by text, severity, and timestamp presence.
  • Keeps a raw source view with line numbers and lightweight highlighting.
  • Preserves unstructured lines and stack traces with raw fallback behavior.
  • Displays line counts, timestamp counts, structured-line counts, severity counts, and render cap status.
  • Applies a 10,000-line render cap to keep Obsidian responsive.
  • Stays read-only by design: it never writes back to log files.

Large files

Logs can become large quickly. Log Viewer parses the file locally and renders the first 10,000 lines to avoid flooding Obsidian with a huge DOM tree. Additional lines are counted and reported in the warning area.

Privacy and security

Log 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?

Logs are evidence. Editing or normalizing them can damage timestamps, stack traces, multiline records, and raw diagnostic context. Log Viewer intentionally avoids writing to disk in v0.1.

Installation

Community plugin directory

Install from the Obsidian Community directory or search for Log 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/log-viewer/.
  3. Put the downloaded files in that folder.
  4. Reload the app.
  5. Enable Log Viewer in Settings -> Community plugins.

BRAT installation

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

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

Usage

Open any .log file in your vault. The file opens with Log Viewer.

Use the toolbar to:

  • filter visible lines
  • filter by severity
  • filter by timestamp presence
  • switch between structured log and raw source views
  • 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/log-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.

Community directory

Log Viewer is listed in the Obsidian Community directory.

License

MIT

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