stu
stu copied to clipboard
TUI (Terminal/Text UI) application for AWS S3 🪣
STU
S3 Terminal UI
About
STU is the TUI application for AWS S3 written in Rust using ratatui.
![](https://github.com/lusingander/stu/raw/master/img/demo.gif)
Installation
Cargo
$ cargo install stu
Homebrew (macOS)
$ brew install lusingander/tap/stu
AUR (Arch Linux)
$ paru -S stu
Binary
You can download binaries from releases
Usage
STU - S3 Terminal UI
Usage: stu [OPTIONS]
Options:
-r, --region <REGION> AWS region
-e, --endpoint-url <URL> AWS endpoint url
-p, --profile <NAME> AWS profile name
-b, --bucket <NAME> Target bucket name
-h, --help Print help
-V, --version Print version
You can also use each environment variable in the same way as when using the AWS CLI.
Detailed operations on each view can be displayed by pressing ?
key.
Or refer to the ***-help.png
screenshots in the ./img directory.
Config
Config is loaded from $STU_ROOT_DIR/config.toml
.
- If
STU_ROOT_DIR
environment variable is not set,~/.stu
is used by default. - If the file does not exist, it will be created automatically at startup.
The values that can be set are as follows:
-
download_dir
: string - Directory to save when downloading objects (default:$STU_ROOT_DIR/download
)
Features / Screenshots
Bucket list
- Show list of buckets
![](https://github.com/lusingander/stu/raw/master/img/bucket-list.png)
Object list
- Show list of objects in a hierarchy
![](https://github.com/lusingander/stu/raw/master/img/object-list-simple.png)
![](https://github.com/lusingander/stu/raw/master/img/object-list-hierarchy.png)
![](https://github.com/lusingander/stu/raw/master/img/object-list-many.png)
Object detail
- Show object details
- Download object
- Preview object (text file only)
- Copy resource name to clipboard
![](https://github.com/lusingander/stu/raw/master/img/object-detail.png)
![](https://github.com/lusingander/stu/raw/master/img/object-version.png)
![](https://github.com/lusingander/stu/raw/master/img/object-download.png)
![](https://github.com/lusingander/stu/raw/master/img/object-preview.png)
![](https://github.com/lusingander/stu/raw/master/img/object-details-copy.png)
License
MIT