Setup and Getting Started
* Gnome Desktop Users Application Indicator display on top bar (optional)
Debian Gnome and other Gnome desktop users (excluding Ubuntu) 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
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 Top Bar Shell Extension you need to install the Gnome Shell Integration plugin first. For more information see http://www.omgubuntu.co.uk/2017/01/install-gnome-shell-extensions-firefox-chrome
Another way to display the icons on the top bar is to install Gnome Tweaks and then select Extensions > Top Icons > ON. This works well on CentOS 7.
On RHEL 8-9 / CentOS 8-9 use Gnome Tweaks and then select Extensions > KStatusNotifierItem/AppIndicator Support > ON. If the extension is not available, install with the following and enable with Gnome Tweaks:
sudo dnf install gnome-shell-extension-appindicator
Launch overGrive Setup
Start the application from the dash by searching for overgrive.
2. Connect account - Authorize your Google Drive account
Click Connect account.
NOTE: Sync options will be available after connecting your account.
A browser window will open for you to sign in to your Google account.
NOTE: Mint users there seems to be a problem on Mint regarding what default browser is set. If a browser window does not open when clicking Connect account, try the following command from a terminal window and select Firefox or Chrome as you default browser:
sudo update-alternatives --config x-www-browser
Allow overGrive permission to access your Google Drive.
Click Allow to continue.
3. Preferences
Account:
Once connected your account email and online storage usage will be displayed.
To use another account click Disconnect account and connect the other account.
Folder location:
Select which local folder will be used to sync or backup to Google Drive. By default a Google Drive folder will be created in your Home Folder. Click Change to select a different local folder.
Sync options:
Select which Google Drive folders to sync to your computer. You have to connect an account before this option becomes available.
Removing Items:
Choose how files and folders are removed from Google Drive.
The default Remove items everywhere will remove items to the trash folder on Google Drive when items are deleted locally.
Do not remove items everywhere will ignore items deleted locally and not delete items on Google Drive. NOTE: If the items are still set to sync, the items will be downloaded the next time you click Sync Now or changes to the files are detected on Google Drive online and Auto Sync is selected.
Ask me before removing items everywhere. When items are deleted locally, you will be asked to confirm before items are removed from Google Drive.
Google Docs:
You can also select if you would like overGrive to convert your Google Docs to office file formats that can be edited locally.
Select which file format to use for each of the Google Docs formats.
Changes made locally to Documents, Spreadsheets and Presentations created from original Google Docs will be synced back to Google Drive as revisions of the original Google Docs.
Backup:
Only backup files and folders from your local computer to Google Drive. Backup mode.
All items in your local folder will be uploaded to Google Drive.
No files will be synced from Google Drive to your local machine.
Only new items locally will be uploaded to Google Drive. If the Google Drive item version is newer than the local version, the local item will be ignored.
Item changes on Google Drive will be ignored.
Local files can be deleted without items being removed from Google Drive.
You can switch between Sync and Backup mode as required.
Misc:
KDE, Lubuntu and LXDE desktop users select the Prefer Light Icon Theme if they cannot see the application icon clearly.
Advanced:
Click Advanced to exclude files by extension.
Add and Remove extensions as required.
All files with the extensions listed will be ignored during backup and sync.
Hidden files and folders can be excluded by selecting the Ignore hidden files and folders option.
4. First Sync
Once you have completed setting your preferences. Click Start Sync
Your files will be synchronized to your local Google Drive folder from your Google Drive online.
Before syncing for the first time, we suggest you clear all Trash files from your Google Drive online.
The Preferencess menu will not be available while overGrive is busy with a sync.
NOTE : It is best to allow overGrive to finish the first sync completely and not make any changes while busy.
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 continue the synchronization process.
5. Activate License
When restarting overGrive the license activation dialog will appear.
Click Activate
To activate the license enter the license activation code emailed to you, in the box provided and click Activate again.
NOTE: The license code is only valid for the Google Account used during registration.
If you get an Activation code error it is because the Google account used is not correct or the code was not copied and pasted correctly. It is case sensitive so upper and lowercase in the email does matter.
The current connected account is shown in the preferences menu.
* Lubuntu / Xubuntu - Taskbar icon display (LXQt and Xfce desktop Users Only)
LXQt / Xfce desktop users (Lubuntu / Xubuntu) might have an issue with the overGrive application indicator icon in the taskbar incorrectly being displayed as a ⚙ gear icon or not at all.
Enter the following commands from a terminal and restart the progam to fix the issue. You might also need to logout and login before the icon displays correctly.
sudo sed -i 's/Exec=python3/Exec=dbus-launch\ python3/g' /usr/share/applications/overgrive.desktop > /dev/null 2>&1
sudo sed -i 's/Exec=python3/Exec=dbus-launch\ python3/g' /opt/thefanclub/overgrive/overgrive-autostart.desktop > /dev/null 2>&1
sed -i 's/Exec=python3/Exec=dbus-launch\ python3/g' ~/.config/autostart/overgrive-autostart.desktop > /dev/null 2>&1
Lubuntu / LXQt desktop users that cannot open or view the Preferences > Advanced menu can install the missing MIME file type icons with the following commands from a terminal:
sudo apt install yaru-theme-icon
* Elementary OS - Fix top bar application indicators (Pantheon Desktop Users Only)
This article explains how to re-enable AppIndicators on elementary OS:
https://www.linuxuprising.com/2018/08/how-to-re-enable-ayatana-appindicators.html
Screenshots
Pop!_OS - Cosmic Desktop
Deepin - DDE Desktop
Mint - Cinnamon Desktop
KDE - Plasma Desktop
Select the "Prefer Light Icon Theme" setting in the preferences menu on KDE Plasma desktops.
Manjaro - Xfce Desktop