From 6536f5eb0cdb687d2cb245ac41188642927b812c Mon Sep 17 00:00:00 2001
From: Roy Shilkrot <roy.shil@gmail.com>
Date: Sun, 29 Sep 2024 08:57:38 -0400
Subject: [PATCH 1/4] Refactor: Add support for different HTTP methods in
 update_out_api

---
 api_output.py    | 84 +++++++++++++++++++++++++++++++++++++++---------
 mainwindow.py    |  8 +++++
 mainwindow.ui    | 30 +++++++++++------
 ui_mainwindow.py | 19 ++++++-----
 4 files changed, 108 insertions(+), 33 deletions(-)

diff --git a/api_output.py b/api_output.py
index abc2fe4..7ac0370 100644
--- a/api_output.py
+++ b/api_output.py
@@ -13,6 +13,7 @@
 
 out_api_url = fetch_data("scoresight.json", "out_api_url", None)
 out_api_encoding = fetch_data("scoresight.json", "out_api_encoding", "JSON")
+out_api_method = fetch_data("scoresight.json", "out_api_method", "POST")
 
 
 def is_valid_url_urllib(url):
@@ -33,13 +34,21 @@ def setup_out_api_encoding(encoding):
     out_api_encoding = encoding
 
 
+def setup_out_api_method(method):
+    global out_api_method
+    out_api_method = method
+
+
 subscribe_to_data("scoresight.json", "out_api_url", setup_out_api_url)
 subscribe_to_data("scoresight.json", "out_api_encoding", setup_out_api_encoding)
+subscribe_to_data("scoresight.json", "out_api_method", setup_out_api_method)
 
 
 def update_out_api(data: list[TextDetectionTargetWithResult]):
-    if out_api_url is None or out_api_encoding is None:
-        logger.error(f"Output API not set up: {out_api_url}, {out_api_encoding}")
+    if out_api_url is None or out_api_encoding is None or out_api_method is None:
+        logger.error(
+            f"Output API not set up: {out_api_url}, {out_api_encoding}, {out_api_method}"
+        )
         return
 
     # validate the URL
@@ -51,14 +60,20 @@ def update_out_api(data: list[TextDetectionTargetWithResult]):
 
     def send_data():
         try:
-            if out_api_encoding == "JSON":
-                response = send_json(data)
-            elif out_api_encoding == "XML":
-                response = send_xml(data)
-            elif out_api_encoding == "CSV":
-                response = send_csv(data)
+            if out_api_method == "GET":
+                response = send_get(data)
             else:
-                logger.error("Invalid encoding: %s", out_api_encoding)
+                if out_api_encoding == "JSON":
+                    response = send_json(data)
+                elif out_api_encoding == "XML":
+                    response = send_xml(data)
+                elif out_api_encoding == "CSV":
+                    response = send_csv(data)
+                else:
+                    logger.error("Invalid encoding: %s", out_api_encoding)
+                    return
+
+            if response is None:
                 return
 
             if response.status_code != 200:
@@ -72,13 +87,38 @@ def send_data():
     thread.start()
 
 
+def send_get(data: list[TextDetectionTargetWithResult]):
+    out_api_url_copy = out_api_url
+    # add the data to the URL as query parameters
+    # check if the URL already has query parameters
+    if "?" in out_api_url_copy:
+        out_api_url_copy += "&"
+    else:
+        out_api_url_copy += "?"
+    for i, result in enumerate(data):
+        out_api_url_copy += f"{urlencode(result.name)}={urlencode(result.result)}&"
+    response = requests.get(out_api_url_copy)
+    return response
+
+
 def send_json(data: list[TextDetectionTargetWithResult]):
     headers = {"Content-Type": "application/json"}
-    response = requests.post(
-        out_api_url,
-        headers=headers,
-        data=json.dumps([result.to_dict() for result in data]),
-    )
+    json_data_dump = json.dumps([result.to_dict() for result in data])
+    if out_api_method == "POST":
+        response = requests.post(
+            out_api_url,
+            headers=headers,
+            data=json_data_dump,
+        )
+    elif out_api_method == "PUT":
+        response = requests.put(
+            out_api_url,
+            headers=headers,
+            data=json_data_dump,
+        )
+    else:
+        logger.error(f"Invalid method: {out_api_method}")
+        return None
     return response
 
 
@@ -95,7 +135,13 @@ def send_xml(data: list[TextDetectionTargetWithResult]):
         resultEl.set("width", str(targetWithResult.width()))
         resultEl.set("height", str(targetWithResult.height()))
     xml_data = ET.tostring(root, encoding="utf-8")
