initial commit.

Author: kbouck

README.md

@@ -1,2 +1,39 @@
 # mediakey-remote
 Forward media key events to remote streaming media control APIs
+
+# install
+
+```bash
+pip install
+
+```
+
+# start/stop
+```
+sudo systemctl start mediakey-remote.service 
+sudo systemctl stop mediakey-remote.service 
+```
+
+# auto-start on boot
+```
+sudo systemctl enable mediakey-remote.service 
+```
+
+# config
+```bash
+/etc/opt/mediakey-remote/config.toml
+```
+
+# logs
+```bash
+/var/opt/mediakey-remote/logs/mediakey-remote.log
+```
+
+# build
+```bash
+# enable your venv
+# pip install keyboard soco pyinstaller
+pyinstaller mediakey-remote.py --onefile
+```
+
+

mediakey-remote-config.toml

@@ -0,0 +1,22 @@
+[global]
+
+
+
+[keys]
+volume_up   = 115
+volume_down = 114
+play_pause  = 164
+next        = 163
+previous    = 165
+
+[sonos]
+vol_step = 1
+vol_init_max = 20       # if higher, lower to this volume before requesting play() 
+                        # this is to avoid scaring the cat when volume is unexpectedly
+                        # high for whatever reason.
+                        # Note: this has no effect on the sonos max volume setting
+
+
+[spotify]
+
+

mediakey-remote.py

@@ -0,0 +1,95 @@
+# TODO 
+# mediakey-remote.py
+#
+# service install scripts
+# - linux
+# - windows
+# - mac
+#
+# externalize config
+# - controller: 
+#
+# - global
+#   - volume step (default: 1)
+#   - refresh
+#
+# - media keys
+#   - lower volume key (default: 114)
+#   - raise volume key (default: 115)
+#
+# - sonos
+#   - scan for controller
+#
+# - spotify
+#   - ...
+
+
+import time
+from threading import Thread
+import keyboard
+import soco
+import toml
+
+
+# load config
+config_path="/home/kbouck/dev/mediakey-remote/mediakey-remote-config.toml"
+config = {} 
+with open(config_path, 'r') as f:
+   config = toml.load(f)
+print("Loaded config from " + config_path)
+
+
+# discover sonos devices on network
+# - todo: error handling
+# - todo: make reconnection loop
+
+#sonos_speakers = soco.discover()
+#if (len(sonos_speakers) > 0):
+#    print("Discovered sonos speakers:")
+#    for speaker in sonos_speakers:
+#        print(speaker.name)
+#else:
+#    # todo - need reconnection loop
+#    system.exit("No sonos speakers discovered") 
+#sonos = sonos_speakers.pop()
+
+
+sonos = soco.discovery.any_soco()
+print("Connected to '" + str(sonos.player_name) + "'")
+
+state = ""
+volume = 0
+volume_step  = config['sonos']['vol_step']
+vol_init_max = config['sonos']['vol_init_max']
+
+def play_pause():
+    global state
+    sonos.pause() if (state == "PLAYING") else sonos.play()
+    transport_info = sonos.get_current_transport_info()
+    state = transport_info['current_transport_state']
+
+def poll_state():
+    global state
+    while True:
+        volume = sonos.volume
+        transport_info = sonos.get_current_transport_info() 
+        state = transport_info['current_transport_state']
+        time.sleep(10)
+     
+
+# map keys to api calls
+keyboard.add_hotkey(config['keys']['volume_down'], lambda: sonos.set_relative_volume(volume_step*-1), trigger_on_release=False)
+keyboard.add_hotkey(config['keys']['volume_up'],   lambda: sonos.set_relative_volume(volume_step),    trigger_on_release=False)
+keyboard.add_hotkey(config['keys']['next'],        lambda: sonos.next(),     trigger_on_release=False)
+keyboard.add_hotkey(config['keys']['previous'],    lambda: sonos.previous(), trigger_on_release=False)
+keyboard.add_hotkey(config['keys']['play_pause'],  lambda: play_pause(),     trigger_on_release=False)
+# todo: mute/seek?
+
+# start state polling thread
+poller = Thread(target=poll_state)
+poller.start()
+
+# block app to wait for keyboard events
+keyboard.wait()
+
+

mediakey-remote.service

@@ -0,0 +1,13 @@
+[Unit]
+Description=mediakey-remote
+After=network.target
+StartLimitIntervalSec=0
+
+[Service]
+Type=simple
+Restart=always
+RestartSec=1
+ExecStart=/home/kbouck/dev/mediakey-remote/dist/mediakey-remote
+
+[Install]
+WantedBy=multi-user.target