Merge pull request #1564 from vigstudio/feature/vietnamese-i18n

Improve Vietnamese language pack with bundled fonts and i18n infrastructure

Author: chrisj951

App/PyUI/fonts/BeVietnamPro-Regular.ttf

@@ -0,0 +1,16 @@
+# PyUI bundled fonts
+
+Fonts in this folder can be referenced from language packs via the `fonts` object in `App/PyUI/lang/<Language>.json`.
+
+## Vietnamese (`Vietnamese.json`)
+
+- **Be Vietnam Pro** — menus, lists, grid, and shadowed text (supports Vietnamese diacritics)
+
+## Files
+
+| File | Use |
+|------|-----|
+| `BeVietnamPro-Regular.ttf` | Body text, menus, lists, grid |
+| `BeVietnamPro-SemiBold.ttf` | Shadowed / emphasized text |
+
+License text: `Licenses/fonts/bevietnampro.txt`

App/PyUI/fonts/BeVietnamPro-SemiBold.ttf

@@ -9,6 +9,7 @@
 from pathlib import Path
 from audio.audio_player_none import AudioPlayerNone
 from controller.controller_inputs import ControllerInput
+from menus.language.language import Language
 from devices.abstract_device import AbstractDevice
 from devices.miyoo.device_user_config import DeviceUserConfig
 from devices.utils.process_runner import ProcessRunner
@@ -38,11 +39,11 @@ def prompt_power_down(self):
         while(True):
             PyUiLogger.get_logger().info("Prompting for shutdown")
             Display.clear("Power")
