Google Drive Commands

Integrate with Google Drive for cloud media storage and streaming

Overview

Google Drive commands handle OAuth authentication, folder browsing, file indexing, and cloud streaming for media stored in Google Drive.

Authentication

connect_google_drive

Alias for gdrive_start_auth + gdrive_complete_auth. Start the OAuth flow.

Rust Signature

#[tauri::command]
async fn gdrive_start_auth() -> Result<String, String>

OAuth Flow:

1. gdrive_start_auth returns a Google OAuth URL and opens it in the default browser
2. User authenticates with Google
3. Backend server receives the code and redirects to localhost:42069 with tokens
4. gdrive_complete_auth waits for this callback, stores tokens, and returns account info

authUrl · string

Google OAuth consent screen URL

---

gdrive_complete_auth

Complete OAuth authentication (waits for callback from browser).

Rust Signature

#[tauri::command]
async fn gdrive_complete_auth(
    state: State<'_, AppState>,
) -> Result<gdrive::DriveAccountInfo, String>

DriveAccountInfo · object

Show Response fields

email · string

Google account email

display_name · string | null

User’s display name

photo_url · string | null

Profile photo URL

storage_used · number | null

Storage used in bytes

storage_limit · number | null

Storage quota in bytes

---

disconnect_google_drive

Revoke OAuth tokens and disconnect.

Rust Signature

#[tauri::command]
async fn gdrive_disconnect(
    state: State<'_, AppState>,
) -> Result<ApiResponse, String>

---

get_drive_account_info

Get current Google Drive account information.

Rust Signature

#[tauri::command]
async fn gdrive_get_account_info(
    state: State<'_, AppState>,
) -> Result<gdrive::DriveAccountInfo, String>

---

gdrive_is_connected

Check if authenticated to Google Drive.

Rust Signature

#[tauri::command]
async fn gdrive_is_connected(
    state: State<'_, AppState>,
) -> Result<bool, String>

---

Folder Management

scan_cloud_library

Alias for gdrive_scan_folder. Scan a Google Drive folder and index all video files.

Rust Signature

#[tauri::command]
async fn gdrive_scan_folder(
    state: State<'_, AppState>,
    window: Window,
    folder_id: String,
    folder_name: String,
) -> Result<CloudIndexResult, String>

folder_id · string · required

Google Drive folder ID

folder_name · string · required

Folder name (for display/logging)

CloudIndexResult · object

Show Response fields

success · boolean

Whether scan succeeded

indexed_count · number

Number of new files indexed

skipped_count · number

Number of files already in library

movies_count · number

New movies added

tv_count · number

New TV episodes added

message · string

Human-readable summary

Auto-Detection: The scanner parses filenames to detect:

• Movies: Movie Title (2023).mkv
• TV Shows: Show Name S01E05.mkv

It fetches metadata from TMDB and downloads posters automatically.

---

get_cloud_stream_url

Alias for gdrive_get_stream_url. Get a temporary streaming URL for a Google Drive file.

Rust Signature

#[tauri::command]
async fn gdrive_get_stream_url(
    state: State<'_, AppState>,
    file_id: String,
) -> Result<(String, String), String>

file_id · string · required

Google Drive file ID

tuple · [string, string]

Returns [stream_url, access_token]

Show Return values

stream_url · string

Direct download URL (valid for ~1 hour)

access_token · string

OAuth access token to include in Authorization: Bearer <token> header

Streaming URLs expire after approximately 1 hour. Access tokens must be included in all video chunk requests.

---

delete_cloud_file

Alias for Google Drive file deletion (handled by delete_media_files command).

See Library Management - delete_media_files

---

gdrive_list_folders

List folders in Google Drive.

Rust Signature

#[tauri::command]
async fn gdrive_list_folders(
    state: State<'_, AppState>,
    parent_id: Option<String>,
) -> Result<Vec<gdrive::DriveItem>, String>

parent_id · string | null

Parent folder ID, or null for root

---

gdrive_list_video_files

List all video files in a folder.

Rust Signature

#[tauri::command]
async fn gdrive_list_video_files(
    state: State<'_, AppState>,
    folder_id: String,
    recursive: bool,
) -> Result<Vec<gdrive::DriveItem>, String>

folder_id · string · required

Folder ID to scan

recursive · boolean · required

Whether to scan subfolders

Only returns files with video MIME types: video/mp4, video/x-matroska, video/webm, etc.

---

Change Detection

check_cloud_changes

Poll Google Drive for new or changed video files (uses Changes API).

Rust Signature

#[tauri::command]
async fn check_cloud_changes(
    state: State<'_, AppState>,
    window: Window,
) -> Result<CloudIndexResult, String>

How it works:

1. Stores a “changes token” after each poll
2. On next poll, fetches only files that changed since the last token
3. Automatically indexes new video files
4. Sends desktop notifications for new content
5. Much more efficient than re-scanning entire folders

StreamVault polls for changes every 5 seconds automatically in the background. You rarely need to call this manually.

---

Events

cloud-scan-complete

Emitted when a folder scan finishes.

TypeScript

import { listen } from '@tauri-apps/api/event';

await listen<{
  folder: string;
  indexed: number;
  skipped: number;
  movies: number;
  tv: number;
}>('cloud-scan-complete', (event) => {
  console.log(`Scan complete: ${event.payload.folder}`);
});

---

cloud-indexing-started

Emitted when change detection finds new files.

TypeScript

await listen<{ count: number }>('cloud-indexing-started', (event) => {
  console.log(`Indexing ${event.payload.count} new files...`);
});