CSV TSV Viewer

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

Description

Read-only CSV and TSV table viewer.

Reviews

No reviews yet.

Stats

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

Latest Version

4 days ago

Changelog

Maintenance 0.2.1: 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: fa9cb761b776296dae58cfa2f91d2fcd74d029da. 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

CSV TSV Viewer

CSV TSV Viewer is a read-only plugin for browsing .csv and .tsv files as tables. It is built for AI-generated data files, exports, logs, datasets, and quick inspection of delimited text without leaving the vault.

CSV TSV Viewer preview

Features

  • Opens .csv and .tsv files in a dedicated view.
  • Shows a table by default.
  • Provides a source view with line numbers and lightweight delimiter highlighting.
  • Filters visible rows by searching across cells.
  • Shows sticky column headers and row numbers.
  • Displays row count, column count, delimiter, and render cap status.
  • Detects comma, semicolon, and pipe delimiters in CSV files.
  • Uses tab as the delimiter for TSV files.
  • Parses quoted fields, escaped quotes, and multiline fields with Papa Parse.
  • Reports parse warnings, uneven row lengths, byte order marks, and large-file render caps.
  • Stays read-only by design: it never writes back to data files.

Large files

CSV and TSV files can become large quickly. CSV TSV Viewer parses the file and renders the first 10,000 rows to keep the view responsive. Additional rows are counted and reported in the warning area.

Privacy and security

CSV TSV 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?

CSV editing is more complex than it looks: quotes, escaped quotes, multiline cells, delimiters, and line endings can all be damaged by a casual edit flow. CSV TSV Viewer intentionally avoids writing to disk in v0.1.

Installation

Community plugin directory

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

BRAT installation

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

https://github.com/viggomeesters/obsidian-csv-tsv-viewer

Usage

Open any .csv or .tsv file in your vault. The file opens with CSV TSV Viewer.

Use the toolbar to:

  • filter visible rows
  • switch between table and source views
  • use First row as headers to show the first parsed row as column labels
  • use Ignore # comments to exclude records beginning with # from the table and delimiter detection while keeping them in Source. Quoted values beginning with # remain data.
  • 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/csv-tsv-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

CSV TSV Viewer is listed in the Obsidian Community directory.

License

MIT

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