-            Display.render_text_centered(f"Would you like to power down?",self.screen_width()//2, self.screen_height()//2,Theme.text_color(FontPurpose.LIST), purpose=FontPurpose.LIST)
+            Display.render_text_centered(Language.label("powerDownPrompt", "Would you like to power down?"),self.screen_width()//2, self.screen_height()//2,Theme.text_color(FontPurpose.LIST), purpose=FontPurpose.LIST)
             if(self.reboot_cmd() is not None):
-                Display.render_text_centered(f"A = Power Down, X = Reboot, B = Cancel",self.screen_width() //2, self.screen_height()//2+100,Theme.text_color(FontPurpose.LIST), purpose=FontPurpose.LIST)
+                Display.render_text_centered(Language.label("powerDownOptionsWithReboot", "A = Power Down, X = Reboot, B = Cancel"),self.screen_width() //2, self.screen_height()//2+100,Theme.text_color(FontPurpose.LIST), purpose=FontPurpose.LIST)
             else:
-                Display.render_text_centered(f"A = Power Down, B = Cancel",self.screen_width() //2, self.screen_height()//2+100,Theme.text_color(FontPurpose.LIST), purpose=FontPurpose.LIST)
+                Display.render_text_centered(Language.label("powerDownOptions", "A = Power Down, B = Cancel"),self.screen_width() //2, self.screen_height()//2+100,Theme.text_color(FontPurpose.LIST), purpose=FontPurpose.LIST)
             Display.present()
             if(Controller.get_input()):
                 if(Controller.last_input() == ControllerInput.A):
@@ -248,7 +249,11 @@ def get_wifi_status(self):
         if not self.is_wifi_enabled():
             return WifiStatus.OFF
 
-        if self.get_ip_addr_text() in ["Off", "Error", "Connecting"]:
+        if self.get_ip_addr_text() in [
+            Language.label("wifiStatusOff", "Off"),
+            Language.label("wifiStatusError", "Error"),
+            Language.label("wifiStatusConnecting", "Connecting"),
+        ]:
             return WifiStatus.OFF
 
         info = self.get_wifi_connection_quality_info()
@@ -300,15 +305,15 @@ def start_wifi_services(self, foreground_call=False):
         if not self.connection_seems_up():
             PyUiLogger.get_logger().info("Starting WiFi Services")
             if(foreground_call):
-                Display.display_message("Turning on WiFi Power")
+                Display.display_message(Language.label("turningOnWifiPower", "Turning on WiFi Power"))
 
             self.set_wifi_power(1)
             time.sleep(1)  
             if(foreground_call):
-                Display.display_message("Starting WiFi process")
+                Display.display_message(Language.label("startingWifiProcess", "Starting WiFi process"))
             self.start_wpa_supplicant()
             if(foreground_call):
-                Display.display_message("Starting ip address assignment process")
+                Display.display_message(Language.label("startingIpAssignment", "Starting ip address assignment process"))
             self.start_udhcpc()
 
 
@@ -317,7 +322,7 @@ def get_ip_addr_text(self):
         import subprocess
 
         if not self.is_wifi_enabled():
-            return "Off"
+            return Language.label("wifiStatusOff", "Off")
 
         try:
             # Query interface address
@@ -335,10 +340,10 @@ def get_ip_addr_text(self):
                 if line.startswith("inet "):
                     return line.split()[1].split("/")[0]
 
-            return "Connecting"
+            return Language.label("wifiStatusConnecting", "Connecting")
 
         except Exception:
-            return "Error"    
+            return Language.label("wifiStatusError", "Error")    
 
     def exit_pyui(self):
         Display.deinit_display()
@@ -464,16 +469,16 @@ def get_mac_address(self,iface="wlan0"):
                 return f.read().strip()
         except Exception as e:
             PyUiLogger.get_logger().error(f"Could not read MAC address for interface {iface} : {e}")
-            return "Unknown"
+            return Language.label("aboutUnknown", "Unknown")
 
     def get_fw_version(self):
-        return "Unknown"
+        return Language.label("aboutUnknown", "Unknown")
 
     def get_about_info_entries(self):
         about_info_entries = []
-        about_info_entries.append( ("IP Address", self.get_ip_addr_text()) )
-        about_info_entries.append( ("Mac Address", self.get_mac_address()) )
-        about_info_entries.append( ("FW Version",self.get_fw_version()) )
+        about_info_entries.append( (Language.label("aboutIpAddress", "IP Address"), self.get_ip_addr_text()) )
+        about_info_entries.append( (Language.label("aboutMacAddress", "Mac Address"), self.get_mac_address()) )
+        about_info_entries.append( (Language.label("aboutFwVersion", "FW Version"),self.get_fw_version()) )
         about_info_entries.extend(self.get_device_specific_about_info_entries())
         return about_info_entries
 
@@ -514,7 +519,7 @@ def is_filesystem_read_only(self,path="/mnt/SDCARD"):
 
     def perform_sdcard_ro_check(self):
         if self.is_filesystem_read_only("/mnt/SDCARD"):
-            Display.display_message("Warning: /mnt/SDCARD is read-only. Please check your SD card.", duration_ms=10000)
+            Display.display_message(Language.label("sdcardReadOnlyWarning", "Warning: /mnt/SDCARD is read-only. Please check your SD card."), duration_ms=10000)
 
     def sync_hw_clock(self):
         #Is this different per device? Should be right for the tina linux handhelds at least

App/PyUI/fonts/README.md

@@ -71,12 +71,17 @@ def connman_connect(self, id_str: str):
     def switch_network(self, net: WiFiNetwork):
         PyUiLogger.get_logger().info(f"Selected {net.ssid}!")
         if(net.requires_password()):
-            password = self.on_screen_keyboard.get_input("WiFi Password")
+            password = self.on_screen_keyboard.get_input(Language.label("wifiPassword", "WiFi Password"))
             if(password is not None and 8 <= len(password) <= 63):
                 self.write_connman_conf(net, password)
-                Display.display_message(f"Updating config file for {net.ssid} with password {password}", duration_ms=5000)
+                Display.display_message(
+                    Language.label("updatingWifiConfig", "Updating config file for {ssid} with password {password}")
+                    .replace("{ssid}", net.ssid)
+                    .replace("{password}", password),
+                    duration_ms=5000,
+                )
             else:
-                Display.display_message("Invalid WiFi password length! Must be between 8 and 63", duration_ms=5000)
+                Display.display_message(Language.label("invalidWifiPasswordLength", "Invalid WiFi password length! Must be between 8 and 63"), duration_ms=5000)
 
         self.connman_connect(net.id_str)
 
@@ -92,7 +97,7 @@ def _build_options(
         option_list.append(
             GridOrListEntry(
                 primary_text=Language.status(),
-                value_text="<    " + ("On" if wifi_enabled else "Off") + "    >",
+                value_text="<    " + Language.on_off_label(wifi_enabled) + "    >",
                 image_path=None,
                 image_path_selected=None,
                 description=None,
@@ -219,5 +224,5 @@ def _show_menu(self):
                 time.sleep(0.05)
 
         finally:
-            Display.display_message("Stopping WiFi scanner...")
+            Display.display_message(Language.label("stoppingWifiScanner", "Stopping WiFi scanner..."))
             self.wifi_scanner.stop()

App/PyUI/lang/English.json

@@ -19,6 +19,7 @@
 from devices.utils.file_watcher import FileWatcher
 from devices.utils.process_runner import ProcessRunner
 from display.display import Display
+from menus.language.language import Language
 from utils import throttle
 from utils.config_copier import ConfigCopier
 
@@ -186,7 +187,7 @@ def _prepare_for_power_action(self):
         time.sleep(1)
 
     def power_off(self):
-        Display.display_message("Powering off...")
+        Display.display_message(Language.label("poweringOff", "Powering off..."))
         self._prepare_for_power_action()
         time.sleep(1)
         super().power_off()
@@ -195,7 +196,7 @@ def power_off(self):
 
 
     def reboot(self):
-        Display.display_message("Rebooting...")
+        Display.display_message(Language.label("rebooting", "Rebooting..."))
         self._prepare_for_power_action()
         time.sleep(1)
         super().reboot()

App/PyUI/lang/Vietnamese.json

@@ -221,6 +221,7 @@ def main():
             PyUiConfig.init(args.pyUiConfig)
             UserConfig.reload_config()
             CfwSystemConfig.init(args.cfwConfig)
+            Language.init()
 
         main_ui_mode = True
 
@@ -247,7 +248,6 @@ def main():
         #2nd init is just to allow scaling if needed
         Theme.convert_theme_if_needed(selected_theme, Device.get_device().screen_width(), Device.get_device().screen_height())
         Controller.init()
-        Language.init()
 
         Device.get_device().perform_sdcard_ro_check()
 

App/PyUI/main-ui/devices/device_common.py

@@ -50,7 +50,7 @@ def append_pyui_apps(self, app_list):
                             primary_text=boxart_scraper_config.get_label() + "(Hidden)" if AppsManager.is_hidden(boxart_scraper_config) else boxart_scraper_config.get_label(),
                             image_path=None,
                             image_path_selected=None,
-                            description="Scrape game boxart",
+                            description=Language.label("scrapeBoxartDesc", "Scrape game boxart"),
                             icon=icon,
                             extra_data=boxart_scraper_config,
                             value=BoxArtScraper().scrape_boxart
@@ -66,7 +66,7 @@ def append_pyui_apps(self, app_list):
                             primary_text=activity_tracker_config.get_label() + "(Hidden)" if AppsManager.is_hidden(activity_tracker_config) else activity_tracker_config.get_label(),
                             image_path=None,
                             image_path_selected=None,
-                            description="Track app usage",
+                            description=Language.label("trackAppUsageDesc", "Track app usage"),
                             icon=icon,
                             extra_data=activity_tracker_config,
                             value=ActivityTracker().run_activity_tracking_app