add sample image

Author: kujirahand

README.md

@@ -6,6 +6,8 @@
 
 `TkEasyGUI` is the easiest library for creating GUIs in Python.
 
+<img src="https://github.com/kujirahand/tkeasygui-python/raw/main/docs/image/icon256.png" width="256" alt="TkEasyGUI is the easiest library for creating GUIs in Python.">
+
 This library allows you to easily create GUI applications with Python.
 Since it is based on Tkinter, it runs consistently on Windows, macOS, and Linux.
 With a variety of built-in dialogs and customizable forms, you can develop applications effortlessly.
@@ -23,6 +25,7 @@ With a variety of built-in dialogs and customizable forms, you can develop appli
 Install package from [PyPI](https://pypi.org/project/TkEasyGUI/).
 
 ```sh
+# Install package from PyPI
 pip install TkEasyGUI
 # or
 python -m pip install TkEasyGUI
@@ -31,7 +34,13 @@ python -m pip install TkEasyGUI
 Install package from [GitHub Repository](https://github.com/kujirahand/tkeasygui-python).
 
 ```sh
+# Install package from GitHub Repository
 python -m pip install git+https://github.com/kujirahand/tkeasygui-python
+# or
+# Clone the repository and install
+git clone https://github.com/kujirahand/tkeasygui-python
+cd tkeasygui-python
+python -m pip install .
 ```
 
 ## Features of This Library
@@ -79,6 +88,17 @@ if form:
 
 <img src="https://github.com/kujirahand/tkeasygui-python/raw/main/docs/image/sample3.png" width="300" alt="TkEasyGUI">
 
+A file selection dialog is also available.
+
+```py
+import TkEasyGUI as eg
+# Show File dialog
+file_path = eg.popup_get_file("Select a file")
+eg.print(f"You selected: {file_path}")
+```
+
+<img src="https://github.com/kujirahand/tkeasygui-python/raw/main/docs/image/sample-popup_get_file.png" width="300" alt="TkEasyGUI">
+
 ### More Dialogs
 
 `TkEasyGUI` provides a variety of dialogs. For example, a color selection dialog, a file selection dialog, and a calendar dialog.
@@ -176,8 +196,6 @@ There are other helpful articles as well.
 - Methods such as Copy, Paste, and Cut are added to text boxes (Multiline/Input).
 - The system's default color scheme is utilized.
 
-<img src="https://github.com/kujirahand/tkeasygui-python/raw/main/docs/image/icon256.png" width="256" alt="TkEasyGUI Logo">
-
 ## Additional Information
 
 ### How to run on Raspberry Pi?

docs/image/sample-popup_get_file.png

@@ -0,0 +1,20 @@
+"""Sample code for popup_get_file()"""
+
+import TkEasyGUI as eg
+
+# Show File dialog
+file_path = eg.popup_get_file("Select a file")
+eg.print(f"You selected: {file_path}")
+
+# Show File dialog for multiple files
+files = eg.popup_get_file(
+    "Select files",
+    multiple_files=True,
+    file_types=[("Text files", "*.txt"), ("All files", "*.*")],
+)
+if files:
+    # Split the selected files into a list and show them in a popup
+    files_list = files.split(eg.FILES_DELIMITER)
+    eg.popup_listbox(files_list, "Selected files")
+else:
+    eg.popup("No files selected.")