Table of Contents

• Installing
  • On Debian: DR
  • On Ubuntu: PPA
• Initializing
• Usage
  • Setting Up
  • Selecting Objects
  • Launching A Script
  • Logging
  • Help
• drive-menu Screenshots
  • Main Menu
  • Settings
  • Sync Types
  • Master Types
  • Sync Help (1)
  • Sync Help (2)
  • Sync Help (3)
  • Sync Help (4)
  • Sync Help (5)
  • User Confirmation
  • Progress Bar
  • Pulled
• Tracking And Filing Issues
• Reaching Out
• Disclaimer

Installing

On Debian: DR

The guidelines available in the Debian Repository describe how to:

• install my public PGP key to check the signature of the packages
• install the stable component of the Debian Repository (not operational for now)
• install the unstable component of the Debian Repository

Due to a recent deprecation of OAuth out-of-band (OOB) flow by Google, only the latest unstable built is operational for the time being. This means that only the unstable component of the Debian Repository can be installed on your system.

Once you're done, the last steps are:

sudo apt-get update
sudo apt-get install drive-google

On Ubuntu: PPA

The guidelines available in the PPA describe how to:

• install my public PGP key to check the signature of the packages
• install the stable component of the PPA (not operational for now)
• install the unstable component of the PPA

Due to a recent deprecation of OAuth out-of-band (OOB) flow by Google, only the latest unstable built is operational for the time being. This means that only the unstable component of the PPA can be installed on your system.

Once you're done, the last steps are:

sudo apt-get update
sudo apt-get install drive-google

Initializing

mkdir GD
cd GD
drive init
Visit this URL to get an authorization code
https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com&redirect_uri=http%3A%2F%2F127.0.0.1%xxxxxxx%2F&response_type=code&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fdrive&state=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
cp -v /etc/drive-google/.* .
cp: omitting directory '/etc/drive-google/.'
cp: omitting directory '/etc/drive-google/..'
'/etc/drive-google/.driveignore' -> './.driveignore'
'/etc/drive-google/.driverc' -> './.driverc'
'/etc/drive-google/.driveselect' -> './.driveselect'

Usage

Setting Up

The general settings described in <google_drive_folder>/.driverc control how the drive-<command> scripts behave for all commands using [global] section, or for a specific command under its [<command>] section which overrides the global settings only for that command. It's possible to group multiple settings for a bundle of commands under a [<command1>/<command2>/...] section.

More details are available with more /etc/drive-google/.driverc.

Selecting Objects

By default, each drive command operates over all objects (folders/files) which are located below the current working directory, as far as recursively possible (depth=-1).

It is possible to alter this behavior through the following settings:

Regarding new .driveselect:

• It is intended for users who are not familiar with regular expressions.
• It is possible to place .driveselect in any directory below your <google_drive_folder>. The drive-<command> script selects the one located in the directory where the call has been made, allowing you to limit the length of the filenames: their path is relative to the CLI location. This is useful when the tree is very deep and there is a need to include/exclude files which are located very far in the depth of the tree. Thus, the filenames are preceded with a minimal or non existent path.
• It is also possible to list objects per type of operation or for all operations.
• The selection logic is inverted as compared to .driveignore:
  • folders/files which are listed are included
  • folders/files which are preceded with a ! are excluded

More details are available for the 3 configuration/selection files:

• Configuring General Settings with more /etc/drive-google/.driverc
• Excluding And Including Objects with more /etc/drive-google/.driveignore
• Including And Excluding Objects with more /etc/drive-google/.driveselect

Launching A Script

Once the general settings are configured and affected objects are selected, major drive commands can be automatically launched in the folder of your choice with:

cd <google_drive_folder>
drive-menu
or
drive-<command>

• No option is necessary on the CLI.
• If you launch a script outside a Google Drive folder, it will locate the first one it finds and change the working directory to the latter.
• drive-<tabulation> lists all available scripts.
• drive-menu launches a basic GUI where all commands are accessible, including the abilities to change the current working directory and to configure the general settings & selected objects without exiting drive-menu.
• drive-sync offers syncing services not available with current drive. All details are available with:
  • drive-sync --help
  • drive-menu --> Help --> Sync...

The following commands are available within drive-menu:

Logging

• It is possible to log all commands related to a script or a set of scripts into ~/tmp/drive.log when drive-menu is launched from the CLI instead of the GUI desktop file.
• The scripts which are logged are multi-selected in Log selected scripts menu entry.

Help

Detailed Help is available for all commands with:

• drive-menu --> Help --> <Command>
• drive-<command> --help

drive-menu Screenshots

Main Menu

!Main_Menu

Settings

!alt drive-setup

• driverc sets main drive options.
• .driveignore function is to exclude/include objects using regular expressions.
• .driveselect function is to include/exclude objects using standard wildcards..

Sync Types

!alt drive-sync

Master Types

!alt drive-sync

Sync Help (1)

!alt drive-sync --help 1.jpg)

Sync Help (2)

!alt drive-sync --help 2.jpg)

Sync Help (3)

!alt drive-sync --help 3.jpg)

Sync Help (4)

!alt drive-sync --help 4.jpg)

Sync Help (5)

!alt drive-sync --help 5.jpg)

User Confirmation

!alt drive-share-link

Progress Bar

!alt progress-bar

Pulled

!alt pulled

Tracking And Filing Issues

This can be done at support@sdxlive.com.

Reaching Out

Doing anything interesting with drive-<command> scripts or ready to share your favorite tips and tricks? Feel free to reach out with ideas for features or requests support@sdxlive.com.

Disclaimer

This project is not supported nor maintained by Google.