## [0.1.17] - 2026-07-19

### Added
- "X-Server-Timestamp" header sends the server time as Unix timestamp so that the frame can use it

Author: fwmone

CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.1.17] - 2026-07-19
+
+### Added
+- "X-Server-Timestamp" header sends the server time as Unix timestamp so that the frame can use it
+
 ## [0.1.16] - 2026-06-21
 
 ### Changed

README.md

@@ -100,7 +100,13 @@ Content-Type: application/json
 }
 ```
 
-For IP-AND-PORT-OF-HOME-ASSISTANT, for example, http://192.168.0.1:8123. The framework then automatically appends the path to the pull service.
+On Windows cmd it looks like this:
+
+```bash
+curl -X PUT "http://{device_ip}/upstream/pull_settings" -H "Content-Type: application/json" -d "{\"upstream_on\":true,\"upstream_url\":\"http://<IP-AND-PORT-OF-HOME-ASSISTANT>\",\"token\":\"<YOUR_TOKEN_HERE>\",\"cron_time\":\"2025-11-01T08:30:00Z\"}"
+```
+
+Use for IP-AND-PORT-OF-HOME-ASSISTANT, for example, http://192.168.0.1:8123. The framework then automatically appends the path to the pull service.
 
 ## Testing
 

custom_components/bloomin8_pull/manifest.json

@@ -1,7 +1,7 @@
 {
   "domain": "bloomin8_pull",
   "name": "BLOOMIN8 Pull Endpoint",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "documentation": "https://github.com/fwmone/bloomin8_pull",
   "issue_tracker": "https://github.com/fwmone/bloomin8_pull/issues",  
   "requirements": [],

custom_components/bloomin8_pull/view.py

@@ -136,6 +136,29 @@ async def choose_varied(hass, files: list[str], store_key: str = "recent_images"
 ALLOWED_EXT = (".jpg",)
 
 
+def _server_timestamp() -> str:
+    """Return the current UTC time as a Unix timestamp in seconds."""
+    return str(int(dt.now(timezone.utc).timestamp()))
+
+
+def json_response_with_timestamp(
+    data: dict,
+    *,
+    status: int = HTTPStatus.OK,
+    **kwargs,
+) -> web.Response:
+    """Create a JSON response including the BLOOMIN8 clock-sync header."""
+    headers = dict(kwargs.pop("headers", {}) or {})
+    headers["X-Server-Timestamp"] = _server_timestamp()
+
+    return web.json_response(
+        data,
+        status=status,
+        headers=headers,
+        **kwargs,
+    )
+
+
 class Bloomin8PullView(HomeAssistantView):
     """Implements GET /eink_pull for BLOOMIN8 devices."""
 
@@ -152,7 +175,7 @@ async def get(self, request: web.Request) -> web.Response:
         token = request.headers.get("X-Access-Token", "")
         expected = self.cfg["access_token"]
         if not expected or token != expected:
-            return web.json_response(
+            return json_response_with_timestamp(
                 {"status": 401, "type": "ERROR", "message": "Unauthorized"},
                 status=HTTPStatus.UNAUTHORIZED,
             )
@@ -213,7 +236,7 @@ async def get(self, request: web.Request) -> web.Response:
             files = []
 
         if not files:
-            return web.json_response(
+            return json_response_with_timestamp(
                 {
                     "status": 204,
                     "message": "No image available",
@@ -253,7 +276,7 @@ async def get(self, request: web.Request) -> web.Response:
                 )
             except Exception as err:
                 _LOGGER.exception("Failed to publish image %s -> %s: %s", src_path, dst_path, err)
-                return web.json_response(
+                return json_response_with_timestamp(
                     {"status": 500, "type": "ERROR", "message": "Failed to publish image"},
                     status=HTTPStatus.INTERNAL_SERVER_ERROR,
                 )
@@ -283,7 +306,7 @@ async def get(self, request: web.Request) -> web.Response:
         except Exception:
             pass        
 
-        return web.json_response(
+        return json_response_with_timestamp(
             {
                 "status": 200,
                 "type": "SHOW",
@@ -312,7 +335,7 @@ async def get(self, request: web.Request) -> web.Response:
         token = request.headers.get("X-Access-Token", "")
         expected = self.cfg["access_token"]
         if not expected or token != expected:
-            return web.json_response(
+            return json_response_with_timestamp(
                 {"status": 401, "type": "ERROR", "message": "Unauthorized"},
                 status=HTTPStatus.UNAUTHORIZED,
             )
@@ -352,7 +375,7 @@ async def get(self, request: web.Request) -> web.Response:
             pull_id, success, request.remote
         )
 
-        return web.json_response(
+        return json_response_with_timestamp(
             {
                 "status": 200,
                 "message": "Feedback recorded"