Uses old Rust 2015
|0.1.28||Apr 12, 2020|
|0.1.25||Feb 14, 2019|
|0.1.20||Dec 22, 2018|
|0.1.18||Oct 9, 2018|
|0.1.16||Jul 27, 2018|
#411 in Filesystem
158 downloads per month
GCSF is a virtual filesystem that allows users to mount their Google Drive account locally and interact with it as a regular disk partition. You can find out more in this paper.
Update (April 2019): I am currently still using and maintaining this project but I have very little time to dedicate to it. As such, it might take a while before I get around to fixing known bugs / implementing feature requests / responding to open issues. Thank you for understanding and for expressing sustained interest in this project!
GCSF requires the stable branch of the Rust programming language, which can be installed following the instructions on rustup.rs. If you already have Rust installed, make sure that it is updated to the latest version (≥1.26):
$ rustup update stable
On Mac OSX, GCSF requires osxfuse and pkg-config:
$ brew update; brew install pkg-config; brew tap homebrew/cask; brew cask install osxfuse
On Ubuntu, GCSF requires libfuse-dev, libssl-dev and pkg-config:
sudo apt-get install -y libfuse-dev libssl-dev pkg-config
An AUR package is maintained by axionl: gcsf-git.
Other linux distros
Make sure you have
pkg-config and the
fuse library installed. These are usually found in the package repositories of major distributions.
Rust can be installed via the
lang/rust port. You will need to install
sysutils/fusefs-libs for the
cairo install command to succeed.
Unfortunately, Windows is not supported at the time being. See issue #19.
After all requirements are met, GCSF can be installed using
$ cargo install gcsf
This will generate the
gcsf binary in
$HOME/.cargo/bin. Make sure that this directory is in your
Alternatively, you can download a release binary for your platform.
GCSF will attempt to create a configuration file in
$XDG_CONFIG_HOME/gcsf/gcsf.toml, which is usually defined as
$HOME/.config/gcsf/gcsf.toml. Credentials are stored in the same directory.
The first step is to log in to Drive and authorize the application. A name must be provided for the session:
$ gcsf login some_session_name Please direct your browser to https://accounts.google.com/o/oauth2/[...] and follow the instructions displayed there. Successfully logged in. Saved credentials to "$HOME/.config/gcsf/some_session_name"
You can also list all existing sessions:
$ gcsf list Sessions: - personal - some_session_name - work
And then mount one (or more) of them:
$ gcsf mount /mnt/gcsf -s some_session_name INFO gcsf > Creating and populating file system... INFO gcsf > File system created. INFO gcsf > Mounting to /mnt/gcsf INFO gcsf > Mounted to /mnt/gcsf
You can now find the contents of your Drive account in
GCSF stands for "Google Conduce Sistem de Fișiere" which translated from Romanian is "Google Drive Filesystem". However GDFS already exists so it remains GCSF.
Could not mount to
$mountpoint: Operation not permitted (os error 1)
This error occurs when
user_allow_other is not set in
/etc/fuse.conf or the file has improper permissions. Fix by running (as root):
# echo 'user_allow_other' >> /etc/fuse.conf # chmod 644 /etc/fuse.conf # sudo chown root:root /etc/fuse.conf
Contributions are welcome. Documentation available on docs.rs/gcsf. You can also help by reporting or fixing issues.