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.
