.. _contributions:

Community Contributions
=======================

This page lists integrations, addons and packagings of Syncthing created by
the community. Like all documentation pages, it's wiki editable so please do
edit and add your own.

GUI Wrappers
------------

.. _contrib-all:

Cross-platform
~~~~~~~~~~~~~~

-  https://github.com/syncthing/syncthing-gtk
-  https://github.com/alex2108/syncthing-tray (Tray icon only)

Android
~~~~~~~

-  https://github.com/syncthing/syncthing-android

Ubuntu
~~~~~~

-  https://github.com/icaruseffect/syncthing-ubuntu-indicator

.. _contrib-windows:

Windows
~~~~~~~

-  https://github.com/iss0/SyncthingTray

-  https://github.com/bloones/SyncThingWin (Windows service helper and
   tray icon)

-  https://github.com/canton7/SyncTrayzor (Windows host for Syncthing.
   Installer, auto-start, built-in browser, tray icon, folder watcher,
   and more)

OS X
~~~~

-  https://github.com/m0ppers/syncthing-bar (OSX 10.10 only)
-  https://github.com/jerryjacobs/foo-app/releases (OSX 10.9 compatible)

Kindle Touch
~~~~~~~~~~~~

-  https://github.com/gutenye/syncthing-kindle

Packages and Bundlings
----------------------

ArchLinux
~~~~~~~~~

-  https://www.archlinux.org/packages/?name=syncthing
-  https://www.archlinux.org/packages/?name=syncthing-gtk
-  https://aur.archlinux.org/packages/syncthing-inotify
-  https://aur.archlinux.org/packages/syncthing-discosrv

arkOS
~~~~~

Syncthing is included in arkOS, https://arkos.io/.

Debian / Ubuntu
~~~~~~~~~~~~~~~

-  PPA: https://launchpad.net/~ytvwld/+archive/ubuntu/syncthing
-  Syncthing GTK PPA:
   https://launchpad.net/~nilarimogard/+archive/ubuntu/webupd8/
-  https://forum.syncthing.net/t/lxle-a-respin-of-lubuntu-now-has-syncthing-included-by-default/1392

Docker
~~~~~~

-  https://github.com/firecat53/dockerfiles/tree/master/syncthing (runs
   Syncthing and/or builds the binary from source)
-  https://github.com/firecat53/dockerfiles/tree/master/syncthing\_discovery
   (Global announce server in a container)
-  https://github.com/joeybaker/docker-syncthing/ A fully baked docker
   container that allows custom config and will keep your settings and
   data past docker image restarts.

Fedora
~~~~~~

-  https://github.com/thunderbirdtr/syncthing\_rpm (SRPM, binary
   packages coming)

-  https://copr.fedoraproject.org/coprs/tune2fs/syncthing/ (RPMs, based
   on https://github.com/thunderbirdtr/syncthing\_rpm)

Gentoo
~~~~~~

Syncthing is available from the [timboudreau overlay](http://github.com/timboudreau/gentoo), or from [fearedbliss's overlay](https://github.com/fearedbliss/bliss-overlay). These overlays contain the ebuild for building syncthing from source,
installing it, and setting it up as a service that runs on startup.

Install layman if you don't have it already.  Then run

- layman -a timboudreau (or bliss-overlay)
- eix-update
- emerge syncthing

Edit /etc/conf.d/syncthing and set the user who will share files to
your user name.

fearedbliss's overlay compiles syncthing so that it doesn't autoupdate on its own (To ensure updates are stable, and also provides a clean upgrade path via Portage). It also installs the systemd service/user unit files provided by SyncThing.

If you don't have layman installed but are using a relatively new version of Portage (>= 2.2.18), you can integrate these external repositories directly into your normal emerge --sync updates by following the steps here (https://wiki.gentoo.org/wiki//etc/portage/repos.conf#External_Overlay).

FreeBSD
~~~~~~~

-  http://www.freshports.org/net/syncthing/

OpenSUSE
~~~~~~~~

-  http://software.opensuse.org/package/syncthing

Synology NAS
~~~~~~~~~~~~

-  http://packages.synocommunity.com/ Add the URL to Package Center in DSM.
   (NOTE: This page is not readable in your web browser. You can browse
   the files at https://synocommunity.com/packages). Numerous CPU
   architectures are supported. SPK's may be older versions, however you
   can execute a Syncthing version upgrade via Web-GUI after
   installation on Synology device. As Syncthing is marked as beta by
   the SynoCommunity, you need to enable beta-versions in the settings.

QNAP NAS
~~~~~~~~

-  http://forum.qnap.com/viewtopic.php?f=320&t=97035&start=45#p429896
   QPKG (Qnap Package) Available for ALL models x86, x86\_64, Arm (all
   including new models)

Integrations
------------

REST API Bindings
~~~~~~~~~~~~~~~~~

-  Ruby: https://github.com/retgoat/syncthing-ruby
-  Python: https://github.com/blakev/python-syncthing (https://pypi.python.org/pypi/syncthing)

Ports
~~~~~

-  Swift: https://github.com/dapperstout/pulse-swift
-  Java: https://github.com/dapperstout/pulse-java
-  PHP: https://github.com/cebe/pulse-php-discover (Only Discovery so
   far)

Configuration management
~~~~~~~~~~~~~~~~~~~~~~~~

-  SaltStack: https://bitbucket.org/StartledPhoenix/saltstack-syncthing
-  Puppet: https://github.com/whefter/puppet-syncthing
-  Command line interface: https://github.com/syncthing/syncthing-cli