Merge V1.97_dev with main branch

.gitignore

@@ -32,6 +32,6 @@ my_tags.csv
 onnx_models/*
 !onnx_models/ONNX vision models go here
 
-# Misc
-docs/Workpad.md
 
+# Misc
+test_space/

README.md

@@ -99,6 +99,8 @@ Example folder structures:
 
 # 💡 Tips and Features
 
+For detailed information on the tools and features, see the [User Guide✨](https://github.com/Nenotriple/img-txt_viewer/blob/main/docs/User_Guide.md) in the repo docs.
+
 - **Shortcuts:**
   - `ALT + LEFT/RIGHT`: Quickly move between img-txt pairs.
   - `SHIFT + DEL`: Move the current pair to a local trash folder.
@@ -159,12 +161,6 @@ Example folder structures:
   - Text cleanup is optimized for CSV-format captions and can be disabled via the Clean-Text option in the menu.
 
 
-# ✨ User Guide
-
-
-For more detailed information regarding the various tools and features, please refer to the [User Guide✨](https://github.com/Nenotriple/img-txt_viewer/blob/main/docs/User_Guide.md)found in the repo docs.
-
-
 <br>
 
 
@@ -241,4 +237,4 @@ python img-txt_viewer.py
 **img-txt Viewer** is completely private, in every sense of the word.
 - The app operates entirely on your device, ensuring your data remains solely under your control.
 - **No data is collected, transmitted, or stored**, aside from a basic configuration file for app settings.
-- The app functions 100% offline and never connects to external servers. **No data is ever shared or sent elsewhere.**
+- The app functions 100% offline and never connects to external servers. **No data is ever shared or sent elsewhere.**

docs/Workpad.md

@@ -0,0 +1,180 @@
+# Workpad
+
+Notes, code reference, ideas, etc.
+
+
+
+
+<!--###########################################################################-->
+## Window Size on Resize
+
+Prints Tkinter window dimensions on resize:
+
+```python
+root.bind("<Configure>", lambda event: print(f"Window size (W,H): {event.width},{event.height}") if event.widget == root else None)
+```
+
+Example Output: `Window size (W,H): 800,600`
+
+
+
+
+<!--###########################################################################-->
+## Widget Size on Resize
+
+Prints Tkinter widget dimensions on resize:
+
+```python
+widget.bind("<Configure>", lambda event: print(f"Widget size (W,H): {event.width},{event.height}"))
+```
+
+Example Output: `Widget size (W,H): 200,150`
+
+
+
+
+<!--###########################################################################-->
+## Caller Function Name
+
+Prints the name of the function that called the current function:
+
+```python
+import inspect
+
+def function_a():
+    function_b()
+
+def function_b():
+    caller_name = inspect.stack()[1].function
+    print(f"Called by function: {caller_name}")
+```
+
+Example Output: `Called by function: function_a`
+
+
+
+
+<!--###########################################################################-->
+## Timing a Function
+
+Measures the execution time of a function.
+
+`:.2f` formats the `elapsed_time` (float) variable, to two decimal places.
+
+```python
+import time
+
+def my_function():
+    start_time = time.time()
+    # ...Code to measure...
+    elapsed_time = time.time() - start_time
+    print(f"Elapsed time: {elapsed_time:.2f} seconds")
+```
+
+Example Output: `Elapsed time: 0.50 seconds`
+
+
+
+
+<!--###########################################################################-->
+## Tkinter error message with option to copy error to clipboard
+
+Present the user with an error message using `messagebox.askokcancel()`.
+
+Use `traceback.format_exc()` to get the full error message.
+
+If the user clicks `OK`, copy the error to the clipboard.
+
+```python
+import traceback
+from tkinter import messagebox
+
+def my_function():
+  # ...Some code...
+  except Exception as e:
+      error_message = traceback.format_exc()
+      if messagebox.askokcancel("Error", f"An error occurred:\n\n{error_message}\n\nPress OK to copy the error message to the clipboard."):
+          # Clear the clipboard
+          root.clipboard_clear()
+          # Copy to the clipboard
+          root.clipboard_append(error_message)
+          # Update the clipboard
+          root.update()
+```
+
+In this example, the full error message is displayed, but you could show the exception using `e` instead of `error_message` to display a more concise error message.
+
+
+
+<!--###########################################################################-->
+# ImgTxtViewer - Ideas
+
+## General:
+- Organize the various alt-UIs into a tabbed tkinter Notebook widget.
+- File list selector.
+
+
+
+
+<!-- Tools / Features --#########################################################################-->
+## New Tool - Group img-txt Pairs
+Create an interface to view one image at a time and easily select a folder to send the image to.
+The interface consists of:
+- Image and Text Pair (left):
+  - The image is displayed with the text below it.
+  - The text is un-editable and shown in a small widget.
+- Treeview Display (right):
+  - Displays the image name, text, and folder name.
+  - Shows the pairs and their respective folders.
+- User-Defined Folder Buttons (bottom):
+  - An Entry widget to input the folder name and an "Add" button to create a new folder button.
+  - Right-click on a folder button to rename or delete it.
+Both the image and text pair (if present) are moved to the selected folder. Before starting, define at least two folders. The working directory (where the pairs are initially stored) can be used as the first folder.
+
+
+## New Tool - Consolidate Similar Tags
+Consolidate similar tags based on the following rules: `If a tag is a substring of another, combine them`
+- Two modes are supported:
+  - Descriptive: Combine into the longest possible tag.
+    - Example 1: `["hair", "long hair", "black hair"]` → `long black hair`
+    - Example 2: `["shirt", "black shirt", "t-shirt"]` → `black t-shirt`
+  - Concise: Combine into the shortest possible tag.
+    - Example 1: `["hair", "long hair", "black hair"]` → `hair`
+    - Example 2: `["shirt", "black shirt", "t-shirt"]` → `shirt`
+
+
+
+
+<!-- Notebook Tabs --############################################################################-->
+## MyTags Tab
+- Show all tags in a list, with a count of how many times each tag is used.
+- Allow the user to quickly insert tags from "AllTags" into "MyTags".
+- Allow the user to quickly insert tags from "AllTags" into the text box.
+
+
+## AutoTag Tab
+- Add a "Presets" button to quickly save and load tagging presets.
+
+
+## Filter Tab
+- Add a listbox to display all filtered img-txt pairs.
+- Allow the user to select item(s) from the listbox and:
+  - Prefix, Append, or Replace tags.
+  - Move to another folder.
+  - Delete img-txt pairs.
+- Add more filtering options like:
+  - `Resolution`, `Aspect ratio`, `File size`, `File name`:
+    - Is equal to `=`
+    - Is not equal to `!=`
+    - Is greater than `>`
+    - Is less than `<`
+    - Similar to `*`
+  - `File type`:
+    - Is equal to `=`
+    - Is not equal to `!=`
+  - `Tags`:
+    - Contains `a,b`
+    - Does not contain `!`
+    - Starts with `a,b`
+    - Ends with `a,b`
+    - Similar to `*`