{"id":13496660,"url":"https://github.com/wfxr/csview","last_synced_at":"2025-05-14T12:11:33.565Z","repository":{"id":36960429,"uuid":"295618462","full_name":"wfxr/csview","owner":"wfxr","description":"📠 Pretty and fast csv viewer for cli with cjk/emoji support.","archived":false,"fork":false,"pushed_at":"2025-04-21T09:31:01.000Z","size":303,"stargazers_count":649,"open_issues_count":10,"forks_count":17,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-05-12T06:51:34.410Z","etag":null,"topics":["cjk","cli","command-line","csv","pager","rust","table","terminal","tool"],"latest_commit_sha":null,"homepage":"https://github.com/wfxr/csview","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wfxr.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":"FUNDING.yml","license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"ko_fi":"wfxr"}},"created_at":"2020-09-15T04:55:22.000Z","updated_at":"2025-05-07T18:07:43.000Z","dependencies_parsed_at":"2023-02-19T05:25:17.433Z","dependency_job_id":"31ba75f0-5842-4584-87dd-9240a51ed43e","html_url":"https://github.com/wfxr/csview","commit_stats":{"total_commits":260,"total_committers":7,"mean_commits":"37.142857142857146","dds":0.4,"last_synced_commit":"69e311e76ad7b6296858f5919ea203f3e7ff305a"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wfxr%2Fcsview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wfxr%2Fcsview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wfxr%2Fcsview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wfxr%2Fcsview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wfxr","download_url":"https://codeload.github.com/wfxr/csview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254140766,"owners_count":22021220,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cjk","cli","command-line","csv","pager","rust","table","terminal","tool"],"created_at":"2024-07-31T19:01:55.494Z","updated_at":"2025-05-14T12:11:33.508Z","avatar_url":"https://github.com/wfxr.png","language":"Rust","readme":"\u003ch1 align=\"center\"\u003e📠 csview\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n    \u003cem\u003eA high performance csv viewer with cjk/emoji support.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/wfxr/csview/actions?query=workflow%3ACICD\"\u003e\n        \u003cimg src=\"https://github.com/wfxr/csview/workflows/CICD/badge.svg\" alt=\"CICD\"/\u003e\n    \u003c/a\u003e\n    \u003cimg src=\"https://img.shields.io/crates/l/csview.svg\" alt=\"License\"/\u003e\n    \u003ca href=\"https://crates.io/crates/csview\"\u003e\n        \u003cimg src=\"https://img.shields.io/crates/v/csview.svg?colorB=319e8c\" alt=\"Version\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/wfxr/csview/releases\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/platform-%20Linux%20|%20OSX%20|%20Win%20|%20ARM-orange.svg\" alt=\"Platform\"/\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/wfxr/i/master/csview-screenshot.png\" /\u003e\n\n### Features\n\n* Small and *fast* (see [benchmarks](#benchmark) below).\n* Memory efficient.\n* Correctly align [CJK](https://en.wikipedia.org/wiki/CJK_characters) and emoji characters.\n* Support `tsv` and custom delimiters.\n* Support different styles, including markdown table.\n\n### Usage\n```\n$ cat example.csv\nYear,Make,Model,Description,Price\n1997,Ford,E350,\"ac, abs, moon\",3000.00\n1999,Chevy,\"Venture \"\"Extended Edition\"\"\",\"\",4900.00\n1999,Chevy,\"Venture \"\"Extended Edition, Large\"\"\",,5000.00\n1996,Jeep,Grand Cherokee,\"MUST SELL! air, moon roof\",4799.00\n\n$ csview example.csv\n┌──────┬───────┬───────────────────────────────────┬───────────────────────────┬─────────┐\n│ Year │ Make  │               Model               │        Description        │  Price  │\n├──────┼───────┼───────────────────────────────────┼───────────────────────────┼─────────┤\n│ 1997 │ Ford  │ E350                              │ ac, abs, moon             │ 3000.00 │\n│ 1999 │ Chevy │ Venture \"Extended Edition\"        │                           │ 4900.00 │\n│ 1999 │ Chevy │ Venture \"Extended Edition, Large\" │                           │ 5000.00 │\n│ 1996 │ Jeep  │ Grand Cherokee                    │ MUST SELL! air, moon roof │ 4799.00 │\n└──────┴───────┴───────────────────────────────────┴───────────────────────────┴─────────┘\n\n$ head /etc/passwd | csview -H -d:\n┌────────────────────────┬───┬───────┬───────┬────────────────────────────┬─────────────────┐\n│ root                   │ x │ 0     │ 0     │                            │ /root           │\n│ bin                    │ x │ 1     │ 1     │                            │ /               │\n│ daemon                 │ x │ 2     │ 2     │                            │ /               │\n│ mail                   │ x │ 8     │ 12    │                            │ /var/spool/mail │\n│ ftp                    │ x │ 14    │ 11    │                            │ /srv/ftp        │\n│ http                   │ x │ 33    │ 33    │                            │ /srv/http       │\n│ nobody                 │ x │ 65534 │ 65534 │ Nobody                     │ /               │\n│ dbus                   │ x │ 81    │ 81    │ System Message Bus         │ /               │\n│ systemd-journal-remote │ x │ 981   │ 981   │ systemd Journal Remote     │ /               │\n│ systemd-network        │ x │ 980   │ 980   │ systemd Network Management │ /               │\n└────────────────────────┴───┴───────┴───────┴────────────────────────────┴─────────────────┘\n```\n\nRun `csview --help` to view detailed usage.\n\n### Installation\n\n#### On Arch Linux\n\n`csview` is available in the Arch User Repository. To install it from [AUR](https://aur.archlinux.org/packages/csview):\n\n```\nyay -S csview\n```\n\n#### On macOS\n\nYou can install `csview` with Homebrew:\n\n```\nbrew install csview\n```\n\n#### On NetBSD\n\n`csview` is available from the main pkgsrc Repositories. To install simply run\n\n```\npkgin install csview\n```\n\nor, if you prefer to build from source using [pkgsrc](https://pkgsrc.se/textproc/csview) on any of the supported platforms:\n\n```\ncd /usr/pkgsrc/textproc/csview\nmake install\n```\n\n#### On Windows\n\nYou can install `csview` with [Scoop](https://scoop.sh/):\n```\nscoop install csview\n```\n\n#### From binaries\n\nPre-built versions of `csview` for various architectures are available at [Github release page](https://github.com/wfxr/csview/releases).\n\n*Note that you can try the `musl` version (which is statically-linked) if runs into dependency related errors.*\n\n#### From source\n\n`csview` is also published on [crates.io](https://crates.io). If you have latest Rust toolchains installed you can use `cargo` to install it from source:\n\n```\ncargo install --locked csview\n```\n\nIf you want the latest version, clone this repository and run `cargo build --release`.\n\n### Benchmark\n\n- [small.csv](https://gist.github.com/wfxr/567e890d4db508b3c7630a96b703a57e#file-action-csv) (10 rows, 4 cols, 695 bytes):\n\n|                                           Tool                                           | Command                   | Mean Time |  Min Time |    Memory |\n|:----------------------------------------------------------------------------------------:|---------------------------|----------:|----------:|----------:|\n|                   [xsv](https://github.com/BurntSushi/xsv/tree/0.13.0)                   | `xsv table small.csv`     |     2.0ms |     1.8ms |     3.9mb |\n|  [csview](https://github.com/wfxr/csview/tree/90ff90e26c3e4c4c37818d717555b3e8f90d27e3)  | `csview small.csv`        | **0.3ms** | **0.1ms** | **2.4mb** |\n| [column](https://github.com/util-linux/util-linux/blob/stable/v2.37/text-utils/column.c) | `column -s, -t small.csv` |     1.3ms |     1.1ms | **2.4mb** |\n|                [csvlook](https://github.com/wireservice/csvkit/tree/1.0.6)               | `csvlook small.csv`       |   148.1ms |   142.4ms |    27.3mb |\n\n- [medium.csv](https://gist.github.com/wfxr/567e890d4db508b3c7630a96b703a57e#file-sample-csv) (10,000 rows, 10 cols, 624K bytes):\n\n|                                           Tool                                           | Command                   |  Mean Time |   Min Time |    Memory |\n|:----------------------------------------------------------------------------------------:|---------------------------|-----------:|-----------:|----------:|\n|                   [xsv](https://github.com/BurntSushi/xsv/tree/0.13.0)                   | `xsv table medium.csv`    |     0.031s |     0.029s |     4.4mb |\n|  [csview](https://github.com/wfxr/csview/tree/90ff90e26c3e4c4c37818d717555b3e8f90d27e3)  | `csview medium.csv`       | **0.017s** | **0.016s** | **2.8mb** |\n| [column](https://github.com/util-linux/util-linux/blob/stable/v2.37/text-utils/column.c) | `column -s, -t small.csv` |     0.052s |     0.050s |     9.9mb |\n|                [csvlook](https://github.com/wireservice/csvkit/tree/1.0.6)               | `csvlook medium.csv`      |     2.664s |     2.617s |    46.8mb |\n\n- `large.csv` (1,000,000 rows, 10 cols, 61M bytes, generated by concatenating [medium.csv](https://gist.github.com/wfxr/567e890d4db508b3c7630a96b703a57e#file-sample-csv) 100 times):\n\n|                                           Tool                                           | Command                   |  Mean Time |   Min Time |    Memory |\n|:----------------------------------------------------------------------------------------:|---------------------------|-----------:|-----------:|----------:|\n|                   [xsv](https://github.com/BurntSushi/xsv/tree/0.13.0)                   | `xsv table large.csv`     |     2.912s |     2.820s |     4.4mb |\n|  [csview](https://github.com/wfxr/csview/tree/90ff90e26c3e4c4c37818d717555b3e8f90d27e3)  | `csview large.csv`        | **1.686s** | **1.665s** | **2.8mb** |\n| [column](https://github.com/util-linux/util-linux/blob/stable/v2.37/text-utils/column.c) | `column -s, -t small.csv` |     5.777s |     5.759s |   767.6mb |\n|                [csvlook](https://github.com/wireservice/csvkit/tree/1.0.6)               | `csvlook large.csv`       |    20.665s |    20.549s |  1105.7mb |\n\n### F.A.Q.\n\n---\n#### We already have [xsv](https://github.com/BurntSushi/xsv), why not contribute to it but build a new tool?\n\n`xsv` is great. But it's aimed for analyzing and manipulating csv data.\n`csview` is designed for formatting and viewing. See also: [xsv/issues/156](https://github.com/BurntSushi/xsv/issues/156)\n\n---\n#### I encountered UTF-8 related errors, how to solve it?\n\nThe file may use a non-UTF8 encoding. You can check the file encoding using `file` command:\n\n```\n$ file -i a.csv\na.csv: application/csv; charset=iso-8859-1\n```\nAnd then convert it to `utf8`:\n\n```\n$ iconv -f iso-8859-1 -t UTF8//TRANSLIT a.csv -o b.csv\n$ csview b.csv\n```\n\nOr do it in place:\n\n```\n$ iconv -f iso-8859-1 -t UTF8//TRANSLIT a.csv | csview\n```\n\n### Credits\n\n* [csv-rust](https://github.com/BurntSushi/rust-csv)\n* [prettytable-rs](https://github.com/phsym/prettytable-rs)\n* [structopt](https://github.com/TeXitoi/structopt)\n\n### License\n\n`csview` is distributed under the terms of both the MIT License and the Apache License 2.0.\n\nSee the [LICENSE-APACHE](LICENSE-APACHE) and [LICENSE-MIT](LICENSE-MIT) files for license details.\n","funding_links":["https://ko-fi.com/wfxr"],"categories":["Rust"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwfxr%2Fcsview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwfxr%2Fcsview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwfxr%2Fcsview/lists"}