Cloud Storage Browser
Back to Home

Cloud Storage Browser - User Guide

Table of Contents

  1. Introduction
  2. Login Options
  3. Dashboard
  4. Bucket Explorer
  5. Settings

Introduction

Cloud Storage Browser is a desktop application that allows you to browse, manage, and interact with different cloud storage providers from a single interface. The application supports AWS S3, Google Cloud Storage, and Azure Blob Storage, making it easy to work with multiple cloud providers.

Image: Cloud Storage Browser Main Interface

Login Options

The Cloud Storage Browser offers different login methods for each supported cloud provider. Free plan users can access AWS S3, while Pro plan users can additionally access Google Cloud Storage and Azure Blob Storage.

Image: Login Selection Screen

AWS S3

AWS S3 login offers three authentication methods:

Image: AWS S3 Login Options

1. Access Key & Secret Key

Required data:

  • Access Key ID: Your AWS access key identifier
  • Secret Access Key: Your AWS secret access key
  • Region: AWS region your bucket resides in (e.g., us-east-1)
  • Bucket Name: (Optional) Name of the bucket to connect to
  • Path: (Optional) Specific path within the bucket

Learn more about AWS Access Keys

Image: AWS Access Key Login Form

2. AWS Credentials File

Required data:

  • Profile Name: Name of the profile in your AWS credentials file
  • Credentials File Path: Path to your AWS credentials file
  • Region: AWS region your bucket resides in
  • Bucket Name: (Optional) Name of the bucket to connect to
  • Path: (Optional) Specific path within the bucket

Learn more about AWS Credentials Files

Image: AWS Credentials File Login Form

3. S3-Compatible Service

Required data:

  • Access Key ID: Your access key identifier
  • Secret Access Key: Your secret access key
  • Endpoint URL: The custom endpoint URL of your S3-compatible service
  • Bucket Name: (Optional) Name of the bucket to connect to
  • Path: (Optional) Specific path within the bucket

Learn more about S3-Compatible Services

Image: S3-Compatible Service Login Form

Google Cloud Storage (GCP)

Pro Feature

Google Cloud Storage offers two authentication methods:

Image: GCP Login Options

1. Google Account

Required data:

  • Project ID: (Optional) Your Google Cloud project ID
  • Bucket Name: (Optional) Name of the bucket to connect to

This method requires gcloud CLI to be installed on your system.

Learn more about gcloud CLI installation

Image: Google Account Login Form

2. Service Account JSON

Required data:

  • Service Account Key: Upload a service account JSON key file or paste its contents
  • Bucket Name: (Optional) Name of the bucket to connect to

Learn more about GCP Service Account Keys

Image: Service Account JSON Login Form

Azure Blob Storage

Pro Feature

Azure Blob Storage offers three authentication methods:

Image: Azure Login Options

1. Azure Account

Required data:

  • Storage Account Name: (Optional) Name of your Azure Storage account
  • Container Name: (Optional) Name of the container to connect to

This method requires Azure CLI to be installed on your system.

Learn more about Azure CLI installation

Image: Azure Account Login Form

2. Connection String

Required data:

  • Connection String: Azure Storage account connection string
  • Container Name: (Optional) Name of the container to connect to

Learn more about Azure Connection Strings

Image: Azure Connection String Login Form

3. SAS URL

Required data:

  • SAS URL: Shared Access Signature URL for your Azure Storage
  • Container Name: (Optional) Name of the container to connect to

Learn more about Azure SAS URLs

Image: Azure SAS URL Login Form

Dashboard

The Dashboard is displayed after successful login and provides an overview of your storage buckets.

Image: Dashboard Overview

Bucket Overview

The Dashboard presents a list of available buckets with the following information:

  • Name: Name of the bucket
  • Object Count: Number of objects stored in the bucket
  • Creation Date: When the bucket was created
Image: Bucket List View

Sorting and Filtering

Buckets can be sorted by:

  • Name: Alphabetical order
  • Date: Creation date (newest first)
  • Count: Object count (highest first)
Image: Dashboard Sorting Options

Bucket Selection

To work with a specific bucket, click the "Select" button next to the bucket name. This will navigate you to the Bucket Explorer for that bucket.

Image: Bucket Selection

Bucket Explorer

The Bucket Explorer allows you to navigate and manage files and folders within a selected bucket.

Image: Bucket Explorer Overview

File Operations

  • Download: Download a file to your local system
  • Delete: Remove a file from the bucket
  • View Details: View file metadata including size, type, and last modified date
  • Generate Signed URL: Create a temporary URL to access the file (duration configurable)
Image: File Operations

Folder Operations

  • Create Folder: Create a new folder in the current location
  • Delete Folder: Remove a folder and its contents
  • Upload: Upload files or entire folders to the current location
Image: Folder Operations
Image: Create Folder Dialog
Image: Upload Files Dialog

Searching

Use the search bar to filter files and folders by name within the current location.

Image: Search Functionality

Sorting and Filtering

Files and folders can be sorted by:

  • Name: Alphabetical order
  • Size: File size (largest first)
  • Type: File type (grouped by extension)
  • Last Modified: Modification date (newest first)
Image: Bucket Explorer Sorting

Settings

The Settings page allows you to configure the application and manage your account details.

Image: Settings Overview

Plan & License

  • View your current plan (Free or Pro)
  • Upgrade to Pro plan for additional features
  • If you have a Pro license, view your license details including:
    • License key (partially redacted)
    • Email associated with the license
    • Order information
    • Activation and renewal dates
    • Price and subscription recurrence
Image: Plan & License Settings
Image: Pro Activation Dialog

Appearance

  • Theme: Choose between Light and Dark modes (Dark mode is a Pro feature)
Image: Appearance Settings
Image: Dark Mode Preview

Application Logs

  • View Logs: View application logs for troubleshooting
  • Open Log Folder: Open the folder containing log files
  • Copy Log Path: Copy the path to the log file to the clipboard
Image: Application Logs Settings

Report a Bug

  • Report on GitHub: Opens the GitHub issues page to report bugs or suggest improvements
Image: Report a Bug Section

Storage Credentials

  • Current Connection: View details of your active connection (sensitive information is redacted)
  • Sign Out: Sign out and clear the current connection
Image: Storage Credentials Settings