smw/deskflow
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update README.md to provide more community info (#7475)

Browse source 
* Update README.md to provide more community info

* Fixed typos

* Fixed header format

* Improve link text

* Improve wording around maintainers
This commit is contained in:
Nick Bolton 2024-09-05 10:10:26 +01:00 committed by GitHub
parent d277c80fd0
commit 45aa263af3
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 86 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

94
README.md
View file

@ -10,17 +10,30 @@
This project contains the source code for _Synergy 1 Community Edition_ which is actively maintained, free to use, and does not require a license or serial key.
**Wayland support:** Wayland is supported (GNOME 46 is required).
**Wayland support:** Wayland now has experimental support (GNOME 46 is required, KDE TBD).
![Synergy 1 Community Edition](https://github.com/user-attachments/assets/faf5bd69-336c-4bd0-ace3-e911f199d961)
To use the community edition, install the `synergy` package with your favorite package manager or build it yourself using the Developer Quick Start instructions below.
Join us on [Discord](https://discord.com/invite/xBFv6j7) or [Slack](https://synergy-app.slack.com/join/shared_invite/zt-d8if26fr-6x~TSTz4skGmTnFP5IPaww#/shared-invite/email) in the `#open-source` channel.
## Goals and Philosophy
* [Read the wiki](https://github.com/symless/synergy/wiki)
* [Raise an issue](https://github.com/symless/synergy/issues)
* [Start a discussion](https://github.com/symless/synergy/discussions)
Version 1.15 brings a new philosophy of being more approachable to the open-source community instead of wholly focusing on commercial interests.
We still have customers to support the development of the code, but we are committed to maintaining and improving Synergy 1 Community Edition
for years to come and we're excited to work with the community to improve the code for the benefit of everyone.
## Ways to get involved
Here are a few ways to join in with the project and get involved:
* Compile the latest `master` version (see below) and [report a bug](https://github.com/symless/synergy/issues)
* [Submit a PR](https://github.com/symless/synergy/wiki/Contributing) (pull request) with a bug fix or improvement
* [Let us know](https://github.com/symless/synergy/issues) if you have an idea for an improvement
## Where to get help
* Join us on [Discord](https://discord.com/invite/xBFv6j7) or [Slack](https://synergy-app.slack.com/join/shared_invite/zt-d8if26fr-6x~TSTz4skGmTnFP5IPaww#/shared-invite/email) (`#open-source` channel)
* [Start a discussion](https://github.com/symless/synergy/discussions) on our GitHub project
* [Read the wiki](https://github.com/symless/synergy/wiki) for guides and info
## Developer Quick Start
@ -65,9 +78,9 @@ cmake --build build -j8
./build/bin/unittests
```
## Packages
## How to install (packages)
Synergy 1 Community Edition is packaged by the community (status shown below). Package maintainers can use `scripts/package.py` to build packages.
Synergy 1 Community Edition is packaged by the community (status shown below).
Synergy 2 is no longer in development and we recommend that package maintainers do not provide it.
@ -100,6 +113,71 @@ sudo dnf install synergy
sudo pacman -S synergy
```
*Repology:*
## Package Maintainers
Synergy is already available through most package managers as `synergy`, and we would love to see the latest version of
Synergy 1 Community Edition on every package manager for every OS we support (Windows, macOS, Linux, BSD, and so on).
Package maintainers can use `scripts/package.py` to see how we build packages,
but most package maintainers will create a packaging script rather than use our scripts (which is fine by us).
If you're a package maintainer and have a question, please [get in touch](https://github.com/symless/synergy/wiki/Contact-the-team).
Good packages:
- [Fedora](https://packages.fedoraproject.org/pkgs/synergy/synergy/)
- [Arch Linux](https://aur.archlinux.org/packages/synergy)
- [FreeBSD](https://www.freshports.org/sysutils/synergy)
- [Homebrew](https://formulae.brew.sh/formula/synergy-core#default)
- [Gentoo](https://packages.gentoo.org/packages/x11-misc/synergy)
- [openSUSE](https://build.opensuse.org/package/show/openSUSE:Factory/synergy)
Broken packages:
- [Ubuntu](https://launchpad.net/ubuntu/+source/synergy)
- [Debian](https://tracker.debian.org/pkg/synergy)
- [Chocolatey](https://community.chocolatey.org/packages/synergy)
It appears that the `synergy` package has been removed or discontinued from some package repositories.
There are many reasons why this may happen, but sometimes if a package maintainer steps down or leaves the project
without finding a replacement, the package might lose support, leading to its removal.
This can also happen when there are difficulties updating the package to the latest version,
and communication has broken down between the package maintainer and the upstream developers.
If you're a package maintainer and would like to bring the `synergy` package back to life, please
[get in touch](https://github.com/symless/synergy/wiki/Contact-the-team) if you need our help.
## FAQ
### Has Synergy moved beyond its goals from the 1.x era?
Our goal for Synergy 1 (including the community edition) has always been and will always be to make a simple, reliable, and feature-rich
mouse and keyboard-sharing tool. We do maintain another product called Synergy 3, but as this uses Synergy 1 Core (the server and client
part of Synergy), we depend on Synergy 1 to remain stable and modern which is why we continue to develop and improve the product.
### If I want to solve issues in Synergy do I need to contribute to a fork?
We welcome PRs (pull requests) from the community. If you'd like to make a change, please feel free to
[start a discussion](https://github.com/symless/synergy/discussions) or [open a PR](https://github.com/symless/synergy/wiki/Contributing).
We think it's great that people start new forks of Synergy, power to them. However, it's not necessary to do this if you want to make changes.
If you're thinking of starting your own rebranded fork of Synergy, it might be because we're doing something wrong so please
[let us know](https://github.com/symless/synergy/wiki/Contact-the-team) what we can do to let you feel welcome in our community.
### Is clipboard sharing supported?
Absolutely. The clipboard-sharing feature is a cornerstone feature of the product and we are committed to maintaining and improving that feature.
### Is Wayland for Linux supported?
Yes! Wayland (the Linux display server protocol aimed to become the successor of the X Window System) is an important platform for us.
The [`libei`](https://gitlab.freedesktop.org/libinput/libei) and [`libportal`](https://github.com/flatpak/libportal) libraries enable
Wayland support for Synergy. We would like to give special thanks to Peter Hutterer (@whot), who is the author of `libei`, a major contributor
to `libportal`, and the author of the Wayland implementation in Synergy. Others such as Olivier Fourdan helped with the Wayland implementation,
and we rely on the work of our community of developers to continue the development of Wayland support.
### Where did it all start?
Synergy was first created in 2001. You can learn about the [history of the project](https://github.com/symless/synergy/wiki/History) and its
original creator, Chris Schoeneman, on our Wiki.
## Repology
Repology monitors a huge number of package repositories and other sources comparing package versions across them and gathering other information.
[![Repology](https://repology.org/badge/vertical-allrepos/synergy.svg?exclude_unsupported=1)](https://repology.org/project/synergy/versions)