User Interface Overview - Ktiseos-Nyx/Dataset-Tools GitHub Wiki

User Interface Overview

Dataset-Tools provides a straightforward graphical interface designed for easy navigation and inspection of your image and metadata files.

Main Application Window Components

The application window is organized into several key areas:

  1. Folder Management & Navigation:

    • Current Folder Display: A clearly visible label at the top showing the full path of the currently loaded folder.
    • "Open Folder" Button: Allows you to browse and select a directory containing your images, text files, and safetensors files.
    • Drag and Drop Area: The main window or a designated area allows you to drag and drop a single image file. The application will then automatically load the folder containing that image.

  2. File List & Sorting:

    • File List: A scrollable list on the left-hand side displaying all supported files (images, text files, safetensors) found in the selected folder.
    • Selected File Label: Indicates which file is currently selected from the list.
    • "Sort Files" Options: Buttons or a dropdown menu allowing you to sort the files in the list (e.g., by name, date, type).

  3. Content Preview & Metadata Display (Right-Hand Side):

    • Image Preview Pane: A central area that displays a preview of the currently selected image file. If a non-image file is selected (like a text or safetensors file), this area might show a relevant icon or placeholder.
    • Metadata Box: A scrollable text area below or adjacent to the image preview. This box displays:
      • Extracted EXIF metadata from selected image files, including AI-generated details like Stable Diffusion prompts, samplers, seeds, steps, CFG scale, model hashes, etc.
      • Metadata from selected safetensors files (e.g., LoRA metadata).
      • The content of selected .txt or other text-based files.
    • "Copy Metadata" Button: A button associated with the Metadata Box that allows you to quickly copy all displayed metadata to your clipboard.

  4. Application Menu & Settings (Typically at the top or via a dedicated button):

    • File Menu:
      • Open Folder: (Often duplicated from the main button for accessibility)
      • Exit Application: To close Dataset-Tools.
    • Settings Menu:
      • Themes: Allows you to choose from various visual themes for the application interface (e.g., different Qt Material themes like light, dark, etc.).
      • Window Sizing: Options to set or remember preferred window sizes or apply standard window size presets.
      • (Other application-specific settings might be here)

Basic Workflow & Interaction

  1. Loading a Folder:

    • Click the "Open Folder" button and navigate to your desired directory.
    • Alternatively, drag and drop a single image file from your file explorer onto the application window. Dataset-Tools will then load the parent folder of that image.

  2. Browsing Files:

    • The File List will populate with all compatible files from the loaded folder.
    • Use the "Sort Files" options to arrange the list as needed.

  3. Viewing Content and Metadata:

    • Click on a file in the File List.
      • If it's an image, it will appear in the Image Preview pane.
      • Its associated metadata (EXIF, AI params, safetensors info) will populate the Metadata Box.
      • If a text file is selected, its content will display in the Metadata Box (or a dedicated text view area if distinct).
    • Use the "Copy Metadata" button to easily grab the displayed metadata.

  4. Customizing Appearance:

    • Access the Settings menu to change Themes or adjust Window Sizing preferences.