overGrive - Fedora Installation Instructions


  • Fedora 20 / openSUSE 13.1 / RHEL 7 / CentOS 7 or later installed. Most RPM based Linux systems will also work with minor modifications to the instructions. 
  • Tested on Fedora 29 and openSUSE Leap 15
  • Fedora might need some dependencies before installing overGrive. Open a terminal window and enter:
sudo dnf install libappindicator-gtk3 python-devel python-pip python-inotify python-gobject python-oauth2client
  • openSUSE need to install these dependencies (if available) before installing overGrive. Open a terminal window and enter:
sudo zypper install libappindicator3-1 libappindicator3-devel libappindicator1 typelib-1_0-AppIndicator3-0_1 python-httplib2 python-devel python-pip python-pyinotify python-gobject python2-appindicator python2-gobject-Gdk python-oauth2client
  • RHEL / CentOS users need to install the EPEL Repo before installing overGrive. Open a terminal window and enter:
sudo yum install epel-release python-pip python-devel
  • Then install the Google API. Open a terminal window and enter:
sudo pip install --upgrade google-api-python-client
sudo pip install --upgrade oauth2client


  • Download the latest version of overGrive RPM here
  • openSUSE users must use the yum --skip-broken option to ignore the missing dependencies warning.
  • To install the downloaded RPM file simply double click on the file or use a terminal window and enter:
sudo yum install overgrive-3.2.x.noarch.rpm


  • To un-install overGrive simply remove via the command line with : sudo yum remove overgrive


  • Symbolic links are not supported.
  • Forward slash ( / ) symbol in filename is not supported.
  • Google Drawings converted to SVG or other local file formats cannot be edited and converted back to Google Drawings format. This does not apply for the other Google Docs formats.
  • Google Forms and Google Maps not supported.


  • After install start overGrive search for overgrive or from your desktop Applications > Utilities menu.
  • Follow the setup instructions as show in the screenshots below.


1. Getting Started - Launch overGrive Setup

  • Start the application by searching for overgrive.


2. Connect account - Authorize your Google Drive account

  • Click Connect account


  • A browser window will open for you to sign in to your Google account.


  • Grant overGrive permission to access your Google Drive.
  • Click Accept to continue.


  • You will be given a authorization token code by Google. Copy this code. 


  • Paste your Google authorization code in the Account entry box provided.
  • Click Validate to validate the code.


3. First Sync

  • After completing the validation process, your account will be connected.
  • You will now be able to select which Google Drive folders to sync to your computer.
  • You can also select if you would like overGrive to convert your Google Docs to office file formats.
  • Once you have completed setting your preferences. Click Start Sync
  • NOTE : Files in your Shared with me folder will only be synced if they are dragged to My Drive on Google Drive online. Only files and folders in your My Drive wil be synced.
  • NOTE : Before syncing for the first time, we suggest you clear all Trash files from your Google Drive online.


  • Your files will be synchronized to your local Google Drive folder from your Google Drive online.
  • NOTE : It is important to allow overGrive to finish the first sync completely. If the first sync does not complete it will open the overGrive setup screen again on restart. You can simply select Start Sync again to complete the synchronization process.


4. Gnome Shell Application Indicator display on Top Bar (GNOME Desktop Users Only)

  • Gnome desktop users that prefer to have the application indicators displayed on the the top bar of the desktop can do so by installing the KStatusNotifierItem Gnome Shell Extension.
  • Simply visit the Gnome Extensions page at https://extensions.gnome.org/extension/615/appindicator-support 
  • CentOS / RHEL users might need to install the Gnome Shell Browser Plugin before being able to install the KStatusNotifierItem plugin.
sudo yum install gnome-shell-browser-plugin
  • Click on the toggle switch to enable the extension. You might need to log out en back in before the changes will take effect or use Alt+F2 and r as the command and press enter.
  • If your you cannot install the KStatusNotifierItem Shell Extension you need to install the Gnome Shell Integration plugin first. For more information see https://wiki.gnome.org/Projects/GnomeShellIntegrationForChrome