-    response = requests.post(out_api_url, headers=headers, data=xml_data)
+    if out_api_method == "POST":
+        response = requests.post(out_api_url, headers=headers, data=xml_data)
+    elif out_api_method == "PUT":
+        response = requests.put(out_api_url, headers=headers, data=xml_data)
+    else:
+        logger.error(f"Invalid method: {out_api_method}")
+        return None
     return response
 
 
@@ -116,5 +162,11 @@ def send_csv(data: list[TextDetectionTargetWithResult]):
                 result.height(),
             ]
         )
-    response = requests.post(out_api_url, headers=headers, data=output.getvalue())
+    if out_api_method == "POST":
+        response = requests.post(out_api_url, headers=headers, data=output.getvalue())
+    elif out_api_method == "PUT":
+        response = requests.put(out_api_url, headers=headers, data=output.getvalue())
+    else:
+        logger.error(f"Invalid method: {out_api_method}")
+        return None
     return response
diff --git a/mainwindow.py b/mainwindow.py
index 89092bc..a0691db 100644
--- a/mainwindow.py
+++ b/mainwindow.py
@@ -227,6 +227,14 @@ def __init__(self, translator: QTranslator, parent: QObject):
                 fetch_data("scoresight.json", "out_api_encoding", "JSON")
             )
         )
+        self.ui.comboBox_outApiMethod.currentTextChanged.connect(
+            partial(self.globalSettingsChanged, "out_api_method")
+        )
+        self.ui.comboBox_outApiMethod.setCurrentIndex(
+            self.ui.comboBox_outApiMethod.findText(
+                fetch_data("scoresight.json", "out_api_method", "POST")
+            )
+        )
 
         self.obs_websocket_client = None
 
diff --git a/mainwindow.ui b/mainwindow.ui
index 647e46c..1c66a64 100644
--- a/mainwindow.ui
+++ b/mainwindow.ui
@@ -1511,16 +1511,28 @@
                </widget>
               </item>
               <item>
-               <widget class="QCheckBox" name="checkBox_is_websocket">
-                <property name="enabled">
-                 <bool>false</bool>
-                </property>
-                <property name="toolTip">
-                 <string>Not implemented yet.</string>
-                </property>
-                <property name="text">
-                 <string>Websocket</string>
+               <widget class="QComboBox" name="comboBox_outApiMethod">
+                <property name="maximumSize">
+                 <size>
+                  <width>50</width>
+                  <height>16777215</height>
+                 </size>
                 </property>
+                <item>
+                 <property name="text">
+                  <string>POST</string>
+                 </property>
+                </item>
+                <item>
+                 <property name="text">
+                  <string>PUT</string>
+                 </property>
+                </item>
+                <item>
+                 <property name="text">
+                  <string>GET</string>
+                 </property>
+                </item>
                </widget>
               </item>
              </layout>
diff --git a/ui_mainwindow.py b/ui_mainwindow.py
index ae9f8c8..af17fbe 100644
--- a/ui_mainwindow.py
+++ b/ui_mainwindow.py
@@ -793,11 +793,14 @@ def setupUi(self, MainWindow):
 
         self.horizontalLayout_27.addWidget(self.lineEdit_api_url)
 
-        self.checkBox_is_websocket = QCheckBox(self.widget_24)
-        self.checkBox_is_websocket.setObjectName(u"checkBox_is_websocket")
-        self.checkBox_is_websocket.setEnabled(False)
+        self.comboBox_outApiMethod = QComboBox(self.widget_24)
+        self.comboBox_outApiMethod.addItem("")
+        self.comboBox_outApiMethod.addItem("")
+        self.comboBox_outApiMethod.addItem("")
+        self.comboBox_outApiMethod.setObjectName(u"comboBox_outApiMethod")
+        self.comboBox_outApiMethod.setMaximumSize(QSize(50, 16777215))
 
-        self.horizontalLayout_27.addWidget(self.checkBox_is_websocket)
+        self.horizontalLayout_27.addWidget(self.comboBox_outApiMethod)
 
 
         self.formLayout_3.setWidget(1, QFormLayout.FieldRole, self.widget_24)
@@ -1228,10 +1231,10 @@ def retranslateUi(self, MainWindow):
         self.comboBox_api_encode.setItemText(2, QCoreApplication.translate("MainWindow", u"CSV", None))
 
         self.lineEdit_api_url.setPlaceholderText(QCoreApplication.translate("MainWindow", u"http://", None))
