Jump to content

KIO GDrive: Difference between revisions

From KDE Community Wiki
← Older edit
Elvis Angelaccio (talk | contribs)
KDEDevelopers, trusted
166 edits
Release 1.2.7
Pmello (talk | contribs)
59 edits
Update latest release version and building from source guidance
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
KIO GDrive is a KIO slave that enables KIO-aware applications (such as Dolphin, Kate or Gwenview) to access and edit Google Drive files on the cloud.
[[File:Kio gdrive.png|thumb|right|x256px|Screenshot of browsing Google Drive with [[Dolphin]]. ([[Schedules/Plasma 5|Plasma 5]])]]
<big>'''KIO GDrive''' is a KIO slave that enables KIO-aware applications (such as Dolphin, Kate or Gwenview) to access and edit Google Drive files on the cloud.</big>


[[File:Kio gdrive.png]]
== Usage ==
Open the Network folder in [[Dolphin]] and click on "Google Drive" or from the command line using: <syntaxhighlight lang="shell" inline>kioclient exec gdrive:/</syntaxhighlight>.


= How to install =
== Installation ==
=== Arch Linux ===
<syntaxhighlight lang="shell">pacman -S kio-gdrive</syntaxhighlight>


== Arch Linux ==  
=== Debian/KDE neon/Kubuntu (and other Debian derivatives) ===
<syntaxhighlight lang="shell">sudo apt install kio-gdrive</syntaxhighlight>


<syntaxhighlight lang="bash">
=== Exherbo ===
pacman -S kio-gdrive
<syntaxhighlight lang="shell">cave resolve kio-gdrive</syntaxhighlight>
</syntaxhighlight>
 
== Exherbo ==
<syntaxhighlight lang="bash">
cave resolve kio-gdrive
</syntaxhighlight>
 
== Gentoo ==
<syntaxhighlight lang="bash">
emerge kde-misc/kio-gdrive
</syntaxhighlight>


== KDE Neon or Kubuntu==
=== Fedora ===
<syntaxhighlight lang="shell">dnf install kio-gdrive</syntaxhighlight>


<syntaxhighlight lang="bash">
=== FreeBSD ===
sudo apt install kio-gdrive
<syntaxhighlight lang="shell">pkg install kio-gdrive</syntaxhighlight>
</syntaxhighlight>


== openSUSE ==
=== Gentoo ===
<syntaxhighlight lang="shell">emerge kde-misc/kio-gdrive</syntaxhighlight>


<syntaxhighlight lang="bash">
=== openSUSE ===
sudo zypper in kio-gdrive
<syntaxhighlight lang="shell">sudo zypper in kio-gdrive</syntaxhighlight>
</syntaxhighlight>


