tuxdrive

Table of Contents

1. Introduction
2. Project Details
3. Installation
4. Usage
5. License

Introduction

tuxdrive is a console based DIY google drive client.

Project Details

• Home Page: https://prahladyeri.github.io/tuxdrive/
• Lead Developer: Prahlad Yeri
• Issue tracker: https://github.com/prahladyeri/tuxdrive/issues

Installation

pip install tuxdrive

Since this is a DIY (Do-it-yourself) app, you'll have to register your own app by going to the Google API Console, enable Drive API, create credentials and copy the client_id.json to your working folder. Only then the program will be able to work. For more information on how to do this, you may refer to this article.

(Note: As of version 2.0.0, pip is the only supported installation method, the old DEB/RPM method is depreciated)

Usage

tuxdrive has a command line interface to the google drive interface similar to traditional unix tools like ftp and sftp (though not as extensive and comprehensive yet!).

Once you start tuxdrive program, it will give you a tux_drive> prompt from which you can run the above commands. When you run tuxdrive the first time, it will open up the browser window and ask for permissions to access your google drive on your behalf. After that, you can start running commands. You can list your drive files using ls or dir command for example:

Similarly, you can run push some_local_file.txt to upload it to your drive, or rcd my_drive_folder to change the remote drive. Here is the entire command list:

help (or ?): Shows this help facility. dir (or ls): Lists all files and folders on drive. !dir (or !ls): Lists all files and folders in current directory. get (or pull) : Pulls the named file/folder from drive to current working directory. put (or push) : Pushes the named file/folder from current working directory to drive. rm : Delete the named file/folder on remote path. pwd: Print working directory (remote/drive). cd: Change working directory (remote/drive). lpwd: Print working directory (local). lcd: Change working directory (local). mkdir: Create a directory on remote path. list permissions : Lists the permissions on specific file/directory. clear permissions : Clears permissions on specific file/directory. share : Shares the specific file/directory in remote drive publicly. share : Shares the specific file/directory in remote drive to specified email. exit: Exits this program. rdcache: Show remote directory mapping of id and folder paths. rfcache: Show remote files mapping of id and folder paths.

Documentation

tuxdrive is under active development, so there is no extensive documentation. I'll keep updating the github wiki as and when I get time.

License

tuxdrive is free and open source software. It is MIT licensed.