Skip to content

purpledmango/S3_explorer_electronjs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🗂️ S3 Explorer – Cross-Platform Desktop App

A powerful, intuitive desktop application for managing S3-compatible object storage. Built with React + Electron for seamless file management across Mac, Linux, and Windows.


✨ Features

📦 S3 Object Management

  • 📂 Browse buckets and folders
  • ⬆️ Upload files (drag & drop support)
  • ⬇️ Download files to local machine
  • ✏️ Rename objects and folders
  • 🔄 Move files between folders
  • 🗑️ Delete objects safely
  • 🔗 Generate presigned URLs
  • 🔍 Search across all objects
  • 📊 View file sizes and modification dates

��️ Cross-Platform Support

  • macOS (Apple Silicon & Intel)
  • Linux (AppImage & Debian)
  • Windows (Installer & Portable)

🔐 Security Features

  • Context isolation in Electron
  • No node integration in renderer
  • Secure credential storage
  • IPC-based file operations

📥 Downloads

✅ Latest Release: v1.0.0

All executables are pre-built and ready to use. No installation of dependencies required.

macOS

Option 1: DMG Installer (Recommended)

  • File: S3 Explorer-1.0.0-arm64.dmg
  • Size: ~120 MB
  • Compatible: Apple Silicon (M1, M2, M3, etc.)
  • Installation: Double-click → Drag to Applications folder
  • Download DMG

Option 2: ZIP Archive

  • File: S3 Explorer-1.0.0-arm64-mac.zip
  • Size: ~120 MB
  • Compatible: Apple Silicon (M1, M2, M3, etc.)
  • Installation: Extract → Move to Applications folder
  • Download ZIP

Linux

Option 1: AppImage (Universal)

  • File: S3 Explorer-1.0.0-arm64.AppImage
  • Size: ~136 MB
  • Compatible: Most Linux distributions (ARM64)
  • Installation:
    chmod +x S3\ Explorer-1.0.0-arm64.AppImage
    ./S3\ Explorer-1.0.0-arm64.AppImage
  • Download AppImage

Option 2: Debian Package

  • File: electron-s3-explorer_1.0.0_arm64.deb
  • Size: ~83 MB
  • Compatible: Debian, Ubuntu, Linux Mint (ARM64)
  • Installation:
    sudo apt install ./electron-s3-explorer_1.0.0_arm64.deb
    # Launch: S3 Explorer
  • Download DEB

Windows

Option 1: Installer Executable (Recommended)

  • File: S3 Explorer Setup 1.0.0.exe
  • Size: ~99 MB
  • Compatible: Windows 7 and later (ARM64)
  • Installation: Double-click → Follow setup wizard → Launch app
  • Uninstall: Control Panel → Programs → Uninstall
  • Download EXE Installer

Option 2: Portable Executable

  • File: S3 Explorer 1.0.0.exe
  • Size: ~99 MB
  • Compatible: Windows 7 and later (ARM64)
  • Installation: Download & run directly (no installation needed)
  • Note: No Start Menu shortcuts created
  • Download Portable EXE

🚀 Getting Started

Step 1: Download & Install

Choose the appropriate file for your operating system from the Downloads section above.