== FreeBSD ==
== Build from source ==
* Latest stable release: '''<code>v25.08.0</code>'''
* Source tarball: '''[https://download.kde.org/stable/release-service/25.08.0/src/kio-gdrive-25.08.0.tar.xz kio-gdrive-25.08.0.tar.xz]''' &lsqb;[https://download.kde.org/stable/release-service/25.08.0/src/kio-gdrive-25.08.0.tar.xz.sig Signature]&rsqb;
* KDE Invent: '''[https://invent.kde.org/network/kio-gdrive.git Git repository]''' (<syntaxhighlight lang="shell" inline>git clone https://invent.kde.org/network/kio-gdrive.git</syntaxhighlight>)


{{Output|1=<nowiki>pkg install kio-gdrive</nowiki>}}
=== Build on Linux ===
==== Dependencies ====
===== Mandatory =====
* [[Guidelines and HOWTOs/CMake|CMake]] v3.16 or higher
** [https://api.kde.org/ecm/ Extra CMake Modules]
* Qt 6.5.0 or higher
** QtGui
** QtNetwork
** QtWidgets
* [[Frameworks|KDE Frameworks]] v6.3.0 or higher
** DocTools
** I18n
** [[KIO]]
* [[KDE PIM]] v6.2.40 or higher
** libkpim6gapicore6
** libkpim6gapidrive6
And one of either:
* KAccounts v24.08.0 or higher, optionally enhanced by
** [[Frameworks|KDE Frameworks]] Purpose v6.3.0 or higher
or
* QtKeychain v0.12.0 or higher


== Fedora GNU/Linux ==  
===== Optional =====
* libqt6test6 v6.5.0 or higher


<syntaxhighlight lang="bash">
==== Compilation ====
dnf install kio-gdrive
Assuming that you have all the dependencies already installed, the compilation process is accomplished using the following sequence of commands:
</syntaxhighlight>


= Usage =
<syntaxhighlight lang="shell">
Open the Network folder in Dolphin and click on "Google Drive".
git clone https://invent.kde.org/network/kio-gdrive.git && cd kio-gdrive
 
You can use the command line as well:
 
<syntaxhighlight lang="bash">
kioclient5 exec gdrive:/
</syntaxhighlight>
 
= Build from source =
 
* Latest stable release: <code>v1.2.6</code>
* Source tarball: http://download.kde.org/stable/kio-gdrive/1.2.6/src/kio-gdrive-1.2.6.tar.xz
* Signature: http://download.kde.org/stable/kio-gdrive/1.2.6/src/kio-gdrive-1.2.6.tar.xz.sig
 
== Build on Linux ==
 
Assuming that you have all the dependencies already installed, just do:
 
<syntaxhighlight lang="bash">
git clone git://anongit.kde.org/kio-gdrive.git
cd kio-gdrive
mkdir build && cd build
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=`qtpaths --install-prefix` ..
cmake -DCMAKE_INSTALL_PREFIX="$(qtpaths6 --install-prefix)" ..
sudo make install
cmake --build .
kdeinit5 # or just re-login
ctest
sudo cmake --install .
</syntaxhighlight>
</syntaxhighlight>


{{Warning|You can install into a different prefix, as long as is the same prefix <tt>kdeinit5</tt> has been installed into.}}
Lastly, you'll need to restart your running Plasma instance or simply logout of your user session and then login again.
 
If you have problems building from source, feel free to ask for help in the #kde-fm IRC channel.


= Changelog =
{{Warning|You can install into a different prefix, as long as it is the same prefix <code>startplasma</code> has been installed into.}}


== v1.0.0 ==
If you have problems building from source, feel free to ask for help in the [ircs://irc.libera.chat/kde-fm #kde-fm] [[userbase:IRC Channels|IRC channel]].


First stable release
== How to contribute ==
* Prepare [https://invent.kde.org/network/kio-gdrive/-/merge_requests merge requests] for review


== v1.0.1 ==
== Changelog ==
==== v1.3.0 ====
* Support for the Shared Drives feature of Google Drive.
* New "Copy Google URL to clipboard" action in the Dolphin context-menu.
* Support for the new kaccounts-integration 20.04 release.
* Improved appstream metadata.
* Fixed opening docx files as archives in remote folders (bug [https://bugs.kde.org/show_bug.cgi?id=401151 401151]).


Fixed a bug that caused the login dialog to show up again after authentication (bugs [https://bugs.kde.org/show_bug.cgi?id=367988 367988], [https://bugs.kde.org/show_bug.cgi?id=369581 369581]).
==== v1.2.7 ====
 
Fixed build against libkgapi >= 5.12 (i.e. libkgapi from KDE Applications 19.08).
== v1.0.2 ==
 
Fixed copy-pasting from <tt>gdrive://</tt> URLs to local disk (bug [https://bugs.kde.org/show_bug.cgi?id=369619 369619]).
 
== v1.0.3 ==  
 
Stop trashing all account files on account removal.
 
== v1.0.4 ==
 
* Fixed an issue that would make some files hidden (bug [https://bugs.kde.org/show_bug.cgi?id=371954 371954])
* Added <tt>TryExec</tt> key in the .desktop file.
 
== v1.0.5 ==


==== v1.2.6 ====
Updated translations.
Updated translations.


== v1.1.0 ==  
==== v1.2.5 ====
* Fixed downloading of large files (bug [https://bugs.kde.org/show_bug.cgi?id=375765 375765]).
* Fixed component tag in the appstream file.
* Updated translations.


Replaced custom Dolphin .desktop file with a Google Drive link in the Network (remote://) folder.
==== v1.2.4 ====
* Fixed opening files with special characters in their name (bug [https://bugs.kde.org/show_bug.cgi?id=395590 395590]).
* Fixed homepage URL in the appstream file.
* Updated translations.


== v1.1.1 ==
==== v1.2.3 ====
 
* Added missing copy of GPL3 license.
Fixed wrong write permissions in the top-level accounts folder.
 
== v1.1.2 ==
 
Updated translations.
 
== v1.2.0 ==
 
* Integration with KAccounts
* Google Drive free space is now reported
 
== v1.2.1 ==
 
* Build fixes.
* Updated translations.
* Updated translations.


== v1.2.2 ==
==== v1.2.2 ====
 
* Fixed mimetype used to open .ods files (bug [https://bugs.kde.org/show_bug.cgi?id=388598 388598]).
* Fixed mimetype used to open .ods files (bug [https://bugs.kde.org/show_bug.cgi?id=388598 388598]).
* Fixed copy of files within the same gdrive account (bug [https://bugs.kde.org/show_bug.cgi?id=376735 376735]).
* Fixed copy of files within the same gdrive account (bug [https://bugs.kde.org/show_bug.cgi?id=376735 376735]).
* Updated translations.
* Updated translations.


== v1.2.3 ==
==== v1.2.1 ====
 
* Build fixes.
* Added missing copy of GPL3 license.
* Updated translations.
* Updated translations.


== v1.2.4 ==
==== v1.2.0 ====
* Integration with KAccounts
* Google Drive free space is now reported


* Fixed opening files with special characters in their name (bug [https://bugs.kde.org/show_bug.cgi?id=395590 395590]).
==== v1.1.2 ====
* Fixed homepage URL in the appstream file.
Updated translations.
* Updated translations.


== v1.2.5 ==
==== v1.1.1 ====
Fixed wrong write permissions in the top-level accounts folder.


* Fixed downloading of large files (bug [https://bugs.kde.org/show_bug.cgi?id=375765 375765]).
==== v1.1.0 ====
* Fixed component tag in the appstream file.
Replaced custom Dolphin .desktop file with a Google Drive link in the Network (remote://) folder.
* Updated translations.


== v1.2.6 ==
==== v1.0.5 ====
Updated translations.


Updated translations.
==== v1.0.4 ====
* Fixed an issue that would make some files hidden (bug [https://bugs.kde.org/show_bug.cgi?id=371954 371954])
* Added <tt>TryExec</tt> key in the .desktop file.


== v1.2.7 ==
==== v1.0.3 ====
Stop trashing all account files on account removal.


Fixed build against libkgapi >= 5.12 (i.e. libkgapi from KDE Applications 19.08).
==== v1.0.2 ====
Fixed copy-pasting from <tt>gdrive://</tt> URLs to local disk (bug [https://bugs.kde.org/show_bug.cgi?id=369619 369619]).


= Discussions =  
==== v1.0.1 ====
Fixed a bug that caused the login dialog to show up again after authentication (bugs [https://bugs.kde.org/show_bug.cgi?id=367988 367988], [https://bugs.kde.org/show_bug.cgi?id=369581 369581]).


* Mailing list: https://mail.kde.org/mailman/listinfo/kde-devel
==== v1.0.0 ====
* IRC: <tt>#kde-fm</tt> channel
First stable release


= Links =
== See also ==
[[KIO GDrive/Privacy Policy|KIO GDrive Privacy Policy]]


* Bugs: https://bugs.kde.org/enter_bug.cgi?product=kio-gdrive&format=guided
== External links ==
* Git repository: https://phabricator.kde.org/source/kio-gdrive/
* '''[https://apps.kde.org/kio_gdrive/ Official website]'''
* Phabricator project: https://phabricator.kde.org/tag/kio_gdrive/
* '''[https://bugs.kde.org/enter_bug.cgi?product=kio-gdrive&format=guided Bug tracker]'''
* '''[https://invent.kde.org/network/kio-gdrive Source code repository]'''


= How to Contribute =
=== Discussions ===
Upload patches for review here: https://phabricator.kde.org/differential/diff/create/
* '''[https://mail.kde.org/mailman/listinfo/kde-devel kde-devel]''' mailing list
* '''[ircs://irc.libera.chat/kde-fm #kde-fm]''' [[userbase:IRC Channels|IRC channel]] on Libera.Chat

Latest revision as of 22:10, 18 August 2025

Screenshot of browsing Google Drive with Dolphin. (Plasma 5)

KIO GDrive is a KIO slave that enables KIO-aware applications (such as Dolphin, Kate or Gwenview) to access and edit Google Drive files on the cloud.

Usage

Open the Network folder in Dolphin and click on "Google Drive" or from the command line using: kioclient exec gdrive:/.

Installation

Arch Linux

pacman -S kio-gdrive

Debian/KDE neon/Kubuntu (and other Debian derivatives)

sudo apt install kio-gdrive

Exherbo

cave resolve kio-gdrive

Fedora

dnf install kio-gdrive

FreeBSD

pkg install kio-gdrive

Gentoo

emerge kde-misc/kio-gdrive

openSUSE

sudo zypper in kio-gdrive

Build from source

Build on Linux

Dependencies

Mandatory

And one of either:

  • KAccounts v24.08.0 or higher, optionally enhanced by

or

  • QtKeychain v0.12.0 or higher
Optional
  • libqt6test6 v6.5.0 or higher

Compilation

Assuming that you have all the dependencies already installed, the compilation process is accomplished using the following sequence of commands: 

git clone https://invent.kde.org/network/kio-gdrive.git && cd kio-gdrive
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX="$(qtpaths6 --install-prefix)" ..
cmake --build .
ctest
sudo cmake --install .

Lastly, you'll need to restart your running Plasma instance or simply logout of your user session and then login again.

Warning

You can install into a different prefix, as long as it is the same prefix startplasma has been installed into.


If you have problems building from source, feel free to ask for help in the #kde-fm IRC channel.

How to contribute

Changelog

v1.3.0

  • Support for the Shared Drives feature of Google Drive.
  • New "Copy Google URL to clipboard" action in the Dolphin context-menu.
  • Support for the new kaccounts-integration 20.04 release.
  • Improved appstream metadata.
  • Fixed opening docx files as archives in remote folders (bug 401151).

v1.2.7

Fixed build against libkgapi >= 5.12 (i.e. libkgapi from KDE Applications 19.08).

v1.2.6

Updated translations.

v1.2.5

  • Fixed downloading of large files (bug 375765).
  • Fixed component tag in the appstream file.
  • Updated translations.

v1.2.4

  • Fixed opening files with special characters in their name (bug 395590).
  • Fixed homepage URL in the appstream file.
  • Updated translations.

v1.2.3

  • Added missing copy of GPL3 license.
  • Updated translations.

v1.2.2

  • Fixed mimetype used to open .ods files (bug 388598).
  • Fixed copy of files within the same gdrive account (bug 376735).
  • Updated translations.

v1.2.1

  • Build fixes.
  • Updated translations.

v1.2.0

  • Integration with KAccounts
  • Google Drive free space is now reported

v1.1.2

Updated translations.

v1.1.1

Fixed wrong write permissions in the top-level accounts folder.

v1.1.0

Replaced custom Dolphin .desktop file with a Google Drive link in the Network (remote://) folder.

v1.0.5

Updated translations.

v1.0.4

  • Fixed an issue that would make some files hidden (bug 371954)
  • Added TryExec key in the .desktop file.

v1.0.3

Stop trashing all account files on account removal.

v1.0.2

Fixed copy-pasting from gdrive:// URLs to local disk (bug 369619).

v1.0.1

Fixed a bug that caused the login dialog to show up again after authentication (bugs 367988, 369581).

v1.0.0

First stable release

See also

KIO GDrive Privacy Policy

External links

Discussions

Retrieved from "https://community.kde.org/index.php?title=KIO_GDrive&oldid=104264"