-#if QT_CONFIG(tooltip)
-        self.checkBox_is_websocket.setToolTip(QCoreApplication.translate("MainWindow", u"Not implemented yet.", None))
-#endif // QT_CONFIG(tooltip)
-        self.checkBox_is_websocket.setText(QCoreApplication.translate("MainWindow", u"Websocket", None))
+        self.comboBox_outApiMethod.setItemText(0, QCoreApplication.translate("MainWindow", u"POST", None))
+        self.comboBox_outApiMethod.setItemText(1, QCoreApplication.translate("MainWindow", u"PUT", None))
+        self.comboBox_outApiMethod.setItemText(2, QCoreApplication.translate("MainWindow", u"GET", None))
+
         self.label_20.setText(QCoreApplication.translate("MainWindow", u"URL", None))
         self.tabWidget_outputs.setTabText(self.tabWidget_outputs.indexOf(self.tab_api), QCoreApplication.translate("MainWindow", u"API", None))
         self.pushButton_stopUpdates.setText(QCoreApplication.translate("MainWindow", u"Stop Updates", None))

From 9b1af82deaa53f1bfcbedf6c4cc34cf206ad58b9 Mon Sep 17 00:00:00 2001
From: Roy Shilkrot <roy.shil@gmail.com>
Date: Sun, 29 Sep 2024 09:11:20 -0400
Subject: [PATCH 2/4] Refactor: Update logging setup and error handling

---
 sc_logging.py | 125 ++++++++++++++++++++++++++++----------------------
 1 file changed, 69 insertions(+), 56 deletions(-)

diff --git a/sc_logging.py b/sc_logging.py
index 09930c0..532267b 100644
--- a/sc_logging.py
+++ b/sc_logging.py
@@ -4,59 +4,72 @@
 from datetime import datetime
 from dotenv import load_dotenv
 
-# Load the environment variables from the .env file
-load_dotenv(os.path.abspath(os.path.join(os.path.dirname(__file__), ".env")))
-
-# Create a logger
-logger = logging.getLogger(__name__)
-logger.setLevel(logging.DEBUG)
-
-# get the user data directory
-data_dir = user_log_dir("scoresight")
-if not os.path.exists(data_dir):
-    os.makedirs(data_dir)
-
-current_time = datetime.now().strftime("%Y-%m-%d_%H-%M-%S")
-
-# basic config - send all logs to a file
-logging.basicConfig(
-    filename=os.path.join(data_dir, f"scoresight_std_{current_time}.log"),
-    level=logging.INFO,
-)
-
-# prepend the user data directory
-log_file_path = os.path.join(data_dir, f"scoresight_{current_time}.log")
-
-# Create a file handler
-file_handler = logging.FileHandler(log_file_path)
-file_handler.setLevel(logging.DEBUG)
-
-# Create a formatter
-formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(module)s - %(message)s")
-file_handler.setFormatter(formatter)
-
-# Add the file handler to the logger
-logger.addHandler(file_handler)
-
-# if the .env file has a debug flag, set the logger to output to console
-if os.getenv("SCORESIGHT_DEBUG"):
-    console_handler = logging.StreamHandler()
-    console_handler.setLevel(logging.DEBUG)
-    console_handler.setFormatter(formatter)
-    logger.addHandler(console_handler)
-    logger.debug("Debug mode enabled")
-
-# check to see if there are more log files, and only keep the most recent 10
-log_files = [
-    f
-    for f in os.listdir(data_dir)
-    if f.startswith("scoresight_") and f.endswith(".log")
-]
-# sort log files by date
-log_files.sort()
-if len(log_files) > 10:
-    for f in log_files[:-10]:
-        try:
-            os.remove(os.path.join(data_dir, f))
-        except PermissionError as e:
-            logger.error(f"Failed to remove log file: {f}")
+
+def setup_logging():
+    # Load the environment variables from the .env file
+    load_dotenv(os.path.abspath(os.path.join(os.path.dirname(__file__), ".env")))
+
+    # Create a logger
+    logger = logging.getLogger(__name__)
+    logger.setLevel(logging.DEBUG)
+
+    # get the user data directory
+    data_dir = user_log_dir("scoresight")
+    if not os.path.exists(data_dir):
+        os.makedirs(data_dir)
+
+    current_time = datetime.now().strftime("%Y-%m-%d_%H-%M-%S")
+
+    # basic config - send all logs to a file
+    logging.basicConfig(
+        filename=os.path.join(data_dir, f"scoresight_std_{current_time}.log"),
+        level=logging.INFO,
+    )
+
+    # prepend the user data directory
+    log_file_path = os.path.join(data_dir, f"scoresight_{current_time}.log")
+
+    # Create a file handler
+    file_handler = logging.FileHandler(log_file_path)
+    file_handler.setLevel(logging.DEBUG)
+
+    # Create a formatter
+    formatter = logging.Formatter(
+        "%(asctime)s - %(levelname)s - %(module)s - %(message)s"
+    )
+    file_handler.setFormatter(formatter)
+
+    # Add the file handler to the logger
+    logger.addHandler(file_handler)
+
+    # if the .env file has a debug flag, set the logger to output to console
+    if os.getenv("SCORESIGHT_DEBUG"):
+        console_handler = logging.StreamHandler()
+        console_handler.setLevel(logging.DEBUG)
+        console_handler.setFormatter(formatter)
+        logger.addHandler(console_handler)
+        logger.debug("Debug mode enabled")
+
+    # check to see if there are more log files, and only keep the most recent 10
+    log_files = [
+        f
+        for f in os.listdir(data_dir)
+        if f.startswith("scoresight_") and f.endswith(".log")
+    ]
+    # sort log files by date
+    log_files.sort()
+    if len(log_files) > 10:
+        for f in log_files[:-10]:
+            try:
+                os.remove(os.path.join(data_dir, f))
+            except PermissionError as e:
+                logger.error(f"Failed to remove log file: {f}")
+
+    return logger, file_handler, log_file_path
+
+
+try:
+    # Create a logger
+    logger, file_handler, log_file_path = setup_logging()
+except Exception as e:
+    print(f"Error setting up logging: {e}")

