Jump to content

KIO GDrive: Difference between revisions

From KDE Community Wiki
Einar77 (talk | contribs)
Add openSUSE information
Pmello (talk | contribs)
Add link to repository on KDE Invent
 
(45 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.
<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]]
[[File:Kio gdrive.png]]


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


== Gentoo ==  
=== Exherbo ===
<syntaxhighlight lang="bash">
cave resolve kio-gdrive
</syntaxhighlight>


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


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


KIO GDrive is available as part of openSUSE Tumbleweed and is regularly updated there.  Use YaST or zypper to install <tt>kio-gdrive</tt>.
=== openSUSE ===
<syntaxhighlight lang="bash">
sudo zypper in kio-gdrive
</syntaxhighlight>


openSUSE Leap users can find it in the [http://download.opensuse.org/repositories/KDE:/Extra/openSUSE_Tumbleweed/ KDE:Extra third-party repository].
=== FreeBSD ===
{{Output|1=<nowiki>pkg install kio-gdrive</nowiki>}}


== Distro XXX ==
=== Fedora GNU/Linux ===
 
<syntaxhighlight lang="bash">
TODO: add installation instructions for Distro XXX
dnf install kio-gdrive
</syntaxhighlight>


== Distro YYY ==
== Usage ==
 
Open the Network folder in Dolphin and click on "Google Drive".
TODO: add installation instructions for Distro YYY
 
= 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.
 
You can do the same from the command line as well:


Or you can use the command line, such as:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
kioclient5 exec gdrive:/
kioclient5 exec gdrive:/
</syntaxhighlight>
</syntaxhighlight>


= Build from source =
== Build from source ==
 
* Latest stable release: '''<code>v1.3.0</code>'''
* Latest stable release: <code>v1.0.3</code>
* Source tarball: '''[https://download.kde.org/stable/kio-gdrive/1.3.0/src/kio-gdrive-1.3.0.tar.xz kio-gdrive-1.3.0.tar.xz]''' [ [https://download.kde.org/stable/kio-gdrive/1.3.0/src/kio-gdrive-1.3.0.tar.xz.sig Signature] ]
* Source tarball: http://download.kde.org/stable/kio-gdrive/1.0.3/src/kio-gdrive-1.0.3.tar.xz
* KDE Invent: '''[https://invent.kde.org/network/kio-gdrive.git Git repository]'''
* Signature: http://download.kde.org/stable/kio-gdrive/1.0.3/src/kio-gdrive-1.0.3.tar.xz.sig
* Signature key fingerprint: <tt>F07D85CAA18ACF46A346FD017C7FC6EA8633B4EA</tt>


== Build on Linux ==
== Build on Linux ==
Assuming that you have all the dependencies already installed, just do:
Assuming that you have all the dependencies already installed, just do:


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
git clone git://anongit.kde.org/kio-gdrive.git
git clone https://invent.kde.org/network/kio-gdrive.git && cd kio-gdrive
cd kio-gdrive
mkdir build && cd build
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr ..
cmake -DCMAKE_INSTALL_PREFIX="$(qtpaths --install-prefix)" ..
make && make test
sudo make install
sudo make install
kdeinit5 # or just re-login
kdeinit5 # or just re-login
</syntaxhighlight>
</syntaxhighlight>


{{Warning|On some distro (e.g. Archlinux) installing in a different prefix (such as <tt>/usr/local</tt>) might not work.}}
{{Warning|You can install into a different prefix, as long as it 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.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]).
 
==== 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 [https://bugs.kde.org/show_bug.cgi?id=375765 375765]).
* Fixed component tag in the appstream file.
* 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.


If you have problems building from source, feel free to ask for help in the #kde-devel irc channel.
==== v1.2.3 ====
* Added missing copy of GPL3 license.
* Updated translations.


= Changelog =  
==== 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.0.0 ==  
==== v1.2.1 ====
* Build fixes.
* Updated translations.


First stable release
==== v1.2.0 ====
* Integration with KAccounts
* Google Drive free space is now reported


== v1.0.1 ==
==== v1.1.2 ====
Updated translations.


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.1.1 ====
Fixed wrong write permissions in the top-level accounts folder.


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


Fixed copy-pasting from <tt>gdrive://</tt> URLs to local disk (bug [https://bugs.kde.org/show_bug.cgi?id=369619 369619]).
==== v1.0.5 ====
Updated translations.


== v1.0.3 ==  
==== 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.3 ====
Stop trashing all account files on account removal.
Stop trashing all account files on account removal.


= Discussions =  
==== 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.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.0 ====
First stable release


== Discussions ==
* Mailing list: https://mail.kde.org/mailman/listinfo/kde-devel
* Mailing list: https://mail.kde.org/mailman/listinfo/kde-devel
* IRC: <tt>#kde-devel</tt> channel
* IRC: <tt>#kde-fm</tt> channel


= Links =
== Links ==
* Bug Tracker: https://bugs.kde.org/enter_bug.cgi?product=kio-gdrive&format=guided
* Source code repository: https://invent.kde.org/network/kio-gdrive
* Project planning: https://phabricator.kde.org/tag/kio_gdrive/


* Bugs: https://bugs.kde.org/enter_bug.cgi?product=kio-gdrive&format=guided
== How to Contribute ==
* Git repo: https://phabricator.kde.org/diffusion/219/
Prepare merge requests for review [https://invent.kde.org/network/kio-gdrive/-/merge_requests here]
* Phabricator project: https://phabricator.kde.org/tag/kio_gdrive/


= How to Contribute =
== Privacy Policy ==
Upload patches for review here: https://phabricator.kde.org/differential/diff/create/
https://community.kde.org/KIO_GDrive/Privacy_Policy

Latest revision as of 12:55, 5 July 2021

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.

Installation

Arch Linux

pacman -S kio-gdrive

Exherbo

cave resolve kio-gdrive

Gentoo

emerge kde-misc/kio-gdrive

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

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

Or you can use the command line, such as:

kioclient5 exec gdrive:/

Build from source

Build on Linux

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

git clone https://invent.kde.org/network/kio-gdrive.git && cd kio-gdrive
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX="$(qtpaths --install-prefix)" ..
make && make test
sudo make install
kdeinit5 # or just re-login

Warning

You can install into a different prefix, as long as it 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.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

Discussions

Links

How to Contribute

Prepare merge requests for review here

Privacy Policy

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