Google Drive Integration

Xplorer connects to Google Drive so you can browse, upload, download, and manage cloud files alongside your local filesystem.

Setup

1. Create OAuth Credentials

Go to the Google Cloud Console
Create a new project (or select an existing one)
Navigate to APIs & Services > Credentials
Click Create Credentials > OAuth client ID
Select Desktop application as the application type
Copy the Client ID and Client Secret

2. Configure in Xplorer

Open Settings > Google Drive
Paste your Client ID and Client Secret
Click Connect Account
Complete the OAuth consent flow in your browser
Xplorer stores the refresh token in your system keychain

Browsing Files

Once connected, your Google Drive accounts appear in the left sidebar under the Cloud section. Click an account to browse its contents.

The cloud file browser supports the same view modes as the local explorer (grid, list, details) and shows file metadata including size, last modified date, and sharing status.

File Operations

| Operation | Description | | ------------- | ----------------------------------------- | | Browse | Navigate folders, view file metadata | | Download | Download cloud files to a local directory | | Upload | Upload local files to Google Drive | | Create Folder | Create new folders in Drive | | Rename | Rename files and folders | | Move | Move files between Drive folders | | Delete | Move files to Drive trash |

Download to Local

Right-click a file in Drive and select Download to save it locally. You can choose the destination folder or use the default download location.

Upload from Local

Drag files from the local file grid into a Drive folder, or right-click in a Drive folder and select Upload Files.

Context Menu

When browsing a Google Drive folder, the context menu includes all standard Drive operations alongside Xplorer actions like preview and copy path.

Multi-Account Support

You can connect multiple Google Drive accounts simultaneously. Each account appears as a separate entry in the sidebar. Switch between accounts by clicking on them.

To add another account, go to Settings > Google Drive > Add Account.

Permissions

Xplorer requests the drive.file and drive.readonly scopes
OAuth consent is required on first connection
Credentials are stored securely in the system keychain (Windows Credential Manager, macOS Keychain, or Linux Secret Service)
You can revoke access at any time from Google Account settings or from Settings > Google Drive > Disconnect

Technical Details

Google Drive integration runs as an extension (examples/gdrive-extension) and exposes its functionality through the api.gdrive namespace. The extension communicates with the Google Drive API v3 for all file operations.