feat: project renaming

Author: kieranmanning

.github/workflows/build-deb.yml

@@ -9,7 +9,7 @@ permissions:
   contents: write
 
 env:
-  PKG_NAME: intercom-client
+  PKG_NAME: splintercom-client
   PKG_ARCH: arm64
   PKG_DEPENDS: "libgstreamer1.0-0, gstreamer1.0-plugins-base, gstreamer1.0-plugins-good, libv4l-0"
 
@@ -95,16 +95,16 @@ jobs:
             main.build/
             main.dist/
             main.onefile-build/
-          key: nuitka-${{ runner.os }}-${{ runner.arch }}-${{ hashFiles('uv.lock', 'main.py', 'intercomclient/**/*.py') }}
+          key: nuitka-${{ runner.os }}-${{ runner.arch }}-${{ hashFiles('uv.lock', 'main.py', 'splintercomclient/**/*.py') }}
 
       - name: Build native binary with Nuitka
         run: >
           uv run python -m nuitka
           --standalone
           --onefile
-          --output-filename=intercom-client
+          --output-filename=splintercom-client
           --output-dir=dist
-          --include-package=intercomclient
+          --include-package=splintercomclient
           --include-package=aiortc
           --include-package=av
           --include-package=cv2
@@ -134,11 +134,11 @@ jobs:
 
           mkdir -p "${PKG_DIR}/usr/local/bin"
           mkdir -p "${PKG_DIR}/lib/systemd/system"
-          mkdir -p "${PKG_DIR}/etc/intercom-client"
+          mkdir -p "${PKG_DIR}/etc/splintercom-client"
           mkdir -p "${PKG_DIR}/DEBIAN"
 
-          cp dist/intercom-client "${PKG_DIR}/usr/local/bin/"
-          chmod 755 "${PKG_DIR}/usr/local/bin/intercom-client"
+          cp dist/splintercom-client "${PKG_DIR}/usr/local/bin/"
+          chmod 755 "${PKG_DIR}/usr/local/bin/splintercom-client"
 
           cat > "${PKG_DIR}/DEBIAN/control" <<EOF
           Package: ${PKG_NAME}
@@ -147,36 +147,36 @@ jobs:
           Priority: optional
           Architecture: ${PKG_ARCH}
           Depends: ${PKG_DEPENDS}
-          Maintainer: Intercom Team
-          Description: Intercom Pi client for WebRTC live streaming
-           Raspberry Pi client that connects to the intercom signaling server
+          Maintainer: Splintercom Team
+          Description: Splintercom Pi client for WebRTC live streaming
+           Raspberry Pi client that connects to the splintercom signaling server
            and streams live video via WebRTC.
           EOF
 
-          cat > "${PKG_DIR}/etc/intercom-client/env" <<EOF
-          # Intercom Client Configuration
+          cat > "${PKG_DIR}/etc/splintercom-client/env" <<EOF
+          # Splintercom Client Configuration
           # Set your environment variables here — these are sourced by the systemd service.
           #
           # OAUTH_CLIENT_ID=your_client_id
           # OAUTH_CLIENT_SECRET=your_client_secret
           # VIDEO_SOURCE=0
-          # TOKEN_FILE_PATH=/home/pi/.config/intercom-client/tokens.json
+          # TOKEN_FILE_PATH=/home/pi/.config/splintercom-client/tokens.json
           # WEBSOCKET_API_BASE_URL=wss://your-server.com/ws/live_stream
           # HTTP_API_BASE_URL=https://your-server.com
           EOF
 
-          cat > "${PKG_DIR}/lib/systemd/system/intercom-client.service" <<EOF
+          cat > "${PKG_DIR}/lib/systemd/system/splintercom-client.service" <<EOF
           [Unit]
-          Description=Intercom Pi Client
+          Description=Splintercom Pi Client
           After=network-online.target
           Wants=network-online.target
 
           [Service]
           Type=simple
           User=pi
           Group=pi
