R2-Explorer

A Google Drive Interface for your Cloudflare R2 Buckets!

This project is deployed/self-hosted in your own Cloudflare Account as a Worker, and no credential/token is required to start using it.

You can see an live example, in read-only mode, in your browser at https://r2-explorer.massadas.com/

This project is still in development, and there are definitely going to be some weird issues sometimes, but when you find something please open an new issue for it to get solved.

Features

  • Very quick bucket/folder navigation
  • pdf, image, txt, markdown, csv, etc in-browser preview
  • Drag-and-Drop upload
  • Multiple files and folder uploads
  • Create folders
  • Rename files
  • Download files
  • Delete files
  • Right click in file for extra options

FAQ

Q. Is there any Authentication for r2-explorer?

A. No. If you want authenticated access, you must setup Cloudflare Access in your account. Access is free up to 50 users.


Q. Can i upload files bigger than 100MB?

A. You can upload multiple files/folders at once, but each file must be under 100MB learn more here.

Getting Started

Run this command to get an example project setup

npx r2-explorer my-r2-explorer

Change into the newly created directory and install the packages

cd my-r2-explorer
npm install

Update the wrangler.toml with your R2 Buckets (tip: you can setup as many Buckets as your want)

- wrangler.toml -
...
[[r2_buckets]]
binding = 'my-bucket-name'
bucket_name = 'my-bucket-name'
preview_bucket_name = 'my-bucket-name'

If you want to be able to upload/modify your buckets, you must update the readonly flag in src/index.ts file.

After that just run publish and the project will be up and running for you and everyone you invite to use the Buckets

wrangler publish

TODO

  • Integration with cloudflare access
  • allow bucket names with spaces
  • Search files
  • Rename folders
  • Delete folders
  • Image thumbnail's using Cloudflare workers
  • Tooltip when hovering a file with absolute time in "x days time ago" format
  • Automatically load more files, when the bottom is reached (current limit is 1000 files)
  • Download files bigger than 2gb with presigned url's
  • set folder and file navigation in the url to allow direct share of a specific folder/file

Known issues

  • When uploading files, each file cannot exceed 100MB of size learn more here
  • Rename files with special characters is not possible with current sdk issue here

Images

Home Page Home

Image Previewer Home

Pdf Previewer Home

New Folder Home

Uploading Files Home

Compiles and hot-reloads for development

npm run serve

Compiles and minifies for production

npm run build

Lints and fixes files

npm run lint
S
Description
A Google Drive Interface for your Cloudflare R2 Buckets!
Readme MIT
11 MiB
Languages
Vue 61.1%
JavaScript 19.9%
TypeScript 16.3%
HTML 1.6%
SCSS 1.1%