KIO GDrive: Difference between revisions

From KDE Community Wiki
(First draft)
 
mNo edit summary
(50 intermediate revisions by 10 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.
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]]


= How to install =
= How to install =


== Distro XXX ==
== Arch Linux ==  


TODO: add installation instructions for Distro XXX
<syntaxhighlight lang="bash">
pacman -S kio-gdrive
</syntaxhighlight>
 
== Exherbo ==
<syntaxhighlight lang="bash">
cave resolve kio-gdrive
</syntaxhighlight>


== Distro YYY ==
== Gentoo ==  
<syntaxhighlight lang="bash">
emerge kde-misc/kio-gdrive
</syntaxhighlight>


TODO: add installation instructions for Distro YYY
== KDE Neon or Kubuntu==
 
<syntaxhighlight lang="bash">
sudo apt install kio-gdrive
</syntaxhighlight>
 
== openSUSE ==
 
<syntaxhighlight lang="bash">
sudo zypper in kio-gdrive
</syntaxhighlight>
 
== FreeBSD ==
 
{{Output|1=<nowiki>pkg install kio-gdrive</nowiki>}}
 
== Fedora GNU/Linux ==
 
<syntaxhighlight lang="bash">
dnf install kio-gdrive
</syntaxhighlight>


= Usage =  
= Usage =  
Just open your application menu and look for "Google Drive". You should find a Desktop file that will open Dolphin with the <code>gdrive://</code> URL already set.
Open the Network folder in Dolphin and click on "Google Drive".


You can do the same from the command line as well:
You can use the command line as well:


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
kioclient5 exec gdrive:/
kioclient5 exec gdrive:/
</syntaxhighlight>
</syntaxhighlight>
= Build from source =
* Latest stable release: <code>v1.2.80</code>
* Source tarball: http://download.kde.org/unstable/kio-gdrive/1.2.80/src/kio-gdrive-1.2.80.tar.xz
* Signature: http://download.kde.org/unstable/kio-gdrive/1.2.80/src/kio-gdrive-1.2.80.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
cmake -DCMAKE_INSTALL_PREFIX=`qtpaths --install-prefix` ..
sudo make install
kdeinit5 # or just re-login
</syntaxhighlight>
{{Warning|You can install into a different prefix, as long as is the same prefix <tt>kdeinit5</tt> has been installed into.}}
If you have problems building from source, feel free to ask for help in the #kde-fm IRC channel.
= Changelog =
== v1.0.0 ==
First stable release
== 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]).
== 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 ==
Updated translations.
== v1.1.0 ==
Replaced custom Dolphin .desktop file with a Google Drive link in the Network (remote://) folder.
== v1.1.1 ==
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.
== v1.2.2 ==
* 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]).
* Updated translations.
== v1.2.3 ==
* Added missing copy of GPL3 license.
* Updated translations.
== 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.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.
== v1.2.6 ==
Updated translations.
== v1.2.7 ==
Fixed build against libkgapi >= 5.12 (i.e. libkgapi from KDE Applications 19.08).
== 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]).
= Discussions =
* Mailing list: https://mail.kde.org/mailman/listinfo/kde-devel
* IRC: <tt>#kde-fm</tt> channel
= Links =
* Bugs: https://bugs.kde.org/enter_bug.cgi?product=kio-gdrive&format=guided
* Git repository: https://phabricator.kde.org/source/kio-gdrive/
* Phabricator project: https://phabricator.kde.org/tag/kio_gdrive/
= How to Contribute =
Upload patches for review here: https://phabricator.kde.org/differential/diff/create/
= Privacy Policy =
https://community.kde.org/KIO_GDrive/Privacy_Policy

Revision as of 18:46, 23 March 2020

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.

How to install

Arch Linux

pacman -S kio-gdrive

Exherbo

cave resolve kio-gdrive

Gentoo

emerge kde-misc/kio-gdrive

KDE Neon or Kubuntu

sudo apt install kio-gdrive

openSUSE

sudo zypper in kio-gdrive

FreeBSD

pkg install kio-gdrive

Fedora GNU/Linux

dnf install kio-gdrive

Usage

Open the Network folder in Dolphin and click on "Google Drive".

You can use the command line as well:

kioclient5 exec gdrive:/

Build from source

Build on Linux

Assuming that you have all the dependencies already installed, just do:

git clone git://anongit.kde.org/kio-gdrive.git
cd kio-gdrive
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=`qtpaths --install-prefix` ..
sudo make install
kdeinit5 # or just re-login

Warning

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


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

Changelog

v1.0.0

First stable release

v1.0.1

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

v1.0.2

Fixed copy-pasting from gdrive:// URLs to local disk (bug 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 371954)
  • Added TryExec key in the .desktop file.

v1.0.5

Updated translations.

v1.1.0

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

v1.1.1

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.

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.3

  • Added missing copy of GPL3 license.
  • 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.5

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

v1.2.6

Updated translations.

v1.2.7

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

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).

Discussions

Links

How to Contribute

Upload patches for review here: https://phabricator.kde.org/differential/diff/create/

Privacy Policy

https://community.kde.org/KIO_GDrive/Privacy_Policy