Drive - File Management

Your cloud storage workspace

Overview

Drive is your personal cloud storage within General Bots Suite. Upload, organize, and share files with a familiar interface. Built with HTMX for smooth interactions and SeaweedFS for reliable object storage.

Features

Upload Files

Drag and Drop:

1. Drag files from your computer
2. Drop anywhere in the file area
3. Upload progress shows automatically

Click to Upload:

1. Click + New button
2. Select Upload Files or Upload Folder
3. Choose files from file picker

File Operations

View Modes

Navigation

• Breadcrumb: Click any folder in the path to jump back
• Sidebar: Quick access to My Drive, Starred, Recent, Trash
• Search: Find files by name or content

Labels & Organization

File Sync (Desktop Only)

The desktop app provides bidirectional file synchronization between your local machine and cloud Drive using rclone.

Requirements:

• General Bots desktop app (Tauri)
• rclone installed on your system

Setup:

1. Install rclone: https://rclone.org/install/
2. Open Drive in the desktop app
3. Click Settings → Sync
4. Configure your sync folder (default: ~/GeneralBots)
5. Click Start Sync

Sync Controls: Located in the Drive sidebar under “Sync Status”

Sync Modes:

Note: Sync features are only available in the desktop app. Web users see an “unavailable” status as sync requires local filesystem access.

Keyboard Shortcuts

Managing Files via Chat

Finding Files

Sharing Files

Creating Folders

API Endpoints

Query Parameters

Response Format

{
    "path": "/Projects/2024",
    "files": [
        {
            "name": "Report.pdf",
            "type": "file",
            "size": 245000,
            "modified": "2024-03-15T10:30:00Z",
            "starred": false,
            "shared": true
        },
        {
            "name": "Documents",
            "type": "folder",
            "modified": "2024-03-14T09:00:00Z",
            "starred": true
        }
    ],
    "storage": {
        "used": 4500000000,
        "total": 10737418240
    }
}

File Type Icons

Storage Backend

Drive uses SeaweedFS for object storage:

• Scalable: Grows with your needs
• Redundant: Data replicated across nodes
• Fast: Optimized for small and large files
• S3 Compatible: Works with standard S3 tools

Configure storage in config.csv:

key,value
drive-server,http://localhost:9000
drive-bucket,bot-files
drive-quota-gb,10

Troubleshooting

Upload Fails

1. Check file size (default limit: 100MB)
2. Verify storage quota isn’t exceeded
3. Check network connection
4. Try smaller files or compress first

Files Not Displaying

1. Refresh the page
2. Check folder path is correct
3. Verify file permissions
4. Clear browser cache

Sharing Not Working

1. Verify recipient email address
2. Check sharing permissions
3. Ensure file isn’t in Trash

See Also

• Suite Manual - Complete user guide
• Admin vs User Views - Permission levels
• Chat App - Upload files via chat
• Player App - View files in Player
• Storage API - API reference