Giter VIP home page Giter VIP logo

plexdrive's Introduction

Plexdrive Build Status

Plexdrive allows you to mount your Google Drive account as read-only fuse filesystem, with direct delete option on the filesystem.

The project is comparable to projects like rclone, google-drive-ocamlfuse or node-gdrive-fuse, but optimized for media streaming e.g. with plex ;)

Please note that plexdrive doesn't currently support writes (adding new files or modifications), it only supports reading existing files and deletion.

I tried using rclone for a long time, but got API Quota errors every day and/or multiple times per day, so I decided to try node-gdrive-fuse. The problem here was that it missed some of my media files, so as a result I started implementing my own file system library.

If you like the project, feel free to make a small donation via PayPal. Otherwise support the project by implementing new functions / bugfixes yourself and create pull requests :)

Installation

  1. First you need to install fuse on your system
  2. Then you should download the newest release from the GitHub release page.
  3. Create your own client id and client secret (see https://rclone.org/drive/#making-your-own-client-id).
  4. Sample command line for plexdrive
./plexdrive mount -c /root/.plexdrive -o allow_other /mnt/plexdrive

Installation from Source

  1. Install FUSE an Go 1.11.4 or newer on your system (use latest stable Go version if possible)
  2. Clone the project: git clone https://github.com/plexdrive/plexdrive
  3. Run GO111MODULE=on go install
  4. Run $GOPATH/bin/plexdrive to use the instaled version (eg. ~/go/bin/plexdrive)

Crypted mount with rclone

You can use this tutorial for instruction how to mount an encrypted rclone mount.

Usage

Usage of ./plexdrive mount:
      --acknowledge-abuse           Allows files identified as abusive (malware, etc.) to be downloaded in Drive
      --cache-file string           Path of the cache file (default "cache.bolt" in configuration directory)
      --chunk-file string           Path of the chunk cache file (default "chunks.dat" in configuration directory)
      --chunk-disk-cache            Enable disk based chunk cache to --chunk-file, defaults to cache chunks in memory
      --chunk-check-threads int     The number of threads to use for checking chunk existence (default 6)
      --chunk-load-ahead int        The number of chunks that should be read ahead (default 11)
      --chunk-load-threads int      The number of threads to use for downloading chunks (default 6)
      --chunk-size string           The size of each chunk that is downloaded (units: B, K, M, G) (default "10M")
  -c, --config string               The path to the configuration directory (default "~/.plexdrive")
      --drive-id string             The ID of the shared drive to mount (including team drives)
  -o, --fuse-options string         Fuse mount options (e.g. --fuse-options allow_other,direct_io,...)
      --gid int                     Set the mounts GID (-1 = default permissions) (default -1)
      --max-chunks int              The maximum number of chunks to be stored in memory (default 24)
      --refresh-interval duration   The time to wait till checking for changes (default 1m0s)
      --root-node-id string         The ID of the root node to mount (use this for only mount a sub directory) (default "root")
      --uid int                     Set the mounts UID (-1 = default permissions) (default -1)
      --umask uint32                Override the default file permissions
  -v, --verbosity int               Set the log level (0 = error, 1 = warn, 2 = info, 3 = debug, 4 = trace)
      --version                     Displays program's version information

Signals

  • HUP: Trigger checking for changes
  • INT (Ctrl+C): Unmount and exit

Support

Slack support is available on our Slack channel. Feel free to ask configuration and setup questions here.

Supported FUSE mount options

  • allow_other
  • allow_dev
  • allow_non_empty_mount
  • allow_suid
  • max_readahead=1234
  • default_permissions
  • excl_create
  • fs_name=myname
  • local_volume
  • writeback_cache
  • volume_name=myname
  • read_only
  • direct_io

Root-Node-ID

You can use the option root-node-id to specify a folder id that should be mounted as the root folder. This option will not prevent plexdrive from getting the changes for your whole Google Drive structure. It will only "display" another folder as root instead of the real root folder. Don't expect any performance improvement or something else. This option is only for your personal folder structuring.

Team Drive

You can pass the ID of a Team Drive as drive-id to get access to a Team drive, here's how:

Contribute

If you want to support the project by implementing functions / fixing bugs yourself feel free to do so!

  1. Fork the repository
  2. Clone it to your golang workspace $GOPATH/src/github.com/username/plexdrive
  3. Implement your changes
  4. Test your changes (e.g. go build && ./plexdrive -v3 /tmp/drive)
  5. Format everything with gofmt ( (I recommend working with VSCode and VSCode-Go)
  6. Create a pull request

plexdrive's People

Contributors

dweidenfeld avatar felixbuenemann avatar zenjabba avatar erazor2k avatar erazor2kx avatar nothing4you avatar thinkscape avatar d3473r avatar bassrock avatar inrixia avatar marcocanc avatar raidancampbell avatar royxiang avatar dereulenspiegel avatar toomuchio avatar wrboyce avatar herver avatar longman391 avatar mtauberjr avatar rtkg12 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.