Improve README.md
This commit is contained in:
parent
d50cdf3a06
commit
3d4fcaea0f
78
README.md
78
README.md
|
@ -13,10 +13,13 @@ and announcement of new features.
|
||||||
Issues can be created on GitHub but please read the "Known bugs" and "Planned features" sections in this document
|
Issues can be created on GitHub but please read the "Known bugs" and "Planned features" sections in this document
|
||||||
before.
|
before.
|
||||||
|
|
||||||
|
I provide binaries/repositories for some platforms. There are also binaries/repositories provided by other
|
||||||
|
distributors. For a list with links, checkout the *Download* section of this document. The release section on
|
||||||
|
GitHub only contains a fraction of the available options.
|
||||||
|
|
||||||
## Supported platforms
|
## Supported platforms
|
||||||
* Designed to work under any desktop environment supported by Qt 5 with tray icon
|
* Designed to work under any desktop environment supported by Qt 5 with tray icon support
|
||||||
support
|
* No desktop environment specific libraries required (only for optional features/integrations)
|
||||||
* No desktop environment specific libraries required (only for optional features)
|
|
||||||
* Tested under
|
* Tested under
|
||||||
* X Window System
|
* X Window System
|
||||||
* Plasma 5 (beside Qt Widgets based version there is a native "Plasmoid")
|
* Plasma 5 (beside Qt Widgets based version there is a native "Plasmoid")
|
||||||
|
@ -42,8 +45,7 @@ before.
|
||||||
The Qt Widgets based version basically works under Wayland but there are positioning issues (see known bugs
|
The Qt Widgets based version basically works under Wayland but there are positioning issues (see known bugs
|
||||||
section).
|
section).
|
||||||
|
|
||||||
If you can confirm it works under other desktop environments, please add it
|
If you can confirm it works under other desktop environments, please add it to the list.
|
||||||
to the list.
|
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
* Provides quick access to most frequently used features but does not intend to replace the official web UI
|
* Provides quick access to most frequently used features but does not intend to replace the official web UI
|
||||||
|
@ -58,40 +60,47 @@ to the list.
|
||||||
* Pause/resume a specific device or all devices at once
|
* Pause/resume a specific device or all devices at once
|
||||||
* Pause/resume a specific directory
|
* Pause/resume a specific directory
|
||||||
* View recent history of changes (done locally and remotely)
|
* View recent history of changes (done locally and remotely)
|
||||||
* Shows Syncthing notifications
|
* Shows notifications
|
||||||
* Can read the local Syncthing configuration file for quick setup when just connecting to local instance
|
* The notification to show is configurable
|
||||||
* Can show the status of the Syncthing systemd unit and allows to start and stop it (see section *Use of systemd*)
|
* Uses Qt's notification support or a D-Bus notification daemon directly
|
||||||
|
* Reads connection parameters from Syncthing config file for quick setup (when just connecting to local instance)
|
||||||
|
* Allows monitoring the status of the Syncthing systemd unit to start and stop it (see section *Use of systemd*)
|
||||||
* Provides an option to conveniently add the tray to the applications launched when the desktop environment starts
|
* Provides an option to conveniently add the tray to the applications launched when the desktop environment starts
|
||||||
* Can launch Syncthing and syncthing-inotify automatically when started and display stdout/stderr (useful under
|
* Can launch Syncthing automatically when started and display stdout/stderr (useful under Windows)
|
||||||
Windows)
|
|
||||||
* Provides quick access to the official web UI
|
* Provides quick access to the official web UI
|
||||||
* Utilizes either Qt WebKit or Qt WebEngine
|
* Utilizes either Qt WebEngine or Qt WebKit
|
||||||
* Can be built without web view support as well (then the web UI is opened in the regular browser)
|
* Can be built without web view support as well (then the web UI is opened in the regular browser)
|
||||||
* Allows quickly switching between multiple Syncthing instances
|
* Allows switching quickly between multiple Syncthing instances
|
||||||
* Shows notifications via Qt or uses D-Bus notification daemon directly
|
|
||||||
* Also features a simple command line utility `syncthingctl`
|
* Also features a simple command line utility `syncthingctl`
|
||||||
* Check status
|
* Check status
|
||||||
* Trigger rescan/pause/resume/restart
|
* Trigger rescan/pause/resume/restart
|
||||||
* Wait for idle
|
* Wait for idle
|
||||||
* View and modify configuration
|
* View and modify raw configuration
|
||||||
* Supports Bash completion, even for directory and device names
|
* Supports Bash completion, even for directory and device names
|
||||||
* Also bundles a KIO plugin which shows the status of a Syncthing directory
|
* Also bundles a KIO plugin which shows the status of a Syncthing directory and allows to trigger Syncthing actions
|
||||||
and allows to trigger Syncthing actions in Dolphin file manager
|
in Dolphin file manager
|
||||||
* Rescan selected items
|
* Rescan selected items
|
||||||
* Rescan entire Syncthing directory
|
* Rescan entire Syncthing directory
|
||||||
* Pause/resume Syncthing directory
|
* Pause/resume Syncthing directory
|
||||||
* See also screenshots section
|
* See also screenshots section
|
||||||
* Also has an implementation as Plasmoid for Plasma 5 desktop
|
* Also has an implementation as Plasmoid for Plasma 5 desktop
|
||||||
* Build Syncthing as a library to run it in the same process as the tray/GUI (optional build configuration, not enabled
|
* Allows building Syncthing as a library to run it in the same process as the tray/GUI (optional build configuration
|
||||||
by default)
|
which is not enabled by default)
|
||||||
* English and German localization
|
* English and German localization
|
||||||
|
|
||||||
## Planned features
|
## Does this launch or bundle Syncthing itself? What about my existing Syncthing installation?
|
||||||
The tray is still under development; the following features are under construction or planned:
|
Syncthing Tray does *not* launch Syncthing itself by default. There should be no interface with your existing
|
||||||
|
Syncthing installation. You might consider different configurations:
|
||||||
|
|
||||||
* Create Qt Quick Controls 2 and Kirigami 2 based frontend for mobile devices (focusing on Android)
|
* If you're happy how Syncthing is started on your system so far just tell Syncthing Tray to connect to your currently
|
||||||
* Make some notifications configurable on folder level
|
running Syncthing instance in the settings. If you're currently starting Syncthing via systemd you might consider
|
||||||
* Optionally notify for single file updates (https://github.com/Martchus/syncthingtray/issues/7)
|
enabling the systemd integration in the settings (see section *Use of systemd*).
|
||||||
|
* If you would like Syncthing Tray to take care of starting Syncthing for you, you can use the Syncthing launcher
|
||||||
|
available in the settings.
|
||||||
|
* The Windows builds provided in the release section on GitHub come with a built-in version of Syncthing
|
||||||
|
which you can consider to use. Keep in mind that automatic updates of Syncthing are not possible this way.
|
||||||
|
* In any case you can simply point the launcher to the binary of Syncthing (which you have to install separately).
|
||||||
|
* It is also possible to let Syncthing Tray connect to a Syncthing instance running on a different machine.
|
||||||
|
|
||||||
## Screenshots
|
## Screenshots
|
||||||
The screenshots are not up-to-date.
|
The screenshots are not up-to-date.
|
||||||
|
@ -157,24 +166,24 @@ See the release section on GitHub.
|
||||||
* for RPM \*.spec files and binary repository checkout
|
* for RPM \*.spec files and binary repository checkout
|
||||||
[openSUSE Build Servide](https://build.opensuse.org/project/show/home:mkittler)
|
[openSUSE Build Servide](https://build.opensuse.org/project/show/home:mkittler)
|
||||||
* there's also a [repo with builds of Git master](https://build.opensuse.org/project/show/home:mkittler:vcs)
|
* there's also a [repo with builds of Git master](https://build.opensuse.org/project/show/home:mkittler:vcs)
|
||||||
* NixOS
|
|
||||||
* the package syncthingtray is available from the official repositories
|
|
||||||
* Exherbo
|
|
||||||
* packages for my other project "Tag Editor" and dependencies could serve as a base and are provided
|
|
||||||
by [the platypus repository](https://git.exherbo.org/summer/packages/media-sound/tageditor)
|
|
||||||
* Gentoo
|
|
||||||
* packages for my other project "Tag Editor" and dependencies could serve as a base and are provided
|
|
||||||
by [perfect7gentleman's repository](https://github.com/perfect7gentleman/pg_overlay)
|
|
||||||
* Other GNU/Linux systems
|
* Other GNU/Linux systems
|
||||||
* [AppImage repository for releases on the openSUSE Build Service](https://download.opensuse.org/repositories/home:/mkittler:/appimage/AppImage)
|
* [AppImage repository for releases on the openSUSE Build Service](https://download.opensuse.org/repositories/home:/mkittler:/appimage/AppImage)
|
||||||
* [AppImage repository for builds from Git master the openSUSE Build Service](https://download.opensuse.org/repositories/home:/mkittler:/appimage:/vcs/AppImage/)
|
* [AppImage repository for builds from Git master the openSUSE Build Service](https://download.opensuse.org/repositories/home:/mkittler:/appimage:/vcs/AppImage/)
|
||||||
* Windows
|
* Windows
|
||||||
* for mingw-w64 PKGBUILDs checkout [my GitHub repository](https://github.com/Martchus/PKGBUILDs)
|
* for mingw-w64 PKGBUILDs checkout [my GitHub repository](https://github.com/Martchus/PKGBUILDs)
|
||||||
* for statically linked binaries checkout the [release section on GitHub](https://github.com/Martchus/syncthingtray/releases)
|
* for statically linked binaries checkout the [release section on GitHub](https://github.com/Martchus/syncthingtray/releases)
|
||||||
|
* NixOS
|
||||||
|
* the package syncthingtray is available from the official repositories
|
||||||
* FreeBSD
|
* FreeBSD
|
||||||
* the package syncthingtray is available from [FreeBSD Ports](https://www.freshports.org/deskutils/syncthingtray)
|
* the package syncthingtray is available from [FreeBSD Ports](https://www.freshports.org/deskutils/syncthingtray)
|
||||||
* Mac OS X/macOS
|
* Mac OS X/macOS
|
||||||
* the package syncthingtray is available from [MacPorts](https://ports.macports.org/port/syncthingtray/)
|
* the package syncthingtray is available from [MacPorts](https://ports.macports.org/port/syncthingtray/)
|
||||||
|
* Exherbo
|
||||||
|
* packages for my other project "Tag Editor" and dependencies could serve as a base and are provided
|
||||||
|
by [the platypus repository](https://git.exherbo.org/summer/packages/media-sound/tageditor)
|
||||||
|
* Gentoo
|
||||||
|
* packages for my other project "Tag Editor" and dependencies could serve as a base and are provided
|
||||||
|
by [perfect7gentleman's repository](https://github.com/perfect7gentleman/pg_overlay)
|
||||||
|
|
||||||
## Build instructions
|
## Build instructions
|
||||||
The application depends on [c++utilities](https://github.com/Martchus/cpp-utilities) and
|
The application depends on [c++utilities](https://github.com/Martchus/cpp-utilities) and
|
||||||
|
@ -323,6 +332,13 @@ Since the Dolphin integration and the Plasmoid are plugins, testing and debuggin
|
||||||
See [Testing and debugging Dolphin/KIO plugin with Qt Creator](/fileitemactionplugin/testing.md)
|
See [Testing and debugging Dolphin/KIO plugin with Qt Creator](/fileitemactionplugin/testing.md)
|
||||||
and [Testing and debugging Plasma 5 plasmoid with Qt Creator](/plasmoid/testing.md).
|
and [Testing and debugging Plasma 5 plasmoid with Qt Creator](/plasmoid/testing.md).
|
||||||
|
|
||||||
|
## Planned features
|
||||||
|
The tray is still under development; the following features are under construction or planned:
|
||||||
|
|
||||||
|
* Create Qt Quick Controls 2 and Kirigami 2 based frontend for mobile devices (focusing on Android)
|
||||||
|
* Make some notifications configurable on folder level
|
||||||
|
* Optionally notify for single file updates (https://github.com/Martchus/syncthingtray/issues/7)
|
||||||
|
|
||||||
## Known bugs
|
## Known bugs
|
||||||
The following bugs are caused by dependencies and hence tracked externally. For bugs of Syncthing Tray itself, checkout the issues
|
The following bugs are caused by dependencies and hence tracked externally. For bugs of Syncthing Tray itself, checkout the issues
|
||||||
on GitHub.
|
on GitHub.
|
||||||
|
|
Loading…
Reference in New Issue