https://github.com/canadaluke888/ttb2
TerminalTableBuilder 2
https://github.com/canadaluke888/ttb2
c17 csv data database datasets datautils json ncurses ods spreadsheet sqlite3 tables terminal terminaltablebuilder terminaltablebuilder2 ttb ttb2 ttbx xlsx
Last synced: 3 days ago
JSON representation
TerminalTableBuilder 2
- Host: GitHub
- URL: https://github.com/canadaluke888/ttb2
- Owner: canadaluke888
- License: mit
- Created: 2025-05-04T06:06:22.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-04-06T03:21:23.000Z (3 days ago)
- Last Synced: 2026-04-06T03:24:08.694Z (3 days ago)
- Topics: c17, csv, data, database, datasets, datautils, json, ncurses, ods, spreadsheet, sqlite3, tables, terminal, terminaltablebuilder, terminaltablebuilder2, ttb, ttb2, ttbx, xlsx
- Language: C
- Homepage:
- Size: 1.91 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# TTB2 — Terminal Table Builder 2.0
TTB2 is the new and improved 2.0 version of the terminal table builder. It features a clean ncurses UI that displays table data live, list-based menus, an integrated SQLite database manager, autosave, paging for wide and tall tables, an inline search mode, interactive row/column deletion, and a simple JSON-backed settings system. CSV and XLSX import/export support is built in.
All of the features you're used to, just improved.
## Install
Dependencies (Debian/Ubuntu packages):
- GCC/Clang (`build-essential`)
`sudo apt install build-essential`
- ncurses (wide-char) (`libncursesw5-dev`)
`sudo apt install libncursesw5-dev`
- SQLite3 (`libsqlite3-dev`)
`sudo apt install libsqlite3-dev`
- JSON-C (`libjson-c-dev`)
`sudo apt install libjson-c-dev`
- zlib (`zlib1g-dev`)
`sudo apt install zlib1g-dev`
Build the native binary:
```
make
```
This produces `./build/ttb2`.
Install to your `PATH`:
```
sudo make install
```
Override the install prefix if needed:
```
make install PREFIX=/usr
make install DESTDIR=/tmp/package-root
```
Clean:
```
make clean
```
## Usage
```bash
ttb2
ttb2 path/to/data.csv
ttb2 path/to/data.xlsx
ttb2 path/to/table.ttbl
ttb2 path/to/book.ttbx
```
Supported startup inputs:
- `.csv`
- `.xlsx`
- `.ttbl`
- `.ttbx` directory books
## Highlights
- Interactive table editing (add columns/rows; rename columns; change types; edit cells)
- Fast load and render times; smooth scrolling even on large tables
- Low‑RAM seek paging (SQLite-backed, streaming windows; no OFFSET) — toggle in Settings
- Row‑number gutter (centered, toggle in Settings)
- Data types: int, float, str, bool (color‑coded)
- Column paging with ←/→ and footer hints
- Row paging with ↑/↓
- Search mode: press F to search; navigate matches with ←/→/↑/↓; Esc exits; exact substring highlight inside the selected cell
- Edit mode tools: [x] Delete Row, [Shift+X] Delete Column (guarded), [Backspace] Clear Cell
- DB Manager: Connect/Create/Delete DB, Load Table, Delete Table, Close
- Smart sync prompts when connecting/creating DB or loading CSV with a conflicting table name
- Workspace auto-save to `.ttbx` projects (toggle via Settings, manual save with `S`)
- Settings modal (saved to `settings/settings.json`; includes type inference, Low‑RAM seek paging, row gutter)
- Exports: native CSV and XLSX save options (no external runtime required)
## Screenshots
### Main UI
### Table Menu
## Keybindings
- `c` Add column
- `r` Add row
- `e` Edit mode (arrows to navigate, Enter to edit, Esc to exit)
- `f` Search mode (arrows to jump matches, Esc to exit)
- `S` Save workspace project
- `Ctrl+H` Jump to top‑left (Home)
- `m` Table menu (Rename, Save, Load, New Table, DB Manager, Settings)
- In Edit mode:
- `x` Delete row (interactive; Enter confirms)
- `Shift+X` Delete column (interactive; Enter confirms)
- `Backspace` Clear cell (with confirmation)
- `Ctrl+H` Jump to top‑left (Home)
- `q` Quit
Notes:
- Terminals often report Home as `Ctrl+H`; both are shown as “Home” in the footer.
## Performance / Low‑RAM Mode
- Enable “Low‑RAM seek paging” in Settings to browse large datasets without loading everything into memory.
- Rows are fetched in small windows and rendered incrementally to keep memory and latency stable.
- On Windows terminals, flicker is minimized by double‑buffered updates and scanning only visible rows for column widths.
## Workspace & Exports
- A project workspace lives in `workspace/session.ttbx` by default. The file is created automatically and updated whenever autosave triggers or you press `S`.
- Use the Export menu to write the current data as:
- `.ttbl` – a single-table snapshot
- `.ttbx` – a project/workbook bundle
- `.csv` or `.xlsx`
- Export now lets you browse to a destination directory in-app before entering the output filename.
## Runtime Files
- Settings are stored in `settings/settings.json`.
- The active workspace session book is stored in `workspace/session.ttbx` while the app is running.
## CI
GitHub Actions installs build deps and runs a simple `make`; build logs are visible in the job output.
## Author
Luke Canada ()