https://github.com/shshemi/tabiew
A lightweight TUI application to view and query tabular data files, such as CSV, TSV, and parquet.
https://github.com/shshemi/tabiew
Last synced: 30 days ago
JSON representation
A lightweight TUI application to view and query tabular data files, such as CSV, TSV, and parquet.
- Host: GitHub
- URL: https://github.com/shshemi/tabiew
- Owner: shshemi
- License: mit
- Created: 2024-04-27T16:21:19.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-03-12T21:03:06.000Z (about 1 month ago)
- Last Synced: 2025-03-24T09:18:08.427Z (about 1 month ago)
- Language: Rust
- Homepage:
- Size: 21.1 MB
- Stars: 881
- Watchers: 6
- Forks: 22
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rust - Tabiew
- awesome-rust - Tabiew - A lightweight TUI app to view and query CSV files. (Applications / Utilities)
- awesome-ratatui - tabiew - A lightweight TUI app to view and query CSV files. (💻 Apps / 🚀 Productivity and Utilities)
- fucking-awesome-rust - Tabiew - A lightweight TUI app to view and query CSV files. (Applications / Utilities)
- fucking-awesome-rust - Tabiew - A lightweight TUI app to view and query CSV files. (Applications / Utilities)
README
# Tabiew
Tabiew is a lightweight TUI application that allows users to view and query tabular data files, such as CSV, Parquet, Arrow, and ...
## Features
- ⌨️ Vim-style keybindings
- 🛠️ SQL support
- 📊 Support for CSV, Parquet, JSON, JSONL, Arrow, FWF, and Sqlite
- 🔍 Fuzzy search
- 📝 Scripting support
- 🗂️ Multi-table functionality## Tutorial
For a guide on using Tabiew, including instructions on opening files, navigating tables, performing queries, and using inline queries, kindly visit the [tutorial page](https://github.com/shshemi/tabiew/blob/main/tutorial/tutorial.md).
## Keybindings️
|Key Combination|Functionality|
|-|-|
| `Enter`| Open record sheet|
| `k` or `↑`| Move up|
| `j` or `↓`| Move down|
| `h` or `←`| Scroll left|
| `l` or `→`| Scroll right|
| `b` | Scroll to the previous column|
| `w` | Scroll to the next column|
| `e` | Toggle Auto-Fit|
| `Page Up` or `Ctrl + b`| Move one page up|
| `Page Down` or `Ctrl + f`| Move one page down|
| `H` or `Shift + ←`| Select previous tab|
| `L` or `Shift + →`| Select next tab|
| `Ctrl + u`| Move up half a page|
| `Ctrl + d`| Move down half a page|
| `Home` or `g`| Move to the first row|
| `End` or `G`| Move to the last row|
| `Ctrl + r`| Reset the data frame|
| `q`| Close tab / sheet|
| `:`| Command Pallete|
| `/`| Fuzzy Search|## Commands
|Command|Example|Description|
|-|-|-|
|`Q` or `query`|`Q SELECT * FROM df`|Query the data in Structured Query Language(SQL). The table name is the file name without extension|
|`S` or `select`| `S price, area, bedrooms, parking`|Query current data frame for columns/functions|
|`F` or `filter`| `F price < 20000 AND bedrooms > 4`|Filter current data frame, keeping rows were the condition(s) match|
|`O` or `order`| `O area`|Sort current data frame by column(s)|
|`tabn`| `tabn SELECT * FORM user WHERE balance > 1000`|Create a new tab with the given query|
|`q` or `quit` |`q`| Return to table from sheet view otherwise quit|
|`schema`| `schema`| Show loaded data frame(s) alongside their path(s)|
|`reset`| `reset`| Reset the table to the original data frame|
|`help`| `help`| Show help menu|## Installation
There are various ways to install Tabiew:
### Arch Linux
You can install from the [official repositories](https://archlinux.org/packages/extra/x86_64/tabiew/) using [pacman](https://wiki.archlinux.org/title/pacman):
```bash
pacman -S tabiew
```### Debian-based
Download the `.deb` package from the [GitHub releases page](https://github.com/shshemi/tabiew/releases) and run:
```bash
sudo dpkg -i
```### RPM-based
Download the `.rpm` package from the [GitHub releases page](https://github.com/shshemi/tabiew/releases) and run:
```bash
sudo rpm -i
```### MacOS
Installing Tabiew using [Homebrew](https://brew.sh/) from Homebrew core:
```bash
brew update
brew install tabiew
```
or tap:
```bash
brew install shshemi/tabiew/tabiew
```Note: Please be aware that installing Tabiew from the tap involves compiling it from the source, which may take some time to complete.
### Cargo
Installing Tabiew from *Crates.io*:
```bash
cargo install tabiew
```### Build from Source
Ensure you have rustc version 1.80 (or higher) installed. Download the desired source version from the [release page](https://github.com/shshemi/tabiew/releases). Extract the downloaded file and navigate into the extracted directory. Then run the following command:
```bash
cargo build --release
cp ./target/release/tw
```## Usage
Start Tabiew with `tw`
```bash
tw
```
To open TSV file(s), use:
```bash
tw --separator $'\t' --no-header
```
To open parquet file(s), use:
```bash
tw -f parquet
```## Themes
### Monokai (default):
### Argonaut:
### Nord:
### Catppuccin:
### Tokyo Night:
### Terminal:
## Contributing
Contributions are welcome! Please fork the repository and submit pull requests with your features and bug fixes.## License
This project is licensed under the MIT License - see the LICENSE file for details.