[ClementineRemote] Initial contribution

CODEOWNERS

@@ -56,6 +56,7 @@
 /bundles/org.openhab.binding.caddx/ @jossuar
 /bundles/org.openhab.binding.cbus/ @jpharvey
 /bundles/org.openhab.binding.chromecast/ @kaikreuzer
+/bundles/org.openhab.binding.clementineremote/ @StephanRichter
 /bundles/org.openhab.binding.cm11a/ @BobRak
 /bundles/org.openhab.binding.comfoair/ @boehan
 /bundles/org.openhab.binding.coolmasternet/ @projectgus

bom/openhab-addons/pom.xml

@@ -271,6 +271,11 @@
       <artifactId>org.openhab.binding.chromecast</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.clementineremote</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.cm11a</artifactId>

bundles/org.openhab.binding.clementineremote/NOTICE

@@ -0,0 +1,23 @@
+This content is produced and maintained by the openHAB project.
+
+* Project home: https://www.openhab.org
+
+== Declared Project Licenses
+
+This program and the accompanying materials are made available under the terms
+of the Eclipse Public License 2.0 which is available at
+https://www.eclipse.org/legal/epl-2.0/.
+
+The included protobuf definition file emerged from the Clementine-Player Android-Remote project
+and is licensed under the Apache License, Version 2.0.
+
+The file src/main/java/de/qspool/clementineremote/backend/pb/ClementineRemote.java is generated from the
+protocol buffers description files using Googles `protoc`.
+
+Usage of protocol buffers within this project is limited to the inclusion of the com.google.protobuf library.
+
+Protoc is *not* part of this project.
+
+== Source Code
+
+https://github.com/openhab/openhab-addons

bundles/org.openhab.binding.clementineremote/README.md

@@ -0,0 +1,83 @@
+# Clementine Remote Binding
+
+<img style="float: right; margin: 0 0 5px 5px" src="doc/screenshot.png" alt="Screenshot" />
+This binding brings the benefits of over-the-network control of the [Clementine-Player] to openHAB!
+
+It allows control of playback, position and volume and allows display of various title information:
+
+* Artist
+* Album
+* Title
+* current position within track
+* Album cover
+
+## Discovery
+
+This thing does not provide auto-discovery.
+You will have to manually configure clementine to allow remote connections.
+
+Detailed instructions how to configure Clementine's remote functions are provided here:
+
+https://github.com/clementine-player/Android-Remote/wiki/How-to-use-the-Android-Remote
+
+And you will have to manually configure the Thing instances to talk to your player:
+
+## Thing Configuration
+
+Configuring the connection to Clementine is quite easy:
+
+Normally you only need to set the hostname your Clementine player is running at.
+If you set a password in the Clementine configuration, you will have to provide it to the configuration, too.
+
+| Name     | Type    | Description                                                       | Default | Required | Advanced |
+|----------|---------|-------------------------------------------------------------------|---------|----------|----------|
+| hostname | text    | Hostname or IP address of the device                              | N/A     | yes      | no       |
+| password | text    | Password to access the device                                     | N/A     | no       | no       |
+| port     | integer | Port at which Clementine is listening for remote control commands | 5500    | yes      | no       |
+
+## Channels
+
+The binding provides the following channels:
+
+| Channel          | Type        | Read/Write  | Description                                  |
+|------------------|-------------|-------------|----------------------------------------------|
+| album            | String      | read-only   | Album the currently playing song belongs to  |
+| artist           | String      | read-only   | Artist of the currently playing title        |
+| cover            | Image       | read-only   | Cover of the current album                   |
+| playback-control | String      | read/write  | Common control of playback and position      |
+| position         | Number:Time | read-only   | Current position within the playing track    |
+| state            | String      | read-only   | Current state of Clementine player           |
+| title            | String      | read-only   | Name of the currently playing track          |
+| track            | String      | read-only   | Number of the title within the current album |
+| volume-control   | Dommer      | read/write  | Playback volume                              |
+
+
+
+## Full Example
+
+### Thing
+
+#### YAML
+```yaml
+UID: clementineremote:clementine:myplayer
+label: "Music Player"
+thingTypeUID: clementineremote:clementine
+configuration:
+  port: 5500
+  hostname: 192.168.1.158
+  authCode: 123456
+```
+
+#### demo.things:
+
+```
+Thing clementineremote:clementine:myplayer "Music Player" @ "Living Room" [ hostname="192.168.1.158", authCode="12345", port="5500" ]
+```
+
+### Widget
+
+You may find a nice widget to use with this plugin at [Widget.md]
+
+[Clementine-Player]: https://www.clementine-player.org/
+[Links]: doc/useful%20links.md
+[Widget.md]: Widget.md

bundles/org.openhab.binding.clementineremote/pom.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>org.openhab.addons.bundles</groupId>
+    <artifactId>org.openhab.addons.reactor.bundles</artifactId>
+    <version>4.0.0-SNAPSHOT</version>
+  </parent>
+
+  <artifactId>org.openhab.binding.clementineremote</artifactId>
+
+  <name>openHAB Add-ons :: Bundles :: Clementine Remote Binding</name>
+
+  <dependencies>
+    <dependency>
+      <groupId>com.google.protobuf</groupId>
+      <artifactId>protobuf-java</artifactId>
+      <version>3.15.8</version>
+    </dependency>
+  </dependencies>
+</project>