Beam -> Remote with less restrictions (#1221)

Author: aw-was-here

.github/workflows/testing.yaml

@@ -155,7 +155,7 @@ jobs:
       contents: read
     strategy:
       matrix:
-        python: ["3.11", "3.12"]
+        python: ["3.11", "3.12", "3.13"]
     env:
       DISPLAY: ':99.0'
     steps:

NowPlaying.spec

@@ -107,7 +107,6 @@ block_cipher = None
 
 executables = {
     'NowPlaying': 'nppyi.py',
-    #BEAM    'NowPlayingBeam': 'beam.py',
 }
 
 for execname, execpy in executables.items():

docs/input/remote.md

@@ -0,0 +1,50 @@
+# Remote Services
+
+A common streaming configuration is to have more than one computer
+involved, such as one computer working as the DJ machine and one computer
+for processing the stream.  In some very advanced configurations, there
+might even be more than on DJ on different computers swapping back and
+forth!
+
+**What's Now Playing** supports a configuration where each setup has
+their own app configuration running.  One or more installations on
+DJ computers send the track information to a central one.  That
+central one will then perform any additional lookups and send the
+output to anything configured such as Twitch.
+
+## Settings
+
+* Server Side
+
+1. You will need to enable the web server
+2. Also in webserver, you may optionally set a Secret that is required to be set on any
+   other **What's Now Playing** installation that talks to it
+3. Set the Input to be 'Remote'
+4. It is recommended to enable Artist Extras on the Server
+
+* Client Side
+
+1. Go to 'Remote Output'
+2. Enable it
+3. Set the Server to be either the hostname or IP address of the computer
+   acting as the server
+4. Set the port to be the server's webserver port
+5. If the Server has a Secret set, you will need to set that as well
+
+> NOTE: Some content, such as cover art, will not be sent to the remote server.
+
+## Other Settings
+
+It should be noted that there is no protection against multiple Twitch chat bots,
+multiple Kick bots, etc.  This can result in double posts and other weirdness.
+On the client computers, you will want to turn off such services.  Here is a
+non-complete list of things to check:
+
+* Artist Extras
+* Discord
+* Kick Chat
+* Twitch (Chat and Requests)
+
+Note that Recognition services such as AcoustID support are required to run
+on the client computer as they need access to the local file for those systems
+that provide access to it.

docs/output/webserver.md

@@ -1,6 +1,6 @@
 # Webserver
 
-**What's Now Playing**has a built-in web server that allows for a wide
+**What's Now Playing** has a built-in web server that allows for a wide
 variety of customization and deployments, including complex ones
 involving multiple hosts. Treat the files in`templates` as examples; copy them to new
 names and modify them until you are happy. Change the font, change the

mkdocs.yml

@@ -82,20 +82,22 @@ nav:
       - Filters: settings/filter.md
       - Quirks: settings/quirks.md
   - Input Sources:
-      - Serato: input/serato.md
-      - Traktor: input/traktor.md
-      - Virtual DJ: input/virtualdj.md
       - DJ Uced: input/djuced.md
-      - JRiver: input/jriver.md
       - Icecast: input/icecast.md
+      - JRiver: input/jriver.md
       - M3U: input/m3u.md
       - MPRIS2: input/mpris2.md
+      - Remote: input/remote.md
+      - Serato: input/serato.md
+      - Traktor: input/traktor.md
+      - Virtual DJ: input/virtualdj.md
       - Windows Media: input/winmedia.md
   - Output Destinations:
-      - Text Output: output/textoutput.md
       - Discord: output/discord.md
       - Kick Bot: output/kickbot.md
       - OBS WebSocket: output/obswebsocket.md
+      - Remote: input/remote.md
+      - Text Output: output/textoutput.md
       - Twitch Bot: output/twitchbot.md
       - Web Server: output/webserver.md
   - Recognition:
@@ -104,8 +106,8 @@ nav:
   - Artist Extras:
       - Overview: extras/index.md
       - Discogs: extras/discogs.md
-      - TheAudioDB: extras/theaudiodb.md
       - FanArt.TV: extras/fanarttv.md
+      - TheAudioDB: extras/theaudiodb.md
   - Requests: requests.md
   - Help:
       - How Do I?: help/howdoi.md

nowplaying/__main__.py

@@ -45,7 +45,8 @@ def run_bootstrap(bundledir: str|None = None) -> pathlib.Path:  # pragma: no cov
     return logpath
 
 
-def actualmain(beam: bool = False):  # pragma: no cover
+
+def actualmain():  # pragma: no cover
     ''' main entrypoint '''
 
     multiprocessing.freeze_support()
@@ -77,7 +78,7 @@ def actualmain(beam: bool = False):  # pragma: no cover
             startup_window.update_progress("Starting system tray...")
             qapp.processEvents()
 
-            tray = nowplaying.systemtray.Tray(beam=beam, startup_window=startup_window)  # pylint: disable=unused-variable
+            tray = nowplaying.systemtray.Tray(startup_window=startup_window)  # pylint: disable=unused-variable
             icon = QIcon(str(config.iconfile))
             qapp.setWindowIcon(icon)
 
@@ -95,12 +96,7 @@ def actualmain(beam: bool = False):  # pragma: no cover
 
 def main():  # pragma: no cover
     ''' Normal mode '''
-    actualmain(beam=False)
-
-
-def beammain():  # pragma: no cover
-    ''' beam mode '''
-    actualmain(beam=True)
+    actualmain()
 
 
 if __name__ == '__main__':