-          EnvironmentFile=-/etc/intercom-client/env
-          ExecStart=/usr/local/bin/intercom-client
+          EnvironmentFile=-/etc/splintercom-client/env
+          ExecStart=/usr/local/bin/splintercom-client
           Restart=on-failure
           RestartSec=10
 
@@ -198,8 +198,8 @@ jobs:
       - name: Upload .deb artifact
         uses: actions/upload-artifact@v4
         with:
-          name: intercom-client-deb
-          path: dist/intercom-client_*.deb
+          name: splintercom-client-deb
+          path: dist/splintercom-client_*.deb
           retention-days: 30
 
       - name: Send CI metrics to Honeycomb

CLAUDE.md

@@ -1,4 +1,4 @@
-# Intercom ClientPython
+# Splintercom ClientPython
 
 Python device client that streams video from a camera to a remote viewer (browser) using WebRTC, authenticated via OAuth 2.0 Device Authorization Grant, with continuous telemetry reporting.
 
@@ -16,7 +16,7 @@ Python device client that streams video from a camera to a remote viewer (browse
 ```
 ClientPython/
 ├── main.py                      # PiClient entry point
-├── intercomclient/
+├── splintercomclient/
 │   ├── config.py                # Config dataclass (env vars)
 │   ├── device_authorization.py  # OAuth device flow functions
 │   ├── token_store.py           # Token persistence (JSON file, 0600 perms)
@@ -28,12 +28,12 @@ ClientPython/
 
 ## Architecture
 
-### Authentication (`intercomclient/device_authorization.py` + `intercomclient/token_store.py`)
+### Authentication (`splintercomclient/device_authorization.py` + `splintercomclient/token_store.py`)
 - **OAuth 2.0 Device Code Grant** (`urn:ietf:params:oauth:grant-type:device_code`)
 - `initiate_device_authorization()` — POSTs to `/oauth/device-authorization/` with device type/OS
 - `poll_for_token()` — Polls `/oauth/token/` with device code until approved (timeout configurable via `MAX_POLLING_TIME_MINS`, default 5 min)
 - `refresh_tokens()` — Refreshes access token using stored refresh token
-- `TokenStore` — Stores access/refresh tokens + `device_code` to JSON file (permissions `0600`) at `~/.config/intercomclient/tokens.json`
+- `TokenStore` — Stores access/refresh tokens + `device_code` to JSON file (permissions `0600`) at `~/.config/splintercomclient/tokens.json`
 
 ### WebRTC Signaling (`main.py` — `PiClient`)
 - Connects to WebSocket signaling server at `{WEBSOCKET_API_BASE_URL}/ws/live_stream/{device_code}/`
@@ -51,7 +51,7 @@ ClientPython/
 - Uses `if pc is not self.pc: return` guard in all event handlers to discard events from replaced PCs
 - Signaling WebSocket is **never** closed by WebRTC state changes — only by unrecoverable signaling errors
 
-### Video Capture (`intercomclient/camera_video_stream_track.py`)
+### Video Capture (`splintercomclient/camera_video_stream_track.py`)
 - `cv2.VideoCapture` can only be opened **once** per process on this hardware. Multi-viewer support is handled by `SharedCameraSource`:
   - Opens the capture device once; runs a `_read_loop` background task that reads frames and fan-outs to per-viewer `asyncio.Queue(maxsize=4)`.
   - Subscribers call `subscribe(key) → Queue` / `unsubscribe(key)`. If a queue is full, the oldest frame is dropped (never blocks the read loop).
@@ -60,7 +60,7 @@ ClientPython/
 - Converts frames to `av.VideoFrame` (BGR24 format) with proper PTS/time_base timestamps.
 - `PiClient._get_or_create_camera_source()` — lazily opens the camera; `_release_camera_if_idle()` — stops and nulls it when `peer_connections` is empty.
 
-### Telemetry (`intercomclient/telemetry.py` — `TelemetryClient`)
+### Telemetry (`splintercomclient/telemetry.py` — `TelemetryClient`)
 - `send(event, message="", level="INFO")` — synchronous; called via `asyncio.to_thread` from async contexts
 - Reads the current access token and `device_code` from `TokenStore` on each call
 - POSTs to `POST /api/v1/devices/{device_code}/telemetry/` with `Authorization: Bearer <token>`
@@ -80,13 +80,13 @@ ClientPython/
 | `disconnected` | `shutdown()` called (SIGINT/SIGTERM) |
 | `heartbeat` | Every 30 seconds from background `_heartbeat_loop` task |
 
-### Configuration (`intercomclient/config.py`)
+### Configuration (`splintercomclient/config.py`)
 - All configurable via environment variables:
   - `HTTP_API_BASE_URL` — Backend API URL (default: `http://backend:8000`)
   - `WEBSOCKET_API_BASE_URL` — WebSocket URL (default: `ws://backend:8000`)
   - `VIDEO_SOURCE` — Camera device index (default: `0`)
-  - `TOKEN_FILE_PATH` — Token file path (default: `~/.config/intercomclient/tokens.json`)
-  - `OAUTH_CLIENT_ID` / `OAUTH_CLIENT_SECRET` — Fallback if `~/.config/intercom-api/oauth.json` not found
+  - `TOKEN_FILE_PATH` — Token file path (default: `~/.config/splintercomclient/tokens.json`)
+  - `OAUTH_CLIENT_ID` / `OAUTH_CLIENT_SECRET` — Fallback if `~/.config/splintercom-api/oauth.json` not found
   - `MAX_POLLING_TIME_MINS` — Device auth polling timeout (default: `5`)
 - Defaults: 320×240 resolution, 5 fps
 
@@ -119,8 +119,8 @@ devices:
 `clientpython` depends on `utility` (healthy) — ensures device registration and token writing complete before the client starts.
 
 ### Shared Volumes
-- `device_oauth_config` — OAuth credentials from `utility` (`~/.config/intercom-api/oauth.json`)
-- `client_tokens` — Token file shared with `utility` (`~/.config/intercomclient/tokens.json`)
+- `device_oauth_config` — OAuth credentials from `utility` (`~/.config/splintercom-api/oauth.json`)
+- `client_tokens` — Token file shared with `utility` (`~/.config/splintercomclient/tokens.json`)
 
 ## Environment Variables
 
@@ -129,7 +129,7 @@ devices:
 | `HTTP_API_BASE_URL` | `http://backend:8000` | Backend API base URL |
 | `WEBSOCKET_API_BASE_URL` | `ws://backend:8000` | WebSocket base URL |
 | `VIDEO_SOURCE` | `0` | Camera device index |
-| `TOKEN_FILE_PATH` | `~/.config/intercomclient/tokens.json` | Token storage path |
+| `TOKEN_FILE_PATH` | `~/.config/splintercomclient/tokens.json` | Token storage path |
 | `OAUTH_CLIENT_ID` | from `oauth.json` | OAuth client ID |
 | `OAUTH_CLIENT_SECRET` | from `oauth.json` | OAuth client secret |
 | `MAX_POLLING_TIME_MINS` | `5` | Device auth polling timeout |

Dockerfile

@@ -1,4 +1,4 @@
-# Production Dockerfile for Intercom ClientPython
+# Production Dockerfile for Splintercom ClientPython
 # Multi-stage: build deps → slim runtime image
 # Target: ARM64 (Raspberry Pi)
 

README.md

@@ -1,6 +1,6 @@
-# Intercom Python Client
+# Splintercom Python Client
 
-Python device client that authenticates via OAuth2 device flow, streams camera video over WebRTC, and sends telemetry to the Intercom API.
+Python device client that authenticates via OAuth2 device flow, streams camera video over WebRTC, and sends telemetry to the Splintercom API.
 
 ## Tech Stack
 
@@ -39,11 +39,11 @@ Both workflows send a structured event to Honeycomb (`github-actions` dataset) a
 ## Installation on Raspberry Pi (from .deb)
 
 ```bash
-sudo dpkg -i intercom-client_<version>_arm64.deb
+sudo dpkg -i splintercom-client_<version>_arm64.deb
 
 # Configure
-sudo nano /etc/intercom-client/env
+sudo nano /etc/splintercom-client/env
 
 # Enable and start
-sudo systemctl enable --now intercom-client
+sudo systemctl enable --now splintercom-client
 ```

VERSION

@@ -1 +1 @@
-0.0.0+alpha-master-34
+0.0.0+alpha-master-35

main.py

@@ -14,20 +14,20 @@
 from aiortc.sdp import candidate_from_sdp
 from requests import HTTPError
 
-from intercomclient.camera_video_stream_track import (
+from splintercomclient.camera_video_stream_track import (
     CameraVideoStreamTrack,
     SharedCameraSource,
 )
-from intercomclient.config import Config
-from intercomclient.device_authorization import (
+from splintercomclient.config import Config
+from splintercomclient.device_authorization import (
     initiate_device_authorization,
     poll_for_token,
     refresh_tokens,
 )
-from intercomclient.otel import setup_telemetry
-from intercomclient.telemetry import TelemetryClient
-from intercomclient.token_store import TokenStatus, TokenStore
-from intercomclient.turn import fetch_turn_credentials
+from splintercomclient.otel import setup_telemetry
+from splintercomclient.telemetry import TelemetryClient
+from splintercomclient.token_store import TokenStatus, TokenStore
+from splintercomclient.turn import fetch_turn_credentials
 
 logging.basicConfig(level=logging.INFO)
 LOG = logging.getLogger("pi-client")
@@ -377,7 +377,7 @@ async def shutdown(self):
 
 
 async def main():
-    setup_telemetry("intercom-pi-client")
+    setup_telemetry("splintercom-pi-client")
     config = Config()
     client = PiClient(config)
 

pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "intercomclientpython"
+name = "splintercomclientpython"
 version = "0.4.0"
 description = "Add your description here"
 readme = "README.md"

intercomclient/__init__.py splintercomclient/__init__.pyintercomclient/__init__.py renamed to splintercomclient/__init__.py

@@ -5,7 +5,7 @@
 import cv2
 from aiortc import VideoStreamTrack
 
-from intercomclient.config import Config
+from splintercomclient.config import Config
 
 LOG = logging.getLogger(__name__)
 

…ercomclient/camera_video_stream_track.py …ercomclient/camera_video_stream_track.pyintercomclient/camera_video_stream_track.py renamed to splintercomclient/camera_video_stream_track.py intercomclient/camera_video_stream_track.py renamed to splintercomclient/camera_video_stream_track.py

@@ -7,8 +7,8 @@
 
 
 def load_oauth_credentials():
-    """Load OAuth credentials from ~/.config/intercom-api/oauth.json"""
-    config_file = Path("~/.config/intercom-api/oauth.json").expanduser()
+    """Load OAuth credentials from ~/.config/splintercom-api/oauth.json"""
+    config_file = Path("~/.config/splintercom-api/oauth.json").expanduser()
 
     if config_file.exists():
         with open(config_file, "r") as f:
@@ -28,15 +28,15 @@ class Config:
     resolution: Tuple[int, int] = (320, 240)
     debug_mode: bool = True
     video_source: int = int(os.getenv("VIDEO_SOURCE", 0))
-    output_dir_path: str = "/tmp/intercom_videos"
+    output_dir_path: str = "/tmp/splintercom_videos"
     fourcc: str = "XVID"
     video_format: str = "avi"
     oauth_scope: str = "openid email profile"
     oauth_grant: str = "urn:ietf:params:oauth:grant-type:device_code"
     oauth_client_id: str = load_oauth_credentials()[0]
     oauth_client_secret: str = load_oauth_credentials()[1]
     token_file_path: Path = Path(
-        os.getenv("TOKEN_FILE_PATH", "~/.config/intercomclient/tokens.json")
+        os.getenv("TOKEN_FILE_PATH", "~/.config/splintercomclient/tokens.json")
     ).expanduser()
     http_api_base_url: str = os.getenv("HTTP_API_BASE_URL", "wrong")
     websocket_api_base_url: str = os.getenv("WEBSOCKET_API_BASE_URL", "wrong")