+0
Daily
5,986
stars
366
forks
139
watchers
36
prs
899
issues
100
releases
README
FUSE filesystem over Google Drive
=================================
google-drive-ocamlfuse is a FUSE filesystem for Google Drive,
written in OCaml. It lets you mount your Google Drive on Linux.
Features (see what's new)
Full read/write access to ordinary files and folders
Read-only access to Google Docs, Sheets, and Slides (exported to
configurable formats)
Multiple account support
Duplicate file handling
Access to trash (.Trash directory)
Unix permissions and ownership
Symbolic links
Read-ahead buffers when streaming
Accessing content shared with you (requires configuration)
Team Drive Support
Service Account Support
OAuth2 for Devices Support
Since version 0.8.0, the process is kept in foreground (breaking change)
Since version 0.8.0, the new configuration file format is TOML (breaking change)
Resources
Homepage
Wiki: includes
installation instructions, and more details about configuration, and
authorization
Authorization
Please be sure to have a look at the
authorization
page, to understand how the authorization process works, and to discover all
the available options.
Getting started
---------------
Installation
I've uploaded .deb packages for Ubuntu to my
PPA. In order to to
install it, use the commands below:
sudo add-apt-repository ppa:alessandro-strada/ppa
sudo apt-get update
sudo apt-get install google-drive-ocamlfuse
New beta versions are available on this
PPA.
If you want to test them, use the commands below:
sudo add-apt-repository ppa:alessandro-strada/google-drive-ocamlfuse-beta
sudo apt-get update
sudo apt-get install google-drive-ocamlfuse
For other installation options, please refer to the wiki.
How to build
------------
Requirements
[OCaml][] = 4.08.0
[dune][] = 2.0.0
[fuse3][] = 3.10.0
[gapi-ocaml][] = 0.4.9
[sqlite3-ocaml][] = 1.6.1
[tiny_httpd] = 0.10
[otoml] = 1.0.1
[ounit] = 2.0.0
[OCaml]: https://ocaml.org/
[dune]: https://dune.build/
[fuse3]: https://github.com/astrada/ocamlfuse
[gapi-ocaml]: https://github.com/astrada/gapi-ocaml
[sqlite3-ocaml]: https://mmottl.github.io/sqlite3-ocaml/
[tiny_httpd]: https://github.com/c-cube/tiny_httpd/
[otoml]: https://github.com/dmbaturin/otoml
[ounit]: https://github.com/gildor478/ounit
Configuration and installation
To build the executable, run
dune build @install
To install it, run (as root, if your user doesn't have enough privileges)
dune install
To uninstall anything that was previously installed, execute
dune uninstall
Usage
-----
First, you must set up OAuth
2.0:
1. Activate the
Google Drive API.
1. Create an OAuth client ID.
1. Choose Desktop as Application type.
1. Set the Name to anything you like.
This way you will get a Client ID and Client secret that you can use to
access your Drive. To authorize google-drive-ocamlfuse, pass the client ID
and the client secret on the command line, e.g.:
google-drive-ocamlfuse -id xxxxxxxxxx.apps.googleusercontent.com -secret XXXTop issues
#247Good tool to use with plex?35 comments · 2017-01-27#607cannot access 'directory': Input/output error30 comments · 2020-02-03#840"Transport endpoint is not connected" when not using "-debug" mode !?17 comments · 2023-11-29#631Error: Sqlite3 error: ERROR16 comments · 2020-05-13#684Discrepancy in the size of google drive storage account mounted on local file system and file space usage of (exported) google drive folders13 comments · 2020-12-28#9Feature request: RPM package or portable tarball12 comments · 2013-09-04#887Google drive grants only 7 days access11 comments · 2024-09-09#248Caching file chunks11 comments · 2017-01-29
Latest release
0.9.0 v0.9.0 2026-06-17This version moves the filesystem to FUSE 3. Source builds now require fuse3 and libfuse3 development headers, with libfuse 3.10.0 or newer as the supported baseline. The old libfuse2 binding is no longer supported.