s3-browser

S3 Browser

A Flutter application for browsing AWS S3 buckets and S3-compatible storage services.

Features

• Connect to AWS S3 or S3-compatible services (like Exoscale)
• Browse bucket contents with folder navigation
• View and download files
• Photo viewer with navigation for images
• Native video player for iOS (mp4, mov, m4v, etc.)
• Save multiple connection credentials securely
• Support for iOS and Web platforms

Running the App

Web

flutter run -d chrome

iOS

1. First, install iOS dependencies:

   cd ios
   pod install
   cd ..
   

2. Open iOS Simulator or connect your iPhone

3. Run the app:

   flutter run -d ios
   

Or open in Xcode:

open ios/Runner.xcworkspace

iOS Configuration

The app is configured with:

• Minimum iOS version: 12.0
• Network permissions for S3 access (NSAppTransportSecurity)
• URL scheme support for opening download links
• All device orientations supported

Setup

1. Install Flutter dependencies:

   flutter pub get
   

2. For iOS, install CocoaPods dependencies:

   cd ios && pod install && cd ..
   

CORS Configuration

For web usage, your S3 bucket must have CORS configured. Example CORS rule:

{
  "CORSRules": [
    {
      "AllowedHeaders": ["*"],
      "AllowedMethods": ["GET", "POST", "PUT", "HEAD"],
      "AllowedOrigins": ["*"],
      "ExposeHeaders": ["ETag"],
      "MaxAgeSeconds": 3000
    }
  ]
}

Note: iOS does not require CORS configuration.

Project Structure

• lib/main.dart - App entry point
• lib/screens/credentials_screen.dart - AWS credentials input
• lib/screens/s3_browser_screen.dart - S3 bucket browser
• lib/screens/photo_viewer_screen.dart - Photo viewer with navigation
• lib/services/auth_s3_service.dart - S3 connection management
• lib/services/auth_storage_service.dart - Secure credential storage
• lib/services/s3_browser_service.dart - S3 browsing operations

This site is open source. Improve this page.