Jump to content

KIO GDrive: Difference between revisions

From KDE Community Wiki
Elvis Angelaccio (talk | contribs)
m Update changelog
Pmello (talk | contribs)
Add link to repository on KDE Invent
 
(36 intermediate revisions by 9 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>


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


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


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


== openSUSE ==
=== openSUSE ===
<syntaxhighlight lang="bash">
sudo zypper in 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>.
=== FreeBSD ===
{{Output|1=<nowiki>pkg install kio-gdrive</nowiki>}}


openSUSE Leap users can find it in the [http://download.opensuse.org/repositories/KDE:/Extra/openSUSE_Tumbleweed/ KDE:Extra third-party repository].
=== Fedora GNU/Linux ===
 
<syntaxhighlight lang="bash">
== FreeBSD ==
dnf install kio-gdrive
 
</syntaxhighlight>
KIO GDrive is available in the [email protected] development  svn repository:
http://area51.pcbsd.org/branches/plasma5 in net/kio-gdrive
 
= 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:
== Usage ==
Open the Network folder in Dolphin and click on "Google Drive".


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.5</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.5/src/kio-gdrive-1.0.5.tar.xz
* KDE Invent: '''[https://invent.kde.org/network/kio-gdrive.git Git repository]'''
* Signature: http://download.kde.org/stable/kio-gdrive/1.0.5/src/kio-gdrive-1.0.5.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).


If you have problems building from source, feel free to ask for help in the #kde-devel irc channel.
==== v1.2.6 ====
Updated translations.


= Changelog =  
==== 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.0.0 ==  
==== 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.


First stable release
==== v1.2.3 ====
* Added missing copy of GPL3 license.
* Updated translations.


== v1.0.1 ==
==== 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.


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.1 ====
* Build fixes.
* Updated translations.


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


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


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


Stop trashing all account files on account removal.
==== v1.1.0 ====
Replaced custom Dolphin .desktop file with a Google Drive link in the Network (remote://) folder.


== v1.0.4 ==  
==== v1.0.5 ====
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])
* 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.
* Added <tt>TryExec</tt> key in the .desktop file.


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


Updated translations.
==== 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]).


= Discussions =  
==== 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