refactor: Use unique device name prefix for pairing

Relates to unfoldedcircle/feature-and-bug-tracker#362

CHANGELOG.md

@@ -9,6 +9,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 _Changes in the next release_
 
+### Changed
+- Use unique device name prefix for pairing to easily identify paired devices on Apple TV ([feature-and-bug-tracker#362](https://github.com/unfoldedcircle/feature-and-bug-tracker/issues/362)).
+
 ---
 
 ## v0.13.7 - 2024-03-18

README.md

@@ -56,7 +56,7 @@ For running a separate integration driver on your network for Remote Two, the co
 ### Run
 
 ```shell
-python3 intg-appletv/driver.py
+UC_CONFIG_HOME=./ python3 intg-appletv/driver.py
 ```
 
 See available [environment variables](https://github.com/unfoldedcircle/integration-python-library#environment-variables)
@@ -65,6 +65,8 @@ in the Python integration library to control certain runtime features like liste
 The configuration file is loaded & saved from the path specified in the environment variable `UC_CONFIG_HOME`.
 Otherwise, the `HOME` path is used or the working directory as fallback.
 
+The client name prefix used for pairing can be set in ENV variable `UC_CLIENT_NAME`. The hostname is used by default.
+
 ## Build self-contained binary
 
 After some tests, turns out python stuff on embedded is a nightmare. So we're better off creating a single binary file

intg-appletv/setup_flow.py

@@ -7,6 +7,8 @@
 
 import asyncio
 import logging
+import os
+import socket
 from enum import IntEnum
 
 import config
@@ -384,7 +386,8 @@ async def _handle_device_choice(msg: UserDataResponse) -> RequestUserInput | Set
     _LOG.debug("Pairing process begin")
     # Hook up to signals
     # TODO error conditions in start_pairing?
-    res = await _pairing_apple_tv.start_pairing(pyatv.const.Protocol.AirPlay, "Remote Two Airplay")
+    name = os.getenv("UC_CLIENT_NAME", socket.gethostname().split(".", 1)[0])
+    res = await _pairing_apple_tv.start_pairing(pyatv.const.Protocol.AirPlay, f"{name} Airplay")
     if res is None:
         return SetupError()
 
@@ -439,7 +442,8 @@ async def _handle_user_data_airplay_pin(msg: UserDataResponse) -> RequestUserInp
     _pairing_apple_tv.add_credentials(c)
 
     # Start new pairing process
-    res = await _pairing_apple_tv.start_pairing(pyatv.const.Protocol.Companion, "Remote Two Companion")
+    name = os.getenv("UC_CLIENT_NAME", socket.gethostname().split(".", 1)[0])
+    res = await _pairing_apple_tv.start_pairing(pyatv.const.Protocol.Companion, f"{name} Companion")
     if res is None:
         return SetupError()