Skip to content
wangl-ccPublic

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Gewu app icon

gewu 格物

A fast, native table viewer for large datasets.

Open downloaded data, explore its values and distributions, and find the rows that matter before moving to Python for deeper analysis.

Features

  • Browse, sort, find and filter your data in a native Mac interface.
  • Keep a column's statistics and distribution in view while filtering other columns, or explore a sampled scatter plot.
  • Switch between XLSX worksheets in the same window.
  • Read Parquet, CSV, TSV and XLSX files, including nested Parquet data.
  • Copy selected rows or export filtered results. Browsing leaves the source file unchanged.

Get started

Requires macOS 15 or later.

  1. Download Gewu from Releases: choose arm64 for Apple Silicon or x86_64 for Intel.
  2. Unzip the download. You can keep Gewu.app in that folder or move it to Applications.
  3. Launch Gewu and choose a file, or use File → Open… (⌘O).
If macOS blocks the first launch

Gewu is ad-hoc signed but not signed with Developer ID or notarized by Apple. If macOS blocks it because the developer cannot be verified, confirm that you downloaded it from this repository's Releases, then use System Settings → Privacy & Security → Open Anyway. Alternatively, open Terminal, change to the folder containing Gewu.app, and remove its quarantine attribute:

cd "/path/to/folder-containing-Gewu.app"
xattr -dr com.apple.quarantine Gewu.app

Replace the example folder path with your own. This removes the download quarantine attribute for Gewu; it does not sign or notarize the app.

Use Gewu → Settings… (⌘,) for display and copy preferences. Adjust histogram bins and scatter point limits beside their charts.

For files without column headers, use File → Import Options…. Save the current results with File → Export… (⇧⌘E); the initial default is Parquet with Zstd compression. See file formats for import and export details.

To build from source, follow the App build instructions.

File formats and limits

Gewu decodes the opened table into memory, so the dataset size you can explore depends on available RAM. Compressed file size can be much smaller than the memory required; for XLSX, only the selected worksheet is loaded as a table.

Format Read and export Main considerations
Parquet Typed tables, including lists and structs. Preferred for preserving types, nested values and nulls.
CSV / TSV Flat tables with inferred column types. Types are not preserved; empty strings and nulls read as null. Nested columns cannot be exported.
XLSX Read individual worksheets; export one worksheet. Dates/times and high-precision numbers export as text. Nested columns cannot be exported; workbook formatting and formulas are not preserved.

See format details for type inference, date handling and conversion rules.

Important

XLSX worksheets support up to 1,048,576 rows × 16,384 columns. Gewu reserves one row for headers, allowing 1,048,575 data rows per export.

Documentation

License

Copyright (c) 2026 The gewu contributors.

Gewu is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version (GPL-3.0-or-later).

Gewu is distributed without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the license for details.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages