From aa93458ed390385e319d6439c733bf9b540cf3b9 Mon Sep 17 00:00:00 2001
From: Broque Thomas <26755000+Nezreka@users.noreply.github.com>
Date: Mon, 9 Mar 2026 20:52:33 -0700
Subject: [PATCH] Configurable ListenBrainz API endpoint for self-hosted
 instances

---
 config/settings.py          |  1 +
 core/listenbrainz_client.py | 10 +++++++++-
 web_server.py               |  9 ++++++++-
 webui/index.html            |  6 ++++++
 webui/static/script.js      |  2 ++
 5 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/config/settings.py b/config/settings.py
index 12ecd126..5c1e83db 100644
--- a/config/settings.py
+++ b/config/settings.py
@@ -202,6 +202,7 @@ class ConfigManager:
                 }
             },
             "listenbrainz": {
+                "base_url": "",
                 "token": ""
             },
             "acoustid": {
diff --git a/core/listenbrainz_client.py b/core/listenbrainz_client.py
index 389496f7..bf274e21 100644
--- a/core/listenbrainz_client.py
+++ b/core/listenbrainz_client.py
@@ -10,7 +10,15 @@ class ListenBrainzClient:
     """Client for interacting with ListenBrainz API"""
 
     def __init__(self):
-        self.base_url = "https://api.listenbrainz.org/1"
+        custom_url = config_manager.get("listenbrainz.base_url", "")
+        if custom_url:
+            # Strip trailing slashes and ensure /1 API version suffix
+            custom_url = custom_url.rstrip('/')
+            if not custom_url.endswith('/1'):
+                custom_url += '/1'
+            self.base_url = custom_url
+        else:
+            self.base_url = "https://api.listenbrainz.org/1"
         self.token = config_manager.get("listenbrainz.token", "")
         self.username = None
 
diff --git a/web_server.py b/web_server.py
index 9b982d11..0376bcbd 100644
--- a/web_server.py
+++ b/web_server.py
@@ -3128,7 +3128,14 @@ def run_service_test(service, test_config):
 
             try:
                 # Test ListenBrainz API by validating the token
-                url = "https://api.listenbrainz.org/1/validate-token"
+                custom_base = test_config.get('base_url', '').rstrip('/')
+                if custom_base:
+                    if not custom_base.endswith('/1'):
+                        custom_base += '/1'
+                    lb_api_base = custom_base
+                else:
+                    lb_api_base = "https://api.listenbrainz.org/1"
+                url = f"{lb_api_base}/validate-token"
                 headers = {
                     'Authorization': f'Token {token}'
                 }
diff --git a/webui/index.html b/webui/index.html
index 9e07ccb1..cb8a4cdb 100644
--- a/webui/index.html
+++ b/webui/index.html
@@ -3105,6 +3105,11 @@
                                 <!-- ListenBrainz Settings -->
                                 <div class="api-service-frame">
                                     <h4 class="service-title listenbrainz-title">ListenBrainz</h4>
+                                    <div class="form-group">
+                                        <label>API Base URL:</label>
+                                        <input type="text" id="listenbrainz-base-url"
+                                            placeholder="Leave empty for official (api.listenbrainz.org)">
+                                    </div>
                                     <div class="form-group">
                                         <label>User Token:</label>
                                         <input type="password" id="listenbrainz-token"
@@ -3114,6 +3119,7 @@
                                         <div class="callback-help">Get your token from <a
                                                 href="https://listenbrainz.org/profile/" target="_blank"
                                                 style="color: #eb743b;">ListenBrainz Settings</a></div>
+                                        <div class="callback-help">Self-hosted? Enter your server URL (e.g. http://localhost:8093)</div>
                                     </div>
                                 </div>
 
diff --git a/webui/static/script.js b/webui/static/script.js
index 2bc18a36..885d396e 100644
--- a/webui/static/script.js
+++ b/webui/static/script.js
@@ -3898,6 +3898,7 @@ async function loadSettingsData() {
         document.getElementById('soulseek-search-timeout-buffer').value = settings.soulseek?.search_timeout_buffer || 15;
 
         // Populate ListenBrainz settings
+        document.getElementById('listenbrainz-base-url').value = settings.listenbrainz?.base_url || '';
         document.getElementById('listenbrainz-token').value = settings.listenbrainz?.token || '';
 
         // Populate AcoustID settings
@@ -4607,6 +4608,7 @@ async function saveSettings(quiet = false) {
             search_timeout_buffer: parseInt(document.getElementById('soulseek-search-timeout-buffer').value) || 15
         },
         listenbrainz: {
+            base_url: document.getElementById('listenbrainz-base-url').value,
             token: document.getElementById('listenbrainz-token').value
         },
         acoustid: {