From df81ecaaa02c9ef27abdeadbd27127da8c3ea525 Mon Sep 17 00:00:00 2001
From: Roy Shilkrot <roy.shil@gmail.com>
Date: Sun, 29 Sep 2024 09:18:16 -0400
Subject: [PATCH 3/4] Refactor: Add support for different HTTP methods in
 out_api.md

---
 docs/image-29.png | Bin 0 -> 14404 bytes
 docs/image-30.png | Bin 0 -> 16504 bytes
 docs/out_api.md   |  52 ++++++++++++++++++++++++++++++++--------------
 3 files changed, 36 insertions(+), 16 deletions(-)
 create mode 100644 docs/image-29.png
 create mode 100644 docs/image-30.png

diff --git a/docs/image-29.png b/docs/image-29.png
new file mode 100644
index 0000000000000000000000000000000000000000..79fbe0672d429ce21a7b1c282cb1412b1eeecde2
GIT binary patch
literal 14404
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
OXsYQxDp9d`|33iyJg)x$

literal 0
HcmV?d00001

diff --git a/docs/image-30.png b/docs/image-30.png
new file mode 100644
index 0000000000000000000000000000000000000000..3296c814e8f606e44b1e24bc25bd4926a5cf4b3b
GIT binary patch
literal 16504
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

literal 0
HcmV?d00001

diff --git a/docs/out_api.md b/docs/out_api.md
index b6392dd..66524fe 100644
--- a/docs/out_api.md
+++ b/docs/out_api.md
@@ -1,4 +1,4 @@
-# ScoreSight Outboud API Integration Tutorial
+# ScoreSight Outbound API Integration Tutorial
 
 ScoreSight now offers the ability to send OCR-extracted scoreboard data to external APIs. This tutorial will guide you through setting up the feature and provide a simple Python script to receive the data.
 
@@ -6,13 +6,15 @@ ScoreSight now offers the ability to send OCR-extracted scoreboard data to exter
 
 1. Open ScoreSight and navigate to the "API" tab in the bottom left corner.
 
-![alt text](image-21.png)
+![alt text](image-29.png)
 
 2. Check the box labeled "Send out API requests to external services".
 3. Enter the URL where you want to send the data in the provided box.
 4. Select the encoding format for the data: JSON, XML, or CSV.
 
-![alt text](image-22.png)
+![alt text](image-30.png)
+
+5. Choose the HTTP method for the API request: POST, PUT, or GET.
 
 ## Troubleshooting
 
@@ -35,13 +37,17 @@ If you encounter issues with the API integration, follow these steps to troubles
 3. Encoding Format:
    - Verify that the encoding format selected in ScoreSight (JSON, XML, or CSV) matches the format your receiving script or API expects.
 
-4. Server Availability and Authentication:
+4. HTTP Method:
+   - Ensure that the selected HTTP method (POST, PUT, or GET) is supported by your receiving API.
+   - Verify that your API is configured to handle the chosen method correctly.
+
+5. Server Availability and Authentication:
    - If using the provided Python script, make sure it's running before attempting to send data from ScoreSight.
    - For external APIs, check if the service is up and accessible.
    - If your external API requires an API key or authentication, ensure these details are correctly included in the URL or headers.
    - If testing locally, check that your firewall isn't blocking the connection.
 
-5. Test with a Simple Server:
+6. Test with a Simple Server:
    - Use the provided Python script below as a test server to isolate whether the issue is with ScoreSight or the receiving end.
 
 If problems persist after trying these steps, consider reaching out to ScoreSight support for further assistance.
@@ -56,16 +62,30 @@ import json
 
 class RequestHandler(BaseHTTPRequestHandler):
     def do_POST(self):
-        content_length = int(self.headers['Content-Length'])
-        post_data = self.rfile.read(content_length)
-        
-        print("Received data:")
-        try:
-            # Assuming JSON format, adjust if using XML or CSV
-            data = json.loads(post_data.decode('utf-8'))
-            print(json.dumps(data, indent=2))
-        except json.JSONDecodeError:
-            print(post_data.decode('utf-8'))
+        self.handle_request()
+
+    def do_PUT(self):
+        self.handle_request()
+
+    def do_GET(self):
+        self.handle_request()
+
+    def handle_request(self):
+        if self.command in ['POST', 'PUT']:
+            content_length = int(self.headers['Content-Length'])
+            post_data = self.rfile.read(content_length)
+            
+            print(f"Received {self.command} data:")
+            try:
+                # Assuming JSON format, adjust if using XML or CSV
+                data = json.loads(post_data.decode('utf-8'))
+                print(json.dumps(data, indent=2))
+            except json.JSONDecodeError:
+                print(post_data.decode('utf-8'))
+        elif self.command == 'GET':
+            print("Received GET request")
+            print(f"Path: {self.path}")
+            print(f"Headers: {self.headers}")
         
         self.send_response(200)
         self.end_headers()
@@ -100,7 +120,7 @@ You may see in the console an output similar to:
 
 ```
 127.0.0.1 - - [nn/nn/nnnn 10:57:03] "POST / HTTP/1.1" 200 -
