Documentação

GDrive Desktop

GDrive Desktop é um cliente não oficial do Google Drive para Linux, escrito em Rust, com o mesmo comportamento, aparência e funcionalidades do Google Drive para computador (versão Windows). O app não tem servidores próprios: ele roda inteiro na sua máquina e conversa com a API pública do Google usando um Client ID que você mesmo cria no seu projeto do Google Cloud. Os seus arquivos nunca passam por um servidor do projeto.

Comece por aqui

O que o app faz

O Drive aparece como uma pasta comum no seu gerenciador de arquivos, mas os arquivos ficam na nuvem até você abrir: só os trechos lidos são baixados. Em cima disso, o app entrega: - Sincronização automática de envio e recebimento, com fila que sobrevive a reinícios e queda de rede. - “Disponível off-line” em arquivos e pastas, e “Somente on-line” para liberar o espaço na hora. - Menu do botão direito nos gerenciadores de arquivos, com compartilhar, versões, atalhos e lixeira. - Até 4 contas Google ao mesmo tempo, cada uma com a sua pasta. - Drives compartilhados, visíveis na pasta e numa visão própria da janela principal. - Modo Espelho: o Meu Drive inteiro numa pasta comum do computador, disponível sem internet. - Pastas do computador sincronizadas e backup de pendrives quando conectados. - Proteção: detecta arquivos que parecem cifrados por um vírus e pausa os envios antes de estragar tudo. - Recuperação: dados locais danificados são refeitos a partir do Drive, com as edições pendentes guardadas. - Diagnóstico e feedback sem tokens, senhas ou e-mails nos relatórios. A lista completa está em Recursos do app.

Como funciona

Camada	O que faz
Interface (Tauri)	Bandeja, login, preferências e a janela principal com a atividade de sincronização.
Gerenciadores de arquivos	Plugin do Dolphin e extensão GTK com o menu do botão direito e os emblemas de estado.
Motor (serviço em Rust)	Pasta virtual via FUSE, banco SQLite com os metadados de todo o Drive, cache em blocos, fila de envios e resolução de conflitos.
Google Drive API	HTTPS + OAuth 2.0, usando apenas a API pública.

A interface e os gerenciadores conversam com o motor por D-Bus; o motor fala com o Google por HTTPS.

Conceitos principais

Termo	Significado
Stream	Modo padrão. O Drive aparece como pasta virtual: os arquivos estão na nuvem e são baixados sob demanda.
Espelho	O Meu Drive inteiro vira uma pasta comum no computador, com os arquivos todos disponíveis offline. O Exchange troca entre os dois.
Disponível off-line	Marca um arquivo ou pasta para ficar no disco. “Somente on-line” desfaz e libera o espaço.
Drives compartilhados	Áreas compartilhadas com a sua conta. Continuam em Stream mesmo no modo Espelho, como no app oficial.
Computadores	A pasta do Drive onde ficam as cópias das pastas do computador sincronizadas e o backup de dispositivos.
Lost and Found	Guarda as versões conflitantes e as edições que ainda não subiram. Nada é sobrescrito em silêncio.

Onde o app guarda as coisas

Caminho	Conteúdo
~/Google Drive/Meu Drive	O Drive montado em modo Stream.
~/Google Drive/Drives compartilhados	Os Drives compartilhados da conta.
~/Google Drive (<e-mail>)	A pasta de cada conta adicional (a partir da segunda).
~/.local/share/gdrive-desktop-linux	Banco SQLite, cache em blocos e dados das contas.
~/.config/gdrive-desktop-linux	Preferências (preferences.toml) do seu usuário.
~/.local/state/gdrive-desktop-linux	Estado e relatórios de falha.
/etc/gdrive-desktop-linux	Políticas do sistema (policies.toml) e padrões (defaults.toml).

Licença e créditos

O app é distribuído sob a GNU GPL v3.0. O repositório é mantido por [Túlio Zanella (@tzanella)](https://github.com/tzanella); o repositório original do projeto é [junior9283/gdrive-desktop-linux](https://github.com/junior9283/gdrive-desktop-linux), de onde vêm os créditos pela concepção e pela implementação original.

Documentation

GDrive Desktop

GDrive Desktop is an unofficial Google Drive client for Linux, written in Rust, with the same behavior, look and features as Google Drive for desktop (the Windows version). The app has no servers of its own: it runs entirely on your machine and talks to the public Google API using a Client ID that you create yourself in your own Google Cloud project. Your files never pass through a project server.

Start here

What the app does

The Drive shows up as a regular folder in your file manager, but the files stay in the cloud until you open them: only the chunks you read are downloaded. On top of that, the app delivers: - Automatic sync of uploads and downloads, with a queue that survives restarts and network drops. - “Available offline” for files and folders, and “Online only” to free the space right away. - Right-click menu in file managers, with sharing, versions, shortcuts and trash. - Up to 4 Google accounts at once, each with its own folder. - Shared drives, visible in the folder and in a dedicated view of the main window. - Mirror mode: your whole My Drive as a regular folder on the computer, available offline. - Computer folders synced and backup of USB drives when they are plugged in. - Protection: it spots files that look virus-encrypted and pauses uploads before things get bad. - Recovery: damaged local data is rebuilt from the Drive, with pending edits kept safe. - Diagnostics and feedback with no tokens, passwords or e-mails in the reports. The full list is in App features.

How it works

Layer	What it does
Interface (Tauri)	Tray, login, preferences and the main window with the sync activity.
File managers	Dolphin plugin and GTK extension with the right-click menu and the status badges.
Engine (Rust service)	Virtual folder via FUSE, SQLite database with the metadata of the whole Drive, block cache, upload queue and conflict resolution.
Google Drive API	HTTPS + OAuth 2.0, using only the public API.

The interface and the file managers talk to the engine over D-Bus; the engine talks to Google over HTTPS.

Key concepts

Term	Meaning
Stream	Default mode. The Drive shows up as a virtual folder: files live in the cloud and are downloaded on demand.
Mirror	Your whole My Drive becomes a regular folder on the computer, with every file available offline. The Exchange switches between the two.
Available offline	Marks a file or folder to stay on disk. “Online only” undoes it and frees the space.
Shared drives	Areas shared with your account. They stay in Stream even in Mirror mode, just like the official app.
Computers	The Drive folder that holds copies of synced computer folders and device backups.
Lost and Found	Holds conflicting versions and edits that have not uploaded yet. Nothing is ever silently overwritten.

Where the app keeps things

Path	Content
~/Google Drive/My Drive	The Drive mounted in Stream mode.
~/Google Drive/Shared drives	The shared drives of the account.
~/Google Drive (<e-mail>)	The folder of each additional account (from the second one on).
~/.local/share/gdrive-desktop-linux	SQLite database, block cache and account data.
~/.config/gdrive-desktop-linux	Your user preferences (preferences.toml).
~/.local/state/gdrive-desktop-linux	State and crash reports.
/etc/gdrive-desktop-linux	System policies (policies.toml) and defaults (defaults.toml).

License and credits

The app is distributed under the GNU GPL v3.0. The repository is maintained by [Túlio Zanella (@tzanella)](https://github.com/tzanella); the original project repository is [junior9283/gdrive-desktop-linux](https://github.com/junior9283/gdrive-desktop-linux), which holds the credits for the original conception and implementation.