# R2Drive

> Modern desktop file manager for Cloudflare R2 storage

[![npm](https://img.shields.io/npm/v/r2drive)](https://npmjs.org/package/r2drive)
[![Downloads](https://img.shields.io/npm/dt/r2drive)](https://npmjs.org/package/r2drive)

## Quick Start

```bash
# Install globally
npm install -g r2drive

# Launch desktop app
r2drive

# Or run as web app
r2drive --web
```

## Features

- 📂 Complete R2 bucket management
- 📤 Drag & drop uploads (files + folders)
- 🗂️ Folder operations (create, rename, delete)
- 🔄 Real-time progress tracking
- 🌓 Dark/Light themes
- 🔒 Secure credential management
- 🌍 Multi-language support

## Platforms

| Platform | Installation |
|----------|-------------|
| 🍎 macOS | Downloads .dmg |
| 🪟 Windows | Downloads .msi |
| 🐧 Linux | Downloads .AppImage |
| 🌐 Web | Runs in browser |

## Usage

```bash
r2drive           # Desktop app (recommended)
r2drive --web     # Web app at localhost:3000
r2drive --dev     # Development mode
```

## Configuration

Requires Cloudflare R2 credentials:
- Account ID
- Access Key ID  
- Secret Access Key
- Bucket Name

Get these from [Cloudflare Dashboard](https://dash.cloudflare.com) → R2 → API Tokens

## Links

- [📚 Full Documentation](https://github.com/falgom4/R2Drive)
- [🐛 Issues](https://github.com/falgom4/R2Drive/issues)
- [⭐ GitHub](https://github.com/falgom4/R2Drive)

**Requirements**: Node.js 18+, Cloudflare R2 account

---

MIT License | Made with ❤️ by [falgom4](https://github.com/falgom4)