Skip to content
This repository has been archived by the owner on Mar 4, 2023. It is now read-only.

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Skycoder42 committed Aug 4, 2017
1 parent 8c7636f commit 6e1f53e
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 2 deletions.
30 changes: 30 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,33 @@
A plugin for dolphin to show the seafile synchronization status

## Features
A simple VCS plugin for KDEs [Dolphin](https://www.kde.org/applications/system/dolphin/) file manager, that displays sync status for your [Seafile](https://www.seafile.com/en/home/) repositories. Simply install and enable under "Services". Currently, the plugin can:

- Display sync status of seafile repositories
- Per File/Folder thats inside a seafile folder
- Including special states, e.g. "ignored"

More features, such as sharing, etc. are planned.

### Limitations/Workaround
Due to the way those dolphin plugins work, only repositories that are inside your seafile main directory will work. Additionally, you will have to open this folder once, before the plugin recognizes them.

The reason is, that the plugin reacts on the presence of the `.seafile-data` folder. If you have custom locations outside of the folder, or don't want to always go there first, simply create an empty file called `.seafile-data` in whichever directory you need the plugin to work.
One useful location would be your home directory, as thats the default directory dolphin opens.

I'll try to work around that issue in future versions.

## Dependencies
You'll need Dolphin (and thus Qt and KDE frameworks) and Seafile. The plugin only needs the seafile daemon, so make shure you have that one with whatever seafile package you use. Also, ccnet is required, but as it's a depedency of seafile, should always be present.

## Installation
For now, only an AUR package is provided: [`dolphin-seafile-plugin`](https://aur.archlinux.org/packages/dolphin-seafile-plugin)
Debian packages and others I will provide as soon as possible.

Until then, you can simply build it yourself. Install all the stated dependencies and build via:
```
cd plugin
qmake
make
make install
```
4 changes: 2 additions & 2 deletions plugin/fileviewseafileplugin.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -58,9 +58,9 @@ KVersionControlPlugin::ItemVersion FileViewSeafilePlugin::itemVersion(const KFil
case SeafStatus::Synced:
return NormalVersion;
case SeafStatus::Paused:
return MissingVersion; //TODO other ItemVersion?
return MissingVersion;
case SeafStatus::Readonly:
return RemovedVersion; //TODO other ItemVersion?
return RemovedVersion;
case SeafStatus::Locked:
return LocallyModifiedUnstagedVersion;
case SeafStatus::LockedByMe:
Expand Down

0 comments on commit 6e1f53e

Please sign in to comment.