-Received data: Name,Text,State,X,Y,Width,Height
+Received POST data: Name,Text,State,X,Y,Width,Height
 Time,0:52,SameNoChange,843.656319861826,663.0215827338131,359.13669064748206,207.19424460431662
 Home Score,35,SameNoChange,525.969716884406,638.4370727628325,214.62426933453253,175.27648662320166
 ```

From 031a38cc071f8d202e1ea44853b9692710bc0b81 Mon Sep 17 00:00:00 2001
From: Roy Shilkrot <roy.shil@gmail.com>
Date: Mon, 30 Sep 2024 08:47:11 -0400
Subject: [PATCH 4/4] Refactor: Update API output encoding options

---
 api_output.py    | 19 +++++++++++--------
 docs/out_api.md  |  2 +-
 mainwindow.ui    |  7 ++++++-
 ui_mainwindow.py |  8 +++++---
 4 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/api_output.py b/api_output.py
index 7ac0370..d17724b 100644
--- a/api_output.py
+++ b/api_output.py
@@ -4,7 +4,7 @@
 import io
 from functools import partial
 import xml.etree.ElementTree as ET
-from urllib.parse import urlparse
+from urllib.parse import urlparse, urlencode
 import threading
 
 from sc_logging import logger
@@ -12,7 +12,7 @@
 from storage import fetch_data, subscribe_to_data
 
 out_api_url = fetch_data("scoresight.json", "out_api_url", None)
-out_api_encoding = fetch_data("scoresight.json", "out_api_encoding", "JSON")
+out_api_encoding = fetch_data("scoresight.json", "out_api_encoding", "JSON (Full)")
 out_api_method = fetch_data("scoresight.json", "out_api_method", "POST")
 
 
@@ -63,8 +63,8 @@ def send_data():
             if out_api_method == "GET":
                 response = send_get(data)
             else:
-                if out_api_encoding == "JSON":
-                    response = send_json(data)
+                if out_api_encoding.startswith("JSON"):
+                    response = send_json(data, out_api_encoding)
                 elif out_api_encoding == "XML":
                     response = send_xml(data)
                 elif out_api_encoding == "CSV":
@@ -95,15 +95,18 @@ def send_get(data: list[TextDetectionTargetWithResult]):
         out_api_url_copy += "&"
     else:
         out_api_url_copy += "?"
-    for i, result in enumerate(data):
-        out_api_url_copy += f"{urlencode(result.name)}={urlencode(result.result)}&"
+    out_api_url_copy += urlencode({result.name: result.result for result in data})
+    logger.debug(f"GET URL: {out_api_url_copy}")
     response = requests.get(out_api_url_copy)
     return response
 
 
-def send_json(data: list[TextDetectionTargetWithResult]):
+def send_json(data: list[TextDetectionTargetWithResult], encoding: str):
     headers = {"Content-Type": "application/json"}
-    json_data_dump = json.dumps([result.to_dict() for result in data])
+    if encoding == "JSON (Full)":
+        json_data_dump = json.dumps([result.to_dict() for result in data])
+    elif encoding == "JSON (Simple key-value)":
+        json_data_dump = json.dumps({result.name: result.result for result in data})
     if out_api_method == "POST":
         response = requests.post(
             out_api_url,
diff --git a/docs/out_api.md b/docs/out_api.md
index 66524fe..c642c1c 100644
--- a/docs/out_api.md
+++ b/docs/out_api.md
@@ -10,7 +10,7 @@ ScoreSight now offers the ability to send OCR-extracted scoreboard data to exter
 
 2. Check the box labeled "Send out API requests to external services".
 3. Enter the URL where you want to send the data in the provided box.
-4. Select the encoding format for the data: JSON, XML, or CSV.
+4. Select the encoding format for the data: JSON (Full), Json (Simple key-value) XML, or CSV.
 
 ![alt text](image-30.png)
 
diff --git a/mainwindow.ui b/mainwindow.ui
index 1c66a64..63c3592 100644
--- a/mainwindow.ui
+++ b/mainwindow.ui
@@ -1457,7 +1457,12 @@
             <widget class="QComboBox" name="comboBox_api_encode">
              <item>
               <property name="text">
-               <string>JSON</string>
+               <string>JSON (Full)</string>
+              </property>
+             </item>
+             <item>
+              <property name="text">
+               <string>JSON (Simple key-value)</string>
               </property>
              </item>
              <item>
diff --git a/ui_mainwindow.py b/ui_mainwindow.py
index af17fbe..ced6658 100644
--- a/ui_mainwindow.py
+++ b/ui_mainwindow.py
@@ -774,6 +774,7 @@ def setupUi(self, MainWindow):
         self.comboBox_api_encode.addItem("")
         self.comboBox_api_encode.addItem("")
         self.comboBox_api_encode.addItem("")
+        self.comboBox_api_encode.addItem("")
         self.comboBox_api_encode.setObjectName(u"comboBox_api_encode")
 
         self.formLayout_3.setWidget(4, QFormLayout.FieldRole, self.comboBox_api_encode)
@@ -1226,9 +1227,10 @@ def retranslateUi(self, MainWindow):
         self.tabWidget_outputs.setTabText(self.tabWidget_outputs.indexOf(self.tab_vmix), QCoreApplication.translate("MainWindow", u"VMix", None))
         self.checkBox_enableOutAPI.setText(QCoreApplication.translate("MainWindow", u"Send out API requests to external services.", None))
         self.label_21.setText(QCoreApplication.translate("MainWindow", u"Encode", None))
-        self.comboBox_api_encode.setItemText(0, QCoreApplication.translate("MainWindow", u"JSON", None))
-        self.comboBox_api_encode.setItemText(1, QCoreApplication.translate("MainWindow", u"XML", None))
-        self.comboBox_api_encode.setItemText(2, QCoreApplication.translate("MainWindow", u"CSV", None))
+        self.comboBox_api_encode.setItemText(0, QCoreApplication.translate("MainWindow", u"JSON (Full)", None))
+        self.comboBox_api_encode.setItemText(1, QCoreApplication.translate("MainWindow", u"JSON (Simple key-value)", None))
+        self.comboBox_api_encode.setItemText(2, QCoreApplication.translate("MainWindow", u"XML", None))
+        self.comboBox_api_encode.setItemText(3, QCoreApplication.translate("MainWindow", u"CSV", None))
 
         self.lineEdit_api_url.setPlaceholderText(QCoreApplication.translate("MainWindow", u"http://", None))
         self.comboBox_outApiMethod.setItemText(0, QCoreApplication.translate("MainWindow", u"POST", None))