Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Troubleshooting

What to do when datui does not do what you expect. Each row links to the page that explains it.

Terminal

ProblemWhat to do
F1 does nothing in AlacrittyAlacritty binds it in ~/.config/alacritty/alacritty.toml; unbind it there. ? opens help outside text fields
The mouse cannot select textShift+drag (Option+drag in iTerm2), or give the mouse back with --mouse=false: Mouse and text selection
Boxes, arrows and rails show as ? or garbageThe terminal does not take UTF-8, or its font lacks the glyphs: Glyphs or ASCII
Header and row stripes near-black on a light backgroundSet theme.mode = "light": Light and dark
Everything monochrome, or colors offNO_COLOR is set, or the terminal does not take 24-bit color: Configure datui
Header or chips garbled in VS Code’s terminalConfigure datui

Opening data

ProblemWhat to do
datui asks before reading a file into memoryJSON, Avro, ORC, Excel and some others are read whole; past read.memory_warning (1 GiB) datui asks first. How each format is read says which; Parquet, CSV and Arrow IPC are read lazily
datui asks before downloadingA web file, and a bucket object of a format not read in place, is copied to the temp directory first: How each format is read
A sort, query or analysis is slow on a large fileIt reads every row the operation needs, not just the screen: Large datasets
The first row of a CSV is data, or the header is--no-header, or H on the Info panel’s Schema tab: Delimited text
A file has no extension, or the wrong one--format NAME; datui --help lists the names: Formats
A file datui cannot read opens as bytesNo reader and no format spec takes it: Hex view, and Format specs to describe it

Config and cache

ProblemWhat to do
datui stops on a config errorFix the line it names, or move the file aside to start from the defaults; datui config init then writes a fresh one: Configure datui
Odd home-screen state: recents, folded sections, a hidden sourcedatui cache clear resets the cache, never your data or config: Configure datui

Cloud logins

A cloud source’s row on the home screen says why it lists nothing; its details pane gives the whole message. Cloud sources lists every row status.

Row or errorWhat to do
403The login cannot list buckets. Open an object by its URL: datui s3://<BUCKET>/<KEY>
not logged inNo usable credentials reached the store: Connect to cloud storage
no projectSet GOOGLE_CLOUD_PROJECT or DATUI_GCP_PROJECT: Google Cloud Storage
needs gcloud, needs the AWS CLIThe login goes through that tool, which is not installed
not signed inRun az login or Connect-AzAccount: Azure Blob Storage
not configuredA variable a [[cloud.connections]] entry names is not set: Cloud connections
An expired AWS SSO loginaws sso login --profile <PROFILE>: AWS profiles

Windows

ProblemWhat to do
Another program cannot replace a file datui has opendatui reads files through memory maps, which Windows will not let another program truncate, rename or delete. Close the dataset first: Windows
16 colors only“Use legacy console” is checked in the console’s properties: Windows
Temporary files left behindA file still mapped cannot be removed; datui tries again as it quits: Temporary files

Report a problem

Errors, warnings and backtraces go to datui.log in the cache directory: The log. File an issue at https://github.com/derekwisong/datui/issues with the log, the command and, for public data, the dataset.