uploadthing

# 📤 Uploadthing

Uploadthing file hosting — upload, list, and manage files via the Uploadthing API.

## Features

- **File upload** — upload files with metadata
- **File listing** — list uploaded files with filtering
- **File deletion** — remove files by key
- **URL generation** — get CDN URLs for files
- **Usage tracking** — storage and bandwidth usage
- **File metadata** — name, size, type, upload date
- **Bulk operations** — delete multiple files
- **App info** — application configuration

## Requirements

| Variable | Required | Description |
|----------|----------|-------------|
| `UPLOADTHING_SECRET` | ✅ | API key/token for Uploadthing |

## Quick Start

```bash
# List uploaded files
python3 {baseDir}/scripts/uploadthing.py files --limit 50
```

```bash
# Upload a file
python3 {baseDir}/scripts/uploadthing.py upload document.pdf
```

```bash
# Delete files
python3 {baseDir}/scripts/uploadthing.py delete --keys file_key1,file_key2
```

```bash
# Get usage stats
python3 {baseDir}/scripts/uploadthing.py usage
```



## Commands

### `files`
List uploaded files.
```bash
python3 {baseDir}/scripts/uploadthing.py files --limit 50
```

### `upload`
Upload a file.
```bash
python3 {baseDir}/scripts/uploadthing.py upload document.pdf
```

### `delete`
Delete files.
```bash
python3 {baseDir}/scripts/uploadthing.py delete --keys file_key1,file_key2
```

### `usage`
Get usage stats.
```bash
python3 {baseDir}/scripts/uploadthing.py usage
```

### `app-info`
Get app configuration.
```bash
python3 {baseDir}/scripts/uploadthing.py app-info
```

### `url`
Get file URL.
```bash
python3 {baseDir}/scripts/uploadthing.py url file_key
```

### `rename`
Rename a file.
```bash
python3 {baseDir}/scripts/uploadthing.py rename file_key "new-name.pdf"
```


## Output Format

All commands output JSON by default. Add `--human` for readable formatted output.

```bash
# JSON (default, for programmatic use)
python3 {baseDir}/scripts/uploadthing.py files --limit 5

# Human-readable
python3 {ba...