https://github.com/g4brym/r2-explorer

A Google Drive Interface for your Cloudflare R2 Buckets!
https://github.com/g4brym/r2-explorer

cloudflare cloudflare-r2 cloudflare-workers cloudflare-workers-kv google-drive google-drive-clone r2

Last synced: about 20 hours ago
JSON representation

A Google Drive Interface for your Cloudflare R2 Buckets!

• Host: GitHub
• URL: https://github.com/g4brym/r2-explorer
• Owner: G4brym
• License: mit
• Created: 2022-05-21T09:36:53.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-01-20T22:16:59.000Z (12 days ago)
• Last Synced: 2025-02-01T05:08:03.130Z (about 21 hours ago)
• Topics: cloudflare, cloudflare-r2, cloudflare-workers, cloudflare-workers-kv, google-drive, google-drive-clone, r2
• Language: Vue
• Homepage: https://r2explorer.dev
• Size: 10.6 MB
• Stars: 353
• Watchers: 8
• Forks: 73
• Open Issues: 21
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  

    

  





    A Google Drive Interface for your Cloudflare R2 Buckets!





    

      

    

    

      

    

    

      

    



# R2-Explorer

R2-Explorer brings a familiar Google Drive-like interface to your Cloudflare R2 storage buckets, making file management simple and intuitive.

## Quick Links

- 📚 **Documentation**: [r2explorer.dev](https://r2explorer.dev)

- 🎮 **Live Demo**: [demo.r2explorer.dev](https://demo.r2explorer.dev)

- 💻 **Source Code**: [github.com/G4brym/R2-Explorer](https://github.com/G4brym/R2-Explorer)

Available in multiple languages:

[English](https://r2explorer.dev) |

[Español](https://r2explorer-dev.translate.goog/?_x_tr_sl=en&_x_tr_tl=es) |

[Português](https://r2explorer-dev.translate.goog/?_x_tr_sl=en&_x_tr_tl=pt-PT) |

[Français](https://r2explorer-dev.translate.goog/?_x_tr_sl=en&_x_tr_tl=fr)

## Overview

R2-Explorer transforms your Cloudflare R2 storage experience with a modern, user-friendly interface. It provides powerful file management capabilities while maintaining enterprise-grade security through Cloudflare's infrastructure.

## Key Features

- **🔒 Security**

  - Basic Authentication support

  - Cloudflare Access integration

  - Self-hosted on your Cloudflare account

- **📁 File Management**

  - Drag-and-drop file upload

  - Folder creation and organization

  - Multi-part upload for large files

  - Right-click context menu for advanced options

  - HTTP/Custom metadata editing

- **👀 File Handling**

  - In-browser file preview

    - PDF documents

    - Images

    - Text files

    - Markdown

    - CSV

    - Logpush files

  - In-browser file editing

  - Folder upload support

  

- **📧 Email Integration**

  - Receive and process emails via Cloudflare Email Routing

  - View email attachments directly in the interface

## Installation Methods

Choose the method that best suits your needs:

1. **GitHub Action (Recommended)**

   ```bash

   # Follow the guide at:

   https://r2explorer.dev/getting-started/creating-a-new-project/#1st-method-github-action-recommended

   ```

2. **Cloudflare CLI**

   ```bash

   # Follow the guide at:

   https://r2explorer.dev/getting-started/creating-a-new-project/#2nd-method-create-cloudflare

   ```

3. **Template Repository**

   ```bash

   # Use our template at:

   https://github.com/G4brym/R2-Explorer/tree/main/template

   ```

For detailed instructions on maintaining and updating your installation, visit our [update guide](https://r2explorer.dev/getting-started/updating-your-project/).

## Roadmap

We're actively working on these exciting features:

- **File Management**

  - Support for bucket names with spaces

  - File search functionality

  - Folder renaming capability

  - Image thumbnails generation

  

- **AI Integration**

  - Object detection using workers-ai

  

- **User Experience**

  - Enhanced timestamp tooltips

  - Email response capabilities

  - Advanced file type-specific editing

  

## Known Issues

- When using basic authentication, email inline images and assets don't load properly

- Additional issues can be found and reported on our [GitHub Issues](https://github.com/G4brym/R2-Explorer/issues) page

## Contributing

We welcome contributions! Whether it's bug fixes, new features, or documentation improvements, please feel free to:

1. Fork the repository

2. Create a feature branch

3. Submit a Pull Request

## Support

- 📚 Documentation: [r2explorer.dev](https://r2explorer.dev)

- 🐛 Issue Tracker: [GitHub Issues](https://github.com/G4brym/R2-Explorer/issues)

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.