ddv
DDV is a TUI application to view Amazon DynamoDB in the terminal.. Install via x-cmd for instant access and enhanced productivity.
| Language | Rust |
| Homepage | https://lusingander.github.io/ddv/ |
- Using docker module to automatically pull the base image and, on first execution, reconstruct it as a fully runnable software image as needed.
- For subsequent runs, the command quickly launches containers based on the pre-built image, achieving near-instant startup.
- All operations are executed inside the container, completely isolated from the host system, requiring no local dependencies—secure, clean, and leaving no traces.
- When a rebuild is required due to software version or dependency changes, the Docker image build cache is fully leveraged to maximize reuse of downloaded dependencies and build artifacts, significantly reducing rebuild time.
x docker alpine ddvxd alp ddvx docker ubuntu ddvxd ubu ddvx docker kali ddvxd kal ddvx docker debian ddvxd deb ddvx docker fedora ddvxd fed ddvx install ddv
| /cargo | sh
|
| darwin/brew | sh
|
A Terminal-Based DynamoDB Viewer: Stop Switching Between Browser and CLI
If you find yourself constantly switching between the AWS Console and your terminal just to check DynamoDB data, DDV might be the tool you've been looking for.
DDV (DynamoDB Viewer) is a terminal user interface (TUI) application for viewing DynamoDB data. It lets you browse tables, view item details, search for specific content, and even perform updates and deletions — all without leaving your command line. For developers who prefer staying in the terminal, this workflow feels much more natural.
Key Features
📁 File Manager-Like Interface
DDV adopts a hierarchical browsing approach similar to file managers: the left panel shows your table list, and selecting a table displays its items on the right. It supports multiple view modes including key-value pairs and JSON, and you can click on items to expand and see full attribute details. The interface is clean and data is easy to scan.
⚡ Full Keyboard Control
As a TUI tool, DDV supports complete keyboard-driven operation:
| Shortcut | Function |
|---|---|
j/k/h/l or arrow keys | Select items / Scroll |
Enter | Open the selected item |
Backspace | Go back to previous view |
? | Show help for current view |
Ctrl-C | Exit the application |
Pressing ? displays detailed operation instructions for the current view.
🔧 Zero-Config Startup
DDV is fully compatible with AWS CLI configuration. If you already have AWS credentials set up (~/.aws/credentials) or environment variables configured (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, etc.), simply run ddv without any additional setup.
Command-line options are also supported for temporary overrides:
ddv --region us-west-2 --profile dev
ddv --endpoint-url http://localhost:8000 # Compatible with DynamoDB Local⚙️ Customizable Interface
You can adjust UI element dimensions through a configuration file. Set the DDV_CONFIG environment variable to point to your config file:
# Default region when not available from other sources
default_region = "us-east-1"
[ui.table_list]
list_width = 30 # Table list panel width
[ui.table]
max_attribute_width = 30 # Maximum width for attribute columns
max_expand_width = 35 # Maximum width for expanded view
max_expand_height = 6 # Maximum height for expanded viewInstallation Options
DDV can be installed through multiple methods:
| Method | Command |
|---|---|
| x-cmd | x install ddv |
| Cargo | cargo install --locked ddv |
| Homebrew (macOS) | brew install lusingander/tap/ddv |
| Binary Download | Download from GitHub Releases |
Important Notes
Early Development Stage
It's important to note that DDV is still in early active development, and some features and behaviors are not yet complete. Additionally, it is designed for local development environments or small datasets — not suitable for handling large production tables.
Goals and Non-Goals
DDV's core goal is simple: provide an easy way to view, search, update, and delete DynamoDB items in the terminal.
It does not aim to: efficiently handle large table queries or updates, or provide full coverage of all DynamoDB API operations.
Related Projects
DDV is developed by lusingander, who also created STU, a terminal-based S3 browser with a similar design philosophy. If you frequently manage AWS resources from the terminal, these two tools work well together for a consistent experience.
Summary
DDV offers a lightweight and fast option for everyday DynamoDB data inspection. No browser needed, no waiting for pages to load — just quick access to your data, making it particularly suitable for development and debugging workflows where you frequently need to check table contents. While features are still being added, its clean design and seamless AWS CLI compatibility already make it a practical tool worth trying.
Source:
https://lusingander.github.io/ddv/
Friendly Reminder:
This software is currently in its early development stage, and its features are not yet fully complete. It is recommended to review the development repository before use.
Help us make these docs great!
All X-CMD docs are generated from command help and multiple data sources. See something that's wrong or unclear? Feel free to let us know through any of these ways~