CEXT-Dan · gswifort · May 17, 2025 · May 17, 2025
diff --git a/pyrx/_host_init.py b/pyrx/_host_init.py
@@ -104,7 +104,11 @@ def main() -> None:
     # load pyrx onload files
     pyrx_onload()
     # pyrx_settings can be modified by onload file so there is getting it again
-    # pyrx_settings = get_pyrx_settings()  # uncomment when needed
+    pyrx_settings = get_pyrx_settings()
+    if (title := pyrx_settings.top_window_title) is not None:
+        from pyrx.utils.wx import set_top_window_title
+
+        set_top_window_title(title)
     # load REPLs
     import pyrx._commands  # noqa: F401
     import pyrx.repl.repl_cmds  # noqa: F401

diff --git a/pyrx/config.py b/pyrx/config.py
@@ -35,9 +35,13 @@ def _read_file(self, file_path) -> dict[str, t.Any]:
 
 
 class PyRxSettings(BaseSettings):
+    # [system]
+    optimization_level: int = 2
+
+    # [user]
     disable_onload: bool = False
     onload_path: Path | None = None
-    optimization_level: int = 2
+    top_window_title: str | None = None
 
     model_config = SettingsConfigDict(env_prefix="PYRX_", extra="ignore")
 

diff --git a/pyrx/pyrx.toml b/pyrx/pyrx.toml
@@ -4,3 +4,4 @@ optimization_level = 2
 [user]
 disable_onload = false
 onload_path = ''
+top_window_title = 'My PyRx App'
diff --git a/pyrx/utils/wx.py b/pyrx/utils/wx.py
@@ -1,5 +1,11 @@
 from wx.lib.mixins.inspection import InspectionTool
 
+from pyrx import Ap
+
 
 def show_inspection_frame():
     InspectionTool().Show()
+
+
+def set_top_window_title(title: str):
+    Ap.Application.wxApp().TopWindow.SetTitle(title)
diff --git a/tests/test_utils/test_wx.py b/tests/test_utils/test_wx.py
@@ -0,0 +1,29 @@
+import re
+
+import pytest
+import wx
+
+from pyrx.utils.wx import set_top_window_title
+
+TITLE_PATTERN = re.compile(r"(.*) - \[[^\[\]]+\]")
+
+
+@pytest.fixture
+def setup_test_set_top_window_title():
+    window = wx.GetApp().TopWindow
+    full_title = window.Title
+    m = TITLE_PATTERN.match(full_title)
+    assert m is not None, f"Window title does not match expected pattern: {full_title}"
+    title = m.group(1)
+    yield
+    window.Title = title
+
+
+def test_set_top_window_title(setup_test_set_top_window_title):
+    test_title = "Test Title"
+    set_top_window_title(test_title)
+    # host automatically adds the name of the current document
+    full_title = wx.GetApp().TopWindow.Title
+    m = TITLE_PATTERN.match(full_title)
+    assert m is not None, f"Window title does not match expected pattern: {full_title}"
+    assert m.group(1) == test_title, f"Window title does not match expected title: {full_title}"