10 unstable releases (3 breaking)

new 0.4.1 Mar 22, 2024
0.4.0 Mar 17, 2024
0.3.0 Mar 9, 2024
0.2.5 Dec 19, 2023
0.1.0 Mar 4, 2023

#160 in Command line utilities

Download history 7/week @ 2023-12-18 10/week @ 2024-02-19 7/week @ 2024-02-26 196/week @ 2024-03-04 132/week @ 2024-03-11 177/week @ 2024-03-18

512 downloads per month

MIT license

2MB
4K SLoC

Rust 3.5K SLoC // 0.0% comments Go 733 SLoC

STU

Crate Status

S3 Terminal UI

About

STU is the TUI application for AWS S3 written in Rust using ratatui.

Installation

Cargo

$ cargo install stu

Homebrew (macOS)

$ brew install lusingander/tap/stu

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

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

Object list

  • Show list of objects in a hierarchy

Object detail

  • Show object details
  • Download object
  • Preview object (text file only)
  • Copy resource name to clipboard

License

MIT

Dependencies

~30–45MB
~670K SLoC