Brows3

Object and Transfer Management

• Prefix and Breadcrumb Navigation

  Browse delimiter-based S3 folders, open direct s3:// paths, and move quickly through known prefixes.

• Bulk and Recursive Operations

  Upload, download, copy, move, and delete files or folders with queue progress and cancellation controls.

• Large Multipart Uploads

  Use adaptive multipart transfers from 100 MiB upward with bounded memory, retryable parts, progress reporting, and cleanup after cancellation or failure.

• Content-Type Control

  Infer MIME types from object names and edit a validated free-form Content-Type without discarding supported metadata, tags, headers, security fields, or ACL grants.

• Object Permissions

  Read and update object ACL grants and apply canned ACLs recursively where the provider and bucket support ACLs.

• Presigned URL Sharing

  Generate temporary object links with a configurable expiry from the bucket view.

Previews and Editing

• Built-in Monaco Editor

  Edit text, JSON, YAML, and code objects directly in S3 while retaining the existing Content-Type.

• Configurable Bounded Text Previews

  Choose a persisted text preview limit from 1 to 100 MB (2 MB by default). The Rust backend streams and enforces the exact bound.

• Streamed Media Previews

  Preview images, audio, video, and PDFs through presigned URLs without loading the full object into the text-preview memory allowance.

Profiles and Credentials

• Manual, Shared, SSO, and Custom Endpoint Profiles

  Connect with access keys, system AWS profiles, IAM Identity Center sessions, or S3-compatible endpoint credentials.

• AWS IAM Identity Center Sign-In

  Recognize SSO profiles, resolve cached SDK credentials, and launch an exact-profile AWS CLI v2 sign-in when a session expires.

• Native Credential Storage

  Use macOS Keychain, Windows Credential Manager, or Linux Secret Service. Portable mode and keychain failures use the documented local secrets.json fallback.

• Profile-Isolated Transfer Queues

  Every queued transfer retains the profile that created it, so switching accounts cannot change the credentials used by an existing job.

• S3-Compatible Endpoint Routing

  Custom endpoints and shared profiles with endpoint_url use path-style addressing and compatibility checksum behavior.

Performance with Explicit Limits

• Prefix-Aware Pagination

  Normal folder listings use S3 prefixes, delimiters, and continuation tokens rather than a full-bucket background index.

• Bounded Deep Search

  Scan up to 100,000 objects with at most 100 LIST requests and return at most 10,000 matches per search.

• Complete-Prefix Sorting

  Order non-default views before pagination, capped at 100 LIST requests or 100,000 entries.

• Targeted Bounded Caching

  Cache bucket discovery for 30 minutes per profile and reuse bounded sorted views during the session, with invalidation after writes and refreshes.

• Virtualized Object Table

  Render only the visible rows so large loaded listings remain responsive.

Reliability and Updates

• Readable Backend Errors

  Command failures cross the Tauri boundary as human-readable messages instead of JavaScript object placeholders.

• Safe Recursive Downloads

  Reject traversal, absolute, rooted, drive-prefixed, and null-containing object-key paths before writing locally.

• Signed Update Metadata

  Check for updater-signed desktop releases and review available versions from Settings or startup.

• System Monitor

  Inspect request success and failure counts plus application logs when diagnosing provider behavior.

Prerequisites (All Platforms)

• Node.js v22+ and pnpm

  The release repository currently declares pnpm 11.2.2

• Rust 1.97.1

  Matches the toolchain used by the release validation workflow

Windows Setup

winget install Rustlang.Rustup

rustup toolchain install 1.97.1
rustup default 1.97.1
cargo --version
rustc --version

git clone https://github.com/rgcsekaraa/brows3.git
cd brows3
pnpm install --frozen-lockfile
pnpm tauri dev

macOS Setup

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env
rustup toolchain install 1.97.1
rustup default 1.97.1

xcode-select --install

git clone https://github.com/rgcsekaraa/brows3.git
cd brows3
pnpm install --frozen-lockfile
pnpm tauri dev

Linux Setup

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env
rustup toolchain install 1.97.1
rustup default 1.97.1

sudo apt update
sudo apt install -y libgtk-3-dev libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf

git clone https://github.com/rgcsekaraa/brows3.git
cd brows3
pnpm install --frozen-lockfile
pnpm tauri dev

Release Build (All Platforms)

pnpm tauri build

We welcome contributions from the community! Whether you are a Rustacean, a React developer, or a technical writer, your help is appreciated.

Maintainers

• rgcsekaraa
• thamothara7

How to Contribute

• 1. Check the Issues

  Look for "good first issue" labels on GitHub

• 2. Standard Workflow

  Fork → Branch → Commit → Pull Request

• 3. Code Quality

  Ensure Rust code is formatted with cargo fmt and TS code with pnpm lint