LabelCraft 2.1.1__tar.gz → 2.1.2__tar.gz

{labelcraft-2.1.1 → labelcraft-2.1.2}/LabelCraft.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: LabelCraft
-Version: 2.1.1
+Version: 2.1.2
 Summary: LabelCraft - A modern graphical image annotation tool based on labelImg
 Home-page: https://github.com/syd168/LabelCraft
 Author: LabelCraft Contributors
@@ -99,6 +99,11 @@ Dynamic language switching without restart:
 - Python API for integration
 - Customizable shortcuts
 - Brightness adjustment
+- **Cross-Platform Dark Mode** (v2.1.1+)
+  - Windows 11/10: Automatic registry detection
+  - Linux (GNOME/KDE/Ubuntu): dconf/gsettings support
+  - macOS: System appearance detection
+  - See [Windows 11 Dark Mode Guide](doc/WINDOWS11_DARK_MODE.md) for setup
 
 ## 📸 Screenshot
 

{labelcraft-2.1.1 → labelcraft-2.1.2}/LabelCraft.egg-info/SOURCES.txt

@@ -18,6 +18,7 @@ libs/__init__.py
 libs/annotation_converter.py
 libs/annotation_importer.py
 libs/canvas.py
+libs/cli.py
 libs/coco_io.py
 libs/colorDialog.py
 libs/combobox.py
@@ -37,6 +38,7 @@ libs/project.py
 libs/resources.py
 libs/settings.py
 libs/shape.py
+libs/theme_manager.py
 libs/toolBar.py
 libs/ustr.py
 libs/utils.py

labelcraft-2.1.2/LabelCraft.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[gui_scripts]
+labelcraft = libs.cli:main

