Skip to main content

Uploader Setup

Configure ShareX, Chatterino, and custom clients to upload to olrite.lol.

Uploader Setup Account Setup API Documentation

ShareX Configuration

Configure ShareX for automatic uploads to olrite.lol:

  1. Open ShareX
  2. Go to Destinations → Custom uploader settings
  3. Click New to create a new uploader
  4. Configure the fields as shown below:
Name: olrite.lol
Request URL: https://olrite.lol/api/upload
Method: POST
Body: Form data (multipart/form-data)
Field name: file
URL: {json:url}

Quick Setup: Download a config file to skip manual setup. Choose based on your needs:

1. Basic (No Account)

Standard upload, 24-hour expiration, no authentication required

Download Basic Config

2. Authenticated (Account Required)

Uploads linked to your account, view history in dashboard, 300MB limit

Download Authenticated Config

Edit the file to add your API key

3. Preserved (No Account)

No 24-hour expiration, 50MB size limit

Download Preserved Config

4. Account + Preserved

Account tracking + permanent storage, 50MB limit

Download Account + Preserved Config

Edit the file to add your API key

Chatterino Configuration

Configure Chatterino to upload images directly to olrite.lol:

  1. Open Chatterino Settings
  2. Go to External Tools → Image Uploader
  3. Check Enable image uploader
  4. Configure the fields as shown below:
Request URL: https://olrite.lol/api/upload
Form field: file
Extra headers: (leave empty)
Image link: {url}
Deletion link: {delete}

Quick Setup: Copy the config to clipboard and import in Chatterino. Choose based on your needs:

1. Regular (No Account)

24-hour auto-deletion, 300MB limit, no authentication required

2. Authenticated (Account Required)

Uploads linked to your account, view history in dashboard, 300MB limit

After importing: Add your API key in Extra headers field:

X-API-Key: YOUR_API_KEY_HERE

3. Preserved (No Account)

No expiration, 50MB size limit

4. Account + Preserved

Account tracking + permanent storage, 50MB limit

After importing: Add your API key in Extra headers field:

X-API-Key: YOUR_API_KEY_HERE

Import Instructions: In Chatterino, go to Settings → External Tools → Image Uploader → Click "Import from Clipboard"

Account Setup (Optional)

Link your uploads to an account to track upload history, view statistics, and enable auto-preservation. All existing configurations work without an account - this is completely optional.

Getting Started with API Keys

  1. Create an account at olrite.lol
  2. Go to Account Dashboard → API Keys
  3. Click Generate New Key
  4. Optional: Check Auto-preserve uploads for permanent storage
  5. Copy your API key (shown only once!)
  6. Use the authenticated config for your uploader and add your API key

Upload History

View all your uploads in one place, organized by source

Statistics

Track upload counts, bandwidth usage, and storage metrics

Auto-Preserve

Enable per-key to automatically preserve all uploads (no 24h expiration)

API Documentation

Complete API reference for developers and custom uploaders:

Endpoint

POST https://olrite.lol/api/upload

Request Format

Method:POST
Content-Type:multipart/form-data
File Field:file
Max Size:300MB (regular) / 50MB (preserved)
Rate Limit:200 uploads/hour per IP

Authentication (Optional)

Link uploads to your account by including an API key. This enables upload history tracking, statistics, and optional auto-preservation.

Authentication Methods

X-API-Key:YOUR_32_CHARACTER_API_KEY
Authorization:Bearer YOUR_32_CHARACTER_API_KEY

Getting an API Key

  1. Create an account at olrite.lol
  2. Go to Account Dashboard → API Keys
  3. Click Generate New Key
  4. Copy the key (shown only once!)

API Key Settings

  • Name: Custom name for organization (e.g., "ShareX Desktop", "Chatterino")
  • Auto-preserve: When enabled, all uploads using this key are automatically preserved (no 24h expiration)
  • Upload tracking: All uploads are linked to your account and visible in the dashboard

Optional Headers

X-Olrite-Preserve:true

When set, files are preserved indefinitely (no 24-hour auto-deletion). Maximum file size is 50MB for preserved uploads. Can be used with or without authentication.

Supported File Types

Images:JPEG, PNG, GIF, WebP, AVIF
Videos:MP4, WebM, AVI, MOV

Response Format

Success Response (200 OK)

{
  "success": true,
  "url": "https://olrite.lol/abc123def456",
  "id": "abc123def456",
  "expires_at": "2025-01-15T12:00:00Z",
  "file_info": {
    "size": 1048576,
    "type": "image/png",
    "original_format": "image/png",
    "width": 1920,
    "height": 1080,
    "optimal_formats": ["webp", "avif"]
  }
}

Error Response (4xx/5xx)

{
  "success": false,
  "error": "File too large (max 100MB)",
  "code": 413
}

cURL Examples

Basic Upload (No Account)

curl -X POST -F "[email protected]" https://olrite.lol/api/upload

With Authentication (X-API-Key)

curl -X POST -H "X-API-Key: YOUR_API_KEY_HERE" -F "[email protected]" https://olrite.lol/api/upload

With Authentication (Bearer Token)

curl -X POST -H "Authorization: Bearer YOUR_API_KEY_HERE" -F "[email protected]" https://olrite.lol/api/upload

With Preservation (No Auto-Deletion)

curl -X POST -H "X-Olrite-Preserve: true" -F "[email protected]" https://olrite.lol/api/upload

With Authentication + Preservation

curl -X POST -H "X-API-Key: YOUR_API_KEY_HERE" -H "X-Olrite-Preserve: true" -F "[email protected]" https://olrite.lol/api/upload