settings.py 8.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178
  1. from pydantic import BaseModel, Field
  2. class AppSettings(BaseModel):
  3. """Application settings schema."""
  4. auto_archive: bool = Field(default=True, description="Automatically archive prints when completed")
  5. save_thumbnails: bool = Field(default=True, description="Extract and save preview images from 3MF files")
  6. capture_finish_photo: bool = Field(
  7. default=True, description="Capture photo from printer camera when print completes"
  8. )
  9. default_filament_cost: float = Field(default=25.0, description="Default filament cost per kg")
  10. currency: str = Field(default="USD", description="Currency for cost tracking")
  11. energy_cost_per_kwh: float = Field(default=0.15, description="Electricity cost per kWh for energy tracking")
  12. energy_tracking_mode: str = Field(
  13. default="total",
  14. description="Energy display mode on stats: 'print' shows sum of per-print energy, 'total' shows lifetime plug consumption",
  15. )
  16. # Spoolman integration
  17. spoolman_enabled: bool = Field(default=False, description="Enable Spoolman integration for filament tracking")
  18. spoolman_url: str = Field(default="", description="Spoolman server URL (e.g., http://localhost:7912)")
  19. spoolman_sync_mode: str = Field(
  20. default="auto", description="Sync mode: 'auto' syncs immediately, 'manual' requires button press"
  21. )
  22. # Updates
  23. check_updates: bool = Field(default=True, description="Automatically check for updates on startup")
  24. check_printer_firmware: bool = Field(default=True, description="Check for printer firmware updates from Bambu Lab")
  25. # Language
  26. notification_language: str = Field(default="en", description="Language for push notifications (en, de)")
  27. # AMS threshold settings for humidity and temperature coloring
  28. ams_humidity_good: int = Field(default=40, description="Humidity threshold for good (green): <= this value")
  29. ams_humidity_fair: int = Field(
  30. default=60, description="Humidity threshold for fair (orange): <= this value, > is red"
  31. )
  32. ams_temp_good: float = Field(default=28.0, description="Temperature threshold for good (blue): <= this value")
  33. ams_temp_fair: float = Field(
  34. default=35.0, description="Temperature threshold for fair (orange): <= this value, > is red"
  35. )
  36. ams_history_retention_days: int = Field(default=30, description="Number of days to keep AMS sensor history data")
  37. # Print modal settings
  38. per_printer_mapping_expanded: bool = Field(
  39. default=False, description="Expand custom filament mapping by default in print modal"
  40. )
  41. # Date/time display format
  42. date_format: str = Field(default="system", description="Date format: system, us, eu, iso")
  43. time_format: str = Field(default="system", description="Time format: system, 12h, 24h")
  44. # Default printer for operations
  45. default_printer_id: int | None = Field(default=None, description="Default printer ID for uploads, reprints, etc.")
  46. # Virtual Printer
  47. virtual_printer_enabled: bool = Field(default=False, description="Enable virtual printer for slicer uploads")
  48. virtual_printer_access_code: str = Field(default="", description="Access code for virtual printer authentication")
  49. virtual_printer_mode: str = Field(
  50. default="immediate",
  51. description="Mode: 'immediate' (archive now), 'review' (pending review), or 'print_queue' (add to print queue)",
  52. )
  53. # Dark mode theme settings
  54. dark_style: str = Field(default="classic", description="Dark mode style: classic, glow, vibrant")
  55. dark_background: str = Field(
  56. default="neutral", description="Dark mode background: neutral, warm, cool, oled, slate, forest"
  57. )
  58. dark_accent: str = Field(default="green", description="Dark mode accent: green, teal, blue, orange, purple, red")
  59. # Light mode theme settings
  60. light_style: str = Field(default="classic", description="Light mode style: classic, glow, vibrant")
  61. light_background: str = Field(default="neutral", description="Light mode background: neutral, warm, cool")
  62. light_accent: str = Field(default="green", description="Light mode accent: green, teal, blue, orange, purple, red")
  63. # FTP retry settings for unreliable WiFi connections
  64. ftp_retry_enabled: bool = Field(default=True, description="Enable automatic retry for FTP operations")
  65. ftp_retry_count: int = Field(default=3, description="Number of retry attempts for FTP operations (1-10)")
  66. ftp_retry_delay: int = Field(default=2, description="Seconds to wait between FTP retry attempts (1-30)")
  67. ftp_timeout: int = Field(default=30, description="FTP connection timeout in seconds (10-120)")
  68. # MQTT Relay settings for publishing events to external broker
  69. mqtt_enabled: bool = Field(default=False, description="Enable MQTT event publishing to external broker")
  70. mqtt_broker: str = Field(default="", description="MQTT broker hostname or IP address")
  71. mqtt_port: int = Field(default=1883, description="MQTT broker port (default 1883, TLS typically 8883)")
  72. mqtt_username: str = Field(default="", description="MQTT username for authentication (optional)")
  73. mqtt_password: str = Field(default="", description="MQTT password for authentication (optional)")
  74. mqtt_topic_prefix: str = Field(default="bambuddy", description="Topic prefix for all published messages")
  75. mqtt_use_tls: bool = Field(default=False, description="Use TLS/SSL encryption for MQTT connection")
  76. # External URL for notifications
  77. external_url: str = Field(
  78. default="", description="External URL where Bambuddy is accessible (for notification images)"
  79. )
  80. # Home Assistant integration for smart plug control
  81. ha_enabled: bool = Field(default=False, description="Enable Home Assistant integration for smart plug control")
  82. ha_url: str = Field(default="", description="Home Assistant URL (e.g., http://192.168.1.100:8123)")
  83. ha_token: str = Field(default="", description="Home Assistant Long-Lived Access Token")
  84. # File Manager / Library settings
  85. library_archive_mode: str = Field(
  86. default="ask",
  87. description="When printing from File Manager, create archive entry: 'always', 'never', or 'ask'",
  88. )
  89. library_disk_warning_gb: float = Field(
  90. default=5.0,
  91. description="Show warning when free disk space falls below this threshold (GB)",
  92. )
  93. # Camera view settings
  94. camera_view_mode: str = Field(
  95. default="window",
  96. description="Camera view mode: 'window' opens in new browser window, 'embedded' shows overlay on main screen",
  97. )
  98. # Prometheus metrics endpoint
  99. prometheus_enabled: bool = Field(default=False, description="Enable Prometheus metrics endpoint at /metrics")
  100. prometheus_token: str = Field(
  101. default="", description="Bearer token for Prometheus metrics authentication (optional)"
  102. )
  103. class AppSettingsUpdate(BaseModel):
  104. """Schema for updating settings (all fields optional)."""
  105. auto_archive: bool | None = None
  106. save_thumbnails: bool | None = None
  107. capture_finish_photo: bool | None = None
  108. default_filament_cost: float | None = None
  109. currency: str | None = None
  110. energy_cost_per_kwh: float | None = None
  111. energy_tracking_mode: str | None = None
  112. spoolman_enabled: bool | None = None
  113. spoolman_url: str | None = None
  114. spoolman_sync_mode: str | None = None
  115. check_updates: bool | None = None
  116. check_printer_firmware: bool | None = None
  117. notification_language: str | None = None
  118. ams_humidity_good: int | None = None
  119. ams_humidity_fair: int | None = None
  120. ams_temp_good: float | None = None
  121. ams_temp_fair: float | None = None
  122. ams_history_retention_days: int | None = None
  123. per_printer_mapping_expanded: bool | None = None
  124. date_format: str | None = None
  125. time_format: str | None = None
  126. default_printer_id: int | None = None
  127. virtual_printer_enabled: bool | None = None
  128. virtual_printer_access_code: str | None = None
  129. virtual_printer_mode: str | None = None
  130. dark_style: str | None = None
  131. dark_background: str | None = None
  132. dark_accent: str | None = None
  133. light_style: str | None = None
  134. light_background: str | None = None
  135. light_accent: str | None = None
  136. ftp_retry_enabled: bool | None = None
  137. ftp_retry_count: int | None = None
  138. ftp_retry_delay: int | None = None
  139. ftp_timeout: int | None = None
  140. mqtt_enabled: bool | None = None
  141. mqtt_broker: str | None = None
  142. mqtt_port: int | None = None
  143. mqtt_username: str | None = None
  144. mqtt_password: str | None = None
  145. mqtt_topic_prefix: str | None = None
  146. mqtt_use_tls: bool | None = None
  147. external_url: str | None = None
  148. ha_enabled: bool | None = None
  149. ha_url: str | None = None
  150. ha_token: str | None = None
  151. library_archive_mode: str | None = None
  152. library_disk_warning_gb: float | None = None
  153. camera_view_mode: str | None = None
  154. prometheus_enabled: bool | None = None
  155. prometheus_token: str | None = None