Step 2: Connect to S3

  1. Launch S3 Explorer
  2. Fill in connection details:
    • Endpoint: S3 API URL (e.g., https://s3.amazonaws.com)
    • Bucket: Your bucket name
    • Access Key: S3 access key ID
    • Secret Key: S3 secret access key
    • Region: AWS region (default: us-east-1)
  3. Click "Connect" button

Step 3: Manage Your Files

Action How To
Upload Drag & drop files onto the drop zone, or right-click folder → Upload
Download Right-click file → Download → Choose save location
Create Folder Click "+ Folder" button → Enter folder name
Rename Right-click file/folder → Rename → Enter new name
Move Right-click file → Move → Enter destination path
Delete Right-click → Delete → Confirm
Copy URL Right-click file → Copy Presigned URL → Auto-copied!
Search Type in search box to filter files

🔗 Supported S3 Services

AWS S3
MinIO (self-hosted)
DigitalOcean Spaces
Wasabi Cloud Storage
Backblaze B2
IBM Cloud Object Storage
Oracle Cloud Object Storage
Any S3-compatible API


💾 Configuration & Storage

Credential Storage

Credentials are stored securely in your system's application data folder:

  • macOS: ~/Library/Application Support/electron-s3-explorer/s3config.json
  • Linux: ~/.config/electron-s3-explorer/s3config.json
  • Windows: %APPDATA%\electron-s3-explorer\s3config.json

Reset Credentials

To clear stored credentials:

  1. Disconnect from S3 Explorer
  2. Delete the config file manually, OR
  3. Reinstall the application

🛠️ Development Setup

Prerequisites

  • Node.js 16+ and npm

Installation

# Clone repository
git clone https://github.com/yourusername/S3_explorer_electronjs
cd S3_explorer_electronjs

# Install dependencies
npm install

Run in Development

npm start

This starts:

  • React dev server on http://localhost:3000
  • Electron app window with hot reload

Build for Production

# Build for all platforms
npm run build

# Build specific platform
npm run build -- --mac      # macOS only
npm run build -- --linux    # Linux only
npm run build -- --win      # Windows only

Built files appear in dist/ folder.


❓ Troubleshooting

"Connection Failed" Error

  • ✅ Verify endpoint URL is correct (e.g., https://s3.amazonaws.com)
  • ✅ Check access key and secret key are valid
  • ✅ Confirm bucket name exists
  • ✅ Check internet connectivity
  • ✅ Try using a different region

Files Not Showing

  • ✅ Click Refresh button
  • ✅ Check folder path prefix
  • ✅ Clear search filter
  • ✅ Verify bucket has objects

App Won't Start on Linux

  • AppImage: Make executable first
    chmod +x S3\ Explorer-1.0.0-arm64.AppImage
    ./S3\ Explorer-1.0.0-arm64.AppImage
  • DEB Package: Install properly
    sudo apt install ./electron-s3-explorer_1.0.0_arm64.deb

Presigned URL Issues

  • ✅ Ensure object exists in bucket
  • ✅ Check S3 credentials have GetObject permission
  • ✅ Verify bucket is not private

Upload Fails

  • ✅ Check file is not too large
  • ✅ Verify S3 credentials have PutObject permission
  • ✅ Ensure bucket has write access

📋 System Requirements

macOS

  • OS: macOS 10.12 or later
  • CPU: Apple Silicon or Intel (x64)
  • RAM: 4 GB minimum, 8 GB recommended

Linux

  • OS: Ubuntu 18.04+, Debian 10+, Fedora, etc.
  • CPU: ARM64 compatible
  • RAM: 4 GB minimum, 8 GB recommended
  • Dependencies: glibc, libxss1

Windows

  • OS: Windows 7 SP1 or later
  • CPU: ARM64 compatible
  • RAM: 4 GB minimum, 8 GB recommended
  • Runtime: .NET Framework (usually pre-installed)

📄 License

MIT License – Feel free to use, modify, and distribute!


🤝 Contributing

Found a bug? Have a feature request?

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📞 Support

Issues

Visit: GitHub Issues

Questions?

  • Check troubleshooting section above
  • Review README for configuration options
  • Search existing GitHub issues

🎯 Roadmap

Planned Features

  • Batch operations (multi-select upload/download)
  • Sync folders locally
  • Advanced filtering and sorting
  • Cloud storage comparison
  • Direct file preview (images, videos, documents)
  • Bandwidth throttling
  • Resume interrupted uploads
  • S3 bucket policies UI

📊 Project Stats

  • Built with: React 18, Electron 29, AWS SDK v3
  • Cross-platform: macOS, Linux, Windows
  • Code size: ~15 KB (minified)
  • Bundle size: ~120 MB per platform
  • Dependencies: Minimal, well-maintained

Made with ❤️ by S3 enthusiasts

⬆ Back to Top

About

S3-compatible Object Storage Explorer — Electron desktop app with cross-platform builds (Mac, Linux, Windows)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors