astrada/google-drive-ocamlfuse
Google Drive Ocamlfuse
google-drive-ocamlfuse is a FUSE-based filesystem that mounts a Google Drive account as a local directory, enabling standard file operations on cloud files. It bridges POSIX filesystem calls to the Google Drive API, allowing users to read, write, and manage files through their operating system's native file manager or command line.
The project distinguishes itself through support for multiple simultaneous Google Drive accounts, each mounted as an independent local directory with separate authentication and cache state. It handles Google Docs, Sheets, and Slides by exporting them as read-only files in configurable formats, and provides access to shared team drives alongside personal storage. Authentication supports OAuth2 device flow for headless servers, standard OAuth2 authorization, and service account credentials for automated domain-wide access.
The filesystem includes bidirectional synchronization, duplicate file name resolution with configurable strategies, and exposure of the cloud trash as a local directory for file recovery. Performance features include a SQLite metadata cache to reduce API calls and read-ahead streaming for smoother sequential file access. Mount behavior can be configured with options such as read-only mode, permission masks, and cache intervals, while Unix-style ownership and permission bits are applied to integrate with local access control.
Documentation covers installation, authentication setup, mount configuration, and operation on headless servers without a graphical environment.
Features
- Google Drive FUSE Mounts - Mounts a Google Drive account as a local directory using FUSE, enabling standard file operations on cloud files.
- Google Drive Mounts - Mounts a Google Drive account as a local directory using FUSE, enabling standard file operations on cloud files.
- Cloud Document Exporters - Exports Google Docs, Sheets, and Slides to configurable formats and presents them as read-only local files.
- FUSE Filesystem Mounts - Mounts a Google Drive account as a local directory using FUSE, enabling standard file operations on cloud files.
- Google Drive Format Converters - Exports Google Docs, Sheets, and Slides to configurable formats and presents them as read-only local files.
- Cloud Account Mounts - Mounts multiple Google Drive accounts simultaneously as independent local directories with separate authentication.
- Multi-Account Cloud Mounts - Mounts multiple Google Drive accounts simultaneously as separate local mount points with independent authentication.
- Bidirectional File Synchronization - Propagates local file changes to the remote storage and fetches remote updates so both sides stay consistent.
- Remote File Read-Write Operations - Opens, edits, saves, and deletes files on the remote drive through standard filesystem operations.
- FUSE-Based Filesystem Mounts - Mounts a cloud storage account as a local directory using FUSE for standard file operations.
- Device Authentication Flows - Authenticates headless devices to Google Drive using the OAuth2 device authorization grant flow.
- OAuth2 Client Authorization - Provides OAuth2 client authorization flow to authenticate and mount a Google Drive account as a local filesystem.
- Cloud Drive Duplicate Name Resolvers - Resolves filename collisions on the remote drive with configurable strategies for unique local filenames.
- File and Folder Sharing - Makes files and folders shared by other users visible and usable within the mounted filesystem.
- Team Drive Mounts - Mounts Google Team Drives as local directories alongside the personal drive for shared file access.
- Service Account Automations - Mounts Google Drive using a service account credential for automated or domain-wide access without interactive login.
- Team Drive Filesystem Accessors - Lists and interacts with shared team drives in addition to the user's personal cloud storage.
- Read-Only Document Export Proxies - Exports Google Docs, Sheets, and Slides as read-only files in configurable formats through the mounted filesystem.
- Team Drive Mounts - Mounts Google Team Drives as local directories alongside the personal drive for shared file access.
- Cloud Drive Mount Option Configurators - Adjusts filesystem mount options such as read-only mode, permission masks, and metadata cache intervals.
- Metadata Caches - Stores file tree metadata and directory listings in a local SQLite database to reduce repeated API calls.
- Cloud Drive Duplicate Name Handlers - Detects and resolves files with identical names on the remote drive during filesystem operations.
- Headless Authentication Mounts - Authenticates and mounts the filesystem on headless servers or remote machines without a graphical environment.
- FUSE Multi-Account Mount Isolators - Runs separate FUSE instances with independent authentication and cache state for each mounted cloud account.
- Service Account Authenticators - Accesses cloud storage files within a domain by using a service account credential without interactive login for automated tasks.
- Service Account Domain Impersonators - Uses G Suite service account credentials to act as a domain user for accessing all Drive files without interactive login.
- Service Account Management - Mounts Google Drive using a service account credential for automated or domain-wide access without interactive login.
- Cloud Storage Management - FUSE filesystem implementation for cloud storage.