{labelcraft-2.1.1 → labelcraft-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: LabelCraft
-Version: 2.1.1
+Version: 2.1.2
 Summary: LabelCraft - A modern graphical image annotation tool based on labelImg
 Home-page: https://github.com/syd168/LabelCraft
 Author: LabelCraft Contributors
@@ -99,6 +99,11 @@ Dynamic language switching without restart:
 - Python API for integration
 - Customizable shortcuts
 - Brightness adjustment
+- **Cross-Platform Dark Mode** (v2.1.1+)
+  - Windows 11/10: Automatic registry detection
+  - Linux (GNOME/KDE/Ubuntu): dconf/gsettings support
+  - macOS: System appearance detection
+  - See [Windows 11 Dark Mode Guide](doc/WINDOWS11_DARK_MODE.md) for setup
 
 ## 📸 Screenshot
 

{labelcraft-2.1.1 → labelcraft-2.1.2}/README.md

@@ -62,6 +62,11 @@ Dynamic language switching without restart:
 - Python API for integration
 - Customizable shortcuts
 - Brightness adjustment
+- **Cross-Platform Dark Mode** (v2.1.1+)
+  - Windows 11/10: Automatic registry detection
+  - Linux (GNOME/KDE/Ubuntu): dconf/gsettings support
+  - macOS: System appearance detection
+  - See [Windows 11 Dark Mode Guide](doc/WINDOWS11_DARK_MODE.md) for setup
 
 ## 📸 Screenshot
 

{labelcraft-2.1.1 → labelcraft-2.1.2}/labelcraft_ui.py

@@ -40,6 +40,7 @@ from libs.ustr import ustr
 from libs.hashableQListWidgetItem import HashableQListWidgetItem
 from libs.project import Project, RecentProjectsManager
 from libs.newProjectDialog import NewProjectDialog
+from libs.theme_manager import apply_system_theme
 from libs import __version__
 
 __appname__ = 'LabelCraft'
@@ -4896,7 +4897,23 @@ class MainWindow(QMainWindow, WindowMixin):
             print(f"Using {len(classes_list)} classes from label history")
         else:
             classes_list = []
-            print("Warning: No classes list available. YOLO/COCO export may fail.")
+            print("Warning: No classes list available.")
+            
+            # For YOLO and COCO formats, show warning and ask user to continue
+            if selected_format[0] in [LabelFileFormat.YOLO, LabelFileFormat.COCO]:
+                reply = QMessageBox.warning(
+                    self,
+                    self.get_str('warningTitle'),
+                    f'{self.get_str("exportNoLabelsWarning")}\n\n'
+                    f'Project has no defined labels. Export to {selected_format[0].name} format requires labels.\n\n'
+                    f'Options:\n'
+                    f'1. Add labels to project first (recommended)\n'
+                    f'2. Continue with empty labels (annotations will use numeric IDs)',
+                    QMessageBox.StandardButton.Cancel | QMessageBox.StandardButton.Ok,
+                    QMessageBox.StandardButton.Cancel
+                )
+                if reply == QMessageBox.StandardButton.Cancel:
+                    return
         
         try:
             # Iterate through all annotation files
@@ -5293,6 +5310,10 @@ def get_main_app(argv=None):
     app.setApplicationName(__appname__)
     app.setWindowIcon(new_icon("app"))
     
+    # Apply system theme (light/dark mode)
+    # This will automatically follow the system's theme preference
+    apply_system_theme(app)
+    
     # Tzutalin 201705+: Accept extra arguments to change predefined class file
     argparser = argparse.ArgumentParser(
         prog='labelcraft',

{labelcraft-2.1.1 → labelcraft-2.1.2}/libs/__init__.py

@@ -1,2 +1,2 @@
-__version_info__ = ('2', '1', '1')
+__version_info__ = ('2', '1', '2')
 __version__ = '.'.join(__version_info__)

{labelcraft-2.1.1 → labelcraft-2.1.2}/libs/annotation_importer.py

@@ -817,6 +817,8 @@ class AnnotationImporter:
         
         # Get classes list - prioritize project labels over source labels
         # This ensures imported annotations match the project's label definitions
+        labels_added_to_project = False
+        
         if self.current_project.labels:
             # Project has defined labels, use them (most important)
             classes_list = self.current_project.labels
@@ -828,10 +830,18 @@ class AnnotationImporter:
                 print(f"Imported annotations will be mapped to project labels by class ID.")
                 print(f"This may cause incorrect labels if the class order differs!")
         elif yolo_labels:
-            # No project labels, use YOLO labels from data.yaml
+            # No project labels, use YOLO labels from data.yaml AND add them to project
             classes_list = yolo_labels
-            print(f"Using {len(classes_list)} classes from YOLO data.yaml: {classes_list[:5]}...")
-            print(f"Tip: Consider adding these labels to your project for consistency.")
+            print(f"Project has no labels. Using {len(classes_list)} classes from YOLO data.yaml: {classes_list[:5]}...")
+            
+            # Automatically add these labels to the project
+            try:
+                self.current_project.labels = classes_list.copy()
+                self.current_project.save()  # Save project to persist labels
+                labels_added_to_project = True
+                print(f"✓ Added {len(classes_list)} labels to project automatically")
+            except Exception as e:
+                print(f"Warning: Failed to add labels to project: {e}")
         else:
             # No labels available at all
             classes_list = []

labelcraft-2.1.2/libs/cli.py

@@ -0,0 +1,49 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""
+LabelCraft CLI Entry Point
+This module serves as the proper entry point for the labelcraft command,
+ensuring it works correctly regardless of the installation location.
+"""
+import sys
+import os
+
+def main():
+    """
+    Main entry point for LabelCraft command-line interface.
+    This ensures proper module resolution and data file loading
+    from any installation location.
+    """
+    # Get the directory where this module is located
+    module_dir = os.path.dirname(os.path.abspath(__file__))
+    # Get the parent directory (project root)
+    project_root = os.path.dirname(module_dir)
+    
+    # Add project root and module directory to Python path for proper imports
+    if project_root not in sys.path:
+        sys.path.insert(0, project_root)
+    if module_dir not in sys.path:
+        sys.path.insert(0, module_dir)
+    
+    try:
+        from PySide6.QtWidgets import QApplication
+        from labelcraft_ui import get_main_app
+        
+        # Create and run the application
+        app, _win = get_main_app(sys.argv)
+        sys.exit(app.exec())
+        
+    except ImportError as e:
+        print(f"Error: Failed to import required modules: {e}")
+        print("Please ensure PySide6 and lxml are installed:")
+        print("  pip install pyside6>=6.5.0 lxml>=4.9.0")
+        sys.exit(1)
+    except Exception as e:
+        print(f"Error: Failed to start LabelCraft: {e}")
+        import traceback
+        traceback.print_exc()
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()

{labelcraft-2.1.1 → labelcraft-2.1.2}/libs/locales/en.json

@@ -518,5 +518,6 @@
   "setVerifiedDetail": "Mark selected annotations as verified",
   "setUnverifiedDetail": "Mark selected annotations as unverified",
   "showVerificationStatusDetail": "Toggle showing verification status color in completed annotations list",
+  "exportNoLabelsWarning": "⚠️ No Labels Defined\n\nProject has no defined labels. Export to this format requires labels for proper conversion.",
   "tutorialContent": "<div style='font-size: 14px; line-height: 1.8;'>\n<h2 style='text-align: center; margin-bottom: 20px;'>Welcome to LabelCraft!</h2>\n\n<h3 style='margin-top: 20px; font-weight: bold;'>Basic Annotation Steps:</h3>\n<p><b>1. Create/Open Project:</b> File → New Project or Open Project<br>\n<b>2. Add Images:</b> Click \"+ Add Images\" or \"+ Add Folder\" in the bottom panel<br>\n<b>3. Annotate:</b> Double-click an image, then press 'W' to draw bounding boxes<br>\n<b>4. Save:</b> Press Ctrl+S to save annotations (auto-saves when moving to next image)<br>\n<b>5. Export:</b> Output → Export to convert annotations to desired format</p>\n\n<h3 style='margin-top: 20px; font-weight: bold;'>Helpful Tips:</h3>\n<p><b>• Shortcuts:</b> Help → Keyboard shortcuts to view all shortcuts<br>\n<b>• Labels:</b> Use the right panel to filter and manage labels<br>\n<b>• Navigation:</b> Mouse wheel to zoom, drag to pan<br>\n<b>• Brightness:</b> Adjust image brightness with slider in toolbar</p>\n\n<h3 style='margin-top: 20px; font-weight: bold;'>For more detailed documentation:</h3>\n<p>• <a href='https://github.com/syd168/LabelCraft'>Visit our GitHub repository for complete tutorials and examples</a><br>\n• <a href='https://github.com/syd168/LabelCraft/blob/master/README.md'>Documentation & Tutorials</a><br>\n• <a href='https://github.com/syd168/LabelCraft/issues'>Report Issues</a></p>\n</div>"
 }

{labelcraft-2.1.1 → labelcraft-2.1.2}/libs/locales/zh-CN.json

@@ -518,5 +518,6 @@
   "setVerifiedDetail": "将选中的标注标记为已验证",
   "setUnverifiedDetail": "将选中的标注标记为未验证",
   "showVerificationStatusDetail": "切换在已完成标注列表中显示验证状态颜色",
+  "exportNoLabelsWarning": "⚠️ 未定义标签\n\n项目没有定义标签。导出到此格式需要标签才能正确转换。",
   "tutorialContent": "<div style='font-size: 14px; line-height: 1.8;'>\n<h2 style='text-align: center; margin-bottom: 20px;'>欢迎使用 LabelCraft!</h2>\n\n<h3 style='margin-top: 20px; font-weight: bold;'>基本标注步骤:</h3>\n<p><b>1. 创建/打开项目:</b> 文件 → 新建项目 或 打开项目<br>\n<b>2. 添加图像:</b> 点击底部面板的 \"+ 添加图像\" 或 \"+ 添加文件夹\"<br>\n<b>3. 标注:</b> 双击图像,然后按 'W' 键绘制边界框<br>\n<b>4. 保存:</b> 按 Ctrl+S 保存标注(切换到下一张图像时自动保存)<br>\n<b>5. 导出:</b> 输出 → 导出 将标注转换为所需格式</p>\n\n<h3 style='margin-top: 20px; font-weight: bold;'>实用技巧:</h3>\n<p><b>• 快捷键:</b> 帮助 → 键盘快捷键 查看所有快捷键<br>\n<b>• 标签管理:</b> 使用右侧面板过滤和管理标签<br>\n<b>• 导航:</b> 鼠标滚轮缩放,拖拽平移<br>\n<b>• 亮度:</b> 使用工具栏中的滑块调整图像亮度</p>\n\n<h3 style='margin-top: 20px; font-weight: bold;'>更多详细文档:</h3>\n<p>• <a href='https://github.com/syd168/LabelCraft'>访问我们的 GitHub 仓库获取完整教程和示例</a><br>\n• <a href='https://github.com/syd168/LabelCraft/blob/master/README.md'>文档与教程</a><br>\n• <a href='https://github.com/syd168/LabelCraft/issues'>报告问题</a></p>\n</div>"
 }

labelcraft-2.1.2/libs/theme_manager.py

@@ -0,0 +1,267 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""
+LabelCraft Theme Manager
+Provides automatic system theme detection and application.
+Supports light/dark mode following system settings on:
+- Linux (GNOME, KDE, Ubuntu)
+- Windows (Windows 10, Windows 11)
+- macOS
+"""
+from PySide6.QtGui import QPalette, QColor
+from PySide6.QtWidgets import QApplication
+from PySide6.QtCore import Qt
+import platform
+import os
+
+
+def _create_dark_palette():
+    """
+    Create a comprehensive dark theme palette.
+    
+    Returns:
+        QPalette: Configured dark palette
+    """
+    dark_palette = QPalette()
+    
+    # Base colors for dark theme
+    dark_bg = QColor(53, 53, 53)
+    darker_bg = QColor(25, 25, 25)
+    light_text = QColor(255, 255, 255)
+    link_color = QColor(42, 130, 218)
+    
+    # Window and base colors
+    dark_palette.setColor(QPalette.ColorRole.Window, dark_bg)
+    dark_palette.setColor(QPalette.ColorRole.Base, darker_bg)
+    dark_palette.setColor(QPalette.ColorRole.AlternateBase, dark_bg)
+    
+    # Text colors
+    dark_palette.setColor(QPalette.ColorRole.WindowText, light_text)
+    dark_palette.setColor(QPalette.ColorRole.Text, light_text)
+    dark_palette.setColor(QPalette.ColorRole.ButtonText, light_text)
+    
+    # Button and control colors
+    dark_palette.setColor(QPalette.ColorRole.Button, dark_bg)
+    dark_palette.setColor(QPalette.ColorRole.Shadow, QColor(20, 20, 20))
+    dark_palette.setColor(QPalette.ColorRole.Highlight, link_color)
+    dark_palette.setColor(QPalette.ColorRole.HighlightedText, QColor(255, 255, 255))
+    
+    # Link colors
+    dark_palette.setColor(QPalette.ColorRole.Link, link_color)
+    
+    # Tooltips
+    dark_palette.setColor(QPalette.ColorRole.ToolTipBase, light_text)
+    dark_palette.setColor(QPalette.ColorRole.ToolTipText, dark_bg)
+    
+    # Disabled state
+    dark_palette.setColor(QPalette.ColorGroup.Disabled, QPalette.ColorRole.WindowText, QColor(128, 128, 128))
+    dark_palette.setColor(QPalette.ColorGroup.Disabled, QPalette.ColorRole.Text, QColor(128, 128, 128))
+    dark_palette.setColor(QPalette.ColorGroup.Disabled, QPalette.ColorRole.ButtonText, QColor(128, 128, 128))
+    
+    return dark_palette
+
+
+def _create_light_palette():
+    """
+    Create a comprehensive light theme palette.
+    
+    Returns:
+        QPalette: Configured light palette
+    """
+    light_palette = QPalette()
+    
+    # Use system default light colors
+    # Light palette is typically the default, so we return a new instance
+    return light_palette
+
+
+def _detect_windows_dark_mode():
+    """
+    Detect if Windows 11/10 is using dark mode.
+    
+    Checks the Windows Registry:
+    HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Themes\Personalize
+    AppsUseLightTheme = 0 means dark mode
+    
+    Returns:
+        bool: True if dark mode detected, False otherwise
+    """
+    try:
+        import winreg
+        try:
+            # Try to open the registry key
+            key = winreg.OpenKey(
+                winreg.HKEY_CURRENT_USER,
+                r'Software\Microsoft\Windows\CurrentVersion\Themes\Personalize'
+            )
+            # Read AppsUseLightTheme value
+            # 0 = dark mode, 1 = light mode
+            value, regtype = winreg.QueryValueEx(key, 'AppsUseLightTheme')
+            winreg.CloseKey(key)
+            return value == 0
+        except Exception:
+            # Key or value not found - assume light mode
+            return False
+    except ImportError:
+        # winreg not available (not on Windows)
+        return False
+    except Exception:
+        # Any other error - assume light mode
+        return False
+
+
+def _detect_linux_dark_mode():
+    """
+    Detect if Linux desktop environment is using dark mode.
+    
+    Supports:
+    - GNOME/Ubuntu (via dconf)
+    - KDE Plasma (via kdeglobals)
+    
+    Returns:
+        bool: True if dark mode detected, False otherwise
+    """
+    # Method 1: Check GNOME/Ubuntu GTK theme via dconf
+    try:
+        import subprocess
+        result = subprocess.run(
+            ['dconf', 'read', '/org/gnome/desktop/interface/gtk-theme'],
+            capture_output=True,
+            text=True,
+            timeout=2
+        )
+        if result.returncode == 0:
+            theme_name = result.stdout.strip().strip("'\"")
+            if 'dark' in theme_name.lower():
+                return True
+    except (FileNotFoundError, subprocess.TimeoutExpired, Exception):
+        pass
+    
+    # Method 2: Check GNOME settings (alternative method)
+    try:
+        import subprocess
+        result = subprocess.run(
+            ['gsettings', 'get', 'org.gnome.desktop.interface', 'gtk-application-prefer-dark-theme'],
+            capture_output=True,
+            text=True,
+            timeout=2
+        )
+        if result.returncode == 0:
+            return 'true' in result.stdout.lower()
+    except (FileNotFoundError, subprocess.TimeoutExpired, Exception):
+        pass
+    
+    # Method 3: Check environment variables
+    if os.environ.get('GTK_THEME', '').lower().endswith('-dark') or 'dark' in os.environ.get('GTK_THEME', '').lower():
+        return True
+    
+    if 'dark' in os.environ.get('QT_STYLE_OVERRIDE', '').lower():
+        return True
+    
+    # Method 4: Check Plasma/KDE settings
+    try:
+        config_path = os.path.expanduser('~/.config/kdeglobals')
+        if os.path.exists(config_path):
+            with open(config_path, 'r') as f:
+                content = f.read()
+                if '[General]' in content and 'ColorScheme=' in content:
+                    for line in content.split('\n'):
+                        if 'ColorScheme=' in line and 'dark' in line.lower():
+                            return True
+    except Exception:
+        pass
+    
+    return False
+
+
+def _detect_macos_dark_mode():
+    """
+    Detect if macOS is using dark mode.
+    
+    Uses `defaults read` to check the system appearance setting.
+    
+    Returns:
+        bool: True if dark mode detected, False otherwise
+    """
+    try:
+        import subprocess
+        result = subprocess.run(
+            ['defaults', 'read', '-g', 'AppleInterfaceStyle'],
+            capture_output=True,
+            text=True,
+            timeout=2
+        )
+        # If the command returns 'Dark', dark mode is enabled
+        return 'Dark' in result.stdout or result.returncode == 0
+    except (FileNotFoundError, subprocess.TimeoutExpired, Exception):
+        # If the command fails, assume light mode (default on macOS)
+        return False
+
+
+def _detect_system_dark_mode():
+    """
+    Detect if the system is using dark mode.
+    
+    Tries multiple methods based on the operating system:
+    - Windows: Registry check (AppsUseLightTheme)
+    - Linux: dconf, gsettings, or environment variables
+    - macOS: defaults read
+    
+    Returns:
+        bool: True if dark mode detected, False otherwise
+    """
+    system = platform.system()
+    
+    if system == 'Windows':
+        return _detect_windows_dark_mode()
+    elif system == 'Linux':
+        return _detect_linux_dark_mode()
+    elif system == 'Darwin':  # macOS
+        return _detect_macos_dark_mode()
+    else:
+        # Unknown system - assume light mode
+        return False
+
+
+def apply_system_theme(app):
+    """
+    Apply system theme (light/dark mode) to the application.
+    
+    This function detects the system's current theme preference
+    and applies it to the QApplication. The application will
+    automatically use the correct colors and styles based on
+    the system's light/dark mode setting.
+    
+    Args:
+        app (QApplication): The Qt application instance
+    """
+    # Use Fusion style for better cross-platform theme support
+    app.setStyle('Fusion')
+    
+    # Detect if system is in dark mode
+    is_dark = _detect_system_dark_mode()
+    
+    # Apply the appropriate palette
+    if is_dark:
+        dark_palette = _create_dark_palette()
+        app.setPalette(dark_palette)
+    else:
+        # Light mode uses default palette
+        light_palette = _create_light_palette()
+        app.setPalette(light_palette)
+    
+    # Return theme info
+    return {
+        'is_dark_mode': is_dark,
+        'palette': app.palette()
+    }
+
+
+def is_system_dark_mode():
+    """
+    Detect if the system is using dark mode.
+    
+    Returns:
+        bool: True if dark mode is detected, False for light mode
+    """
+    return _detect_system_dark_mode()

{labelcraft-2.1.1 → labelcraft-2.1.2}/setup.py

@@ -120,7 +120,7 @@ setup(
     },
     entry_points={
         'gui_scripts': [
-            'labelcraft=main:main',
+            'labelcraft=libs.cli:main',
         ]
     },
     include_package_data=True,

labelcraft-2.1.1/LabelCraft.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[gui_scripts]
-labelcraft = main:main