BucketView

BucketView is a cross-platform desktop client for browsing and managing S3-compatible object storage.

The application is built with Electron, Vue 3, TypeScript, Ant Design Vue, and the AWS SDK for JavaScript.

Features

• Manage multiple S3-compatible storage connections
• Browse buckets and objects with list and thumbnail views
• Upload, download, copy, move, rename, and delete objects
• Preview images, video, audio, PDF, Office documents, 3D models, and text files
• Edit and save text objects online
• Mount buckets or prefixes as local drives with rclone
• Transfer queue, progress tracking, and operation audit log
• Light and dark themes
• Independent themed preview windows

Supported storage services

BucketView targets the standard S3 API and can work with AWS S3, MinIO, and other S3-compatible providers. Provider-specific behavior may vary, especially around path-style access, regions, and permissions.

Requirements

• Node.js 20 or newer
• npm 10 or newer
• Windows 10/11 for the complete drive-mount workflow

macOS and Linux builds are supported by the Electron application, but some platform-specific features may require additional validation or bundled helper binaries.

Development

npm ci
npm run dev

Build

Build the renderer, main process, and preload scripts without packaging:

npm run build:app

Create a packaged application for the current platform:

npm run build

Platform-specific packaging commands are also available:

npm run build:win
npm run build:mac
npm run build:linux

Releases and automatic updates

Pushing a semantic-version tag that matches package.json triggers the GitHub Actions release workflow:

npm version patch
git push origin main --follow-tags

The workflow builds x64 ZIP packages for Windows, macOS Intel, and Linux, generates latest-<platform>.yml update manifests, and publishes all assets to a GitHub Release.

Packaged Windows and macOS applications check the latest public GitHub Release at startup. When a newer version is available, BucketView asks before downloading and asks again before installation. Downloads are verified against the SHA-512 checksum and file size in the release manifest.

The default update feed is:

https://github.com/kinboyw/bucketview/releases/latest/download

Set BUCKETVIEW_UPDATE_FEED_URL to override it for a fork or private mirror. Linux packages are published, but automatic in-place installation is not currently enabled on Linux.

Current community builds are unsigned. Windows SmartScreen or macOS Gatekeeper may display a warning until platform signing is configured.

Security

Do not commit access keys, secret keys, exported connection profiles, application databases, logs, or generated mount configuration files. See SECURITY.md for vulnerability reporting guidance.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

License

BucketView is licensed under the MIT License. Bundled third-party tools and dependencies remain subject to their respective licenses.