From 16d9a4d10c1871116f053ff852882305c568be1d Mon Sep 17 00:00:00 2001
From: AppleTheGolden <scotsbox@protonmail.com>
Date: Tue, 9 Sep 2025 00:26:18 +0200
Subject: [PATCH] Initial OPDS support

---
 copyparty/httpcli.py     | 64 ++++++++++++++++++++++++++++++++++++++--
 copyparty/httpsrv.py     |  1 +
 copyparty/web/opds1.html | 31 +++++++++++++++++++
 3 files changed, 94 insertions(+), 2 deletions(-)
 create mode 100644 copyparty/web/opds1.html

diff --git a/copyparty/httpcli.py b/copyparty/httpcli.py
index 26b85a18..3746bc93 100644
--- a/copyparty/httpcli.py
+++ b/copyparty/httpcli.py
@@ -4012,6 +4012,10 @@ class HttpCli(object):
             raise Pebkac(403, t)
         return ""
 
+    def _can_opds(self, volflags: dict[str, Any]) -> str:
+        # TODO: Permissions
+        return ""
+
     def tx_res(self, req_path: str) -> bool:
         status = 200
         logmsg = "{:4} {} ".format("", self.req)
@@ -6221,7 +6225,7 @@ class HttpCli(object):
 
         add_og = "og" in vn.flags
         if add_og:
-            if "th" in self.uparam or "raw" in self.uparam:
+            if "th" in self.uparam or "raw" in self.uparam or "opds1" in self.uparam:
                 add_og = False
             elif vn.flags["og_ua"]:
                 add_og = vn.flags["og_ua"].search(self.ua)
@@ -6432,9 +6436,17 @@ class HttpCli(object):
             is_ls = True
 
         tpl = "browser"
+        is_opds = False
         if "b" in self.uparam:
             tpl = "browser2"
             is_js = False
+        elif "opds1" in self.uparam:
+            # Display directory listing as OPDS v1.2 catalog feed
+            # TODO: Permissions
+            # TODO: Server Config
+            is_opds = True
+            tpl = "opds1"
+            is_js = False
 
         vf = vn.flags
         ls_ret = {
@@ -6646,6 +6658,43 @@ class HttpCli(object):
             else:
                 href = quotep(href)
 
+            mime = None
+            if is_opds:
+                href += "&" if "?" in href else "?"
+                href += "opds1"
+                if not is_dir:
+                    if "rmagic" in self.vn.flags:
+                        mime = guess_mime(fn, fspath)
+                    else:
+                        mime = guess_mime(fn)
+                    # Make sure we can actually generate JPEG thumbnails
+                    if (
+                        self.args.th_no_jpg
+                        or not self.thumbcli
+                        or "dthumb" in dbv.flags
+                        or "dithumb" in dbv.flags
+                    ):
+                        jpeg_thumb_href = None
+                        jpeg_thumb_href_hires = None
+                    else:
+                        jpeg_thumb_href = href + "&th=jf"
+                        jpeg_thumb_href_hires = jpeg_thumb_href + "3"
+
+                iso8601 = "%04d-%02d-%02dT%02d:%02d:%02dZ" % (
+                    zd.year,
+                    zd.month,
+                    zd.day,
+                    zd.hour,
+                    zd.minute,
+                    zd.second,
+                )
+
+            else:
+                mime = None
+                iso8601 = None
+                jpeg_thumb_href = None
+                jpeg_thumb_href_hires = None
+
             item = {
                 "lead": margin,
                 "href": href,
@@ -6653,7 +6702,11 @@ class HttpCli(object):
                 "sz": sz,
                 "ext": ext,
                 "dt": dt,
+                "iso8601": iso8601,
                 "ts": int(linf.st_mtime),
+                "mime": mime,
+                "jpeg_thumb_href": jpeg_thumb_href,
+                "jpeg_thumb_href_hires": jpeg_thumb_href_hires,
             }
             if is_dir:
                 dirs.append(item)
@@ -6842,6 +6895,9 @@ class HttpCli(object):
                 "taglist": taglist,
             }
             j2a["files"] = []
+        elif is_opds:
+            j2a["files"] = files
+            j2a["dirs"] = dirs
         else:
             j2a["files"] = dirs + files
 
@@ -6992,5 +7048,9 @@ class HttpCli(object):
                 self.html_head = zs.replace("\n\n", "\n")
 
         html = self.j2s(tpl, **j2a)
-        self.reply(html.encode("utf-8", "replace"))
+        if is_opds:
+            mime = "application/atom+xml;profile=opds-catalog"
+        else:
+            mime = None
+        self.reply(html.encode("utf-8", "replace"), mime=mime)
         return True
diff --git a/copyparty/httpsrv.py b/copyparty/httpsrv.py
index 8e4e4a4e..6fcb99e1 100644
--- a/copyparty/httpsrv.py
+++ b/copyparty/httpsrv.py
@@ -185,6 +185,7 @@ class HttpSrv(object):
             "shares",
             "splash",
             "svcs",
+            "opds1",  # TODO: not actually html
         ]
         self.j2 = {x: env.get_template(x + ".html") for x in jn}
         self.prism = has_resource(self.E, "web/deps/prism.js.gz")
diff --git a/copyparty/web/opds1.html b/copyparty/web/opds1.html
new file mode 100644
index 00000000..e4894e18
--- /dev/null
+++ b/copyparty/web/opds1.html
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+    {%- for d in dirs %}
+    <entry>
+        <title>{{ d.name }}</title>
+        <link rel="subsection"
+        href="{{ d.href | e}}"
+        type="application/atom+xml;profile=opds-catalog"/>
+        <updated>{{ d.iso8601 }}</updated>
+    </entry>
+    {%- endfor %}
+    {%- for f in files %}
+    <entry>
+        <title>{{ f.name }}</title>
+        <updated>{{ f.iso8601 }}</updated>
+        <link rel="http://opds-spec.org/acquisition"
+        href="{{ f.href | e }}"
+        type="{{ f.mime }}"/>
+        {%- if f.jpeg_thumb_href != None %}
+        <link rel="http://opds-spec.org/image/thumbnail"
+        href="{{ f.jpeg_thumb_href | e }}"
+        type="image/jpeg"/>
+        {%- endif %}
+        {%- if f.jpeg_thumb_href_hires != None %}
+        <link rel="http://opds-spec.org/image"
+        href="{{ f.jpeg_thumb_href_hires | e }}"
+        type="image/jpeg"/>
+        {%- endif %}
+    </entry>
+    {%- endfor %}
+</feed>
\ No newline at end of file