Update documentation with current status and add installation instructions

INSTALLATION.md

@@ -0,0 +1,63 @@
+# Installation and Usage Instructions
+
+This document provides detailed instructions for setting up and running the `pytchat_listener.py` script for monitoring YouTube Live Chat.
+
+## Prerequisites
+
+*   Python 3.8+
+*   `pip` (Python package installer)
+*   `git` (for cloning the repository)
+
+## Installation Steps
+
+1.  **Clone the Repository:**
+    Open your terminal and clone the project repository from Gitea:
+    ```bash
+    git clone https://gitea.ramforth.net/ramforth/youtube-chat-webhook-v2.git
+    cd youtube-chat-webhook-v2
+    ```
+
+2.  **Create and Activate a Virtual Environment:**
+    It is highly recommended to use a Python virtual environment to manage project dependencies.
+    ```bash
+    python3 -m venv venv
+    ```
+    *   **For Bash/Zsh:**
+        ```bash
+        source venv/bin/activate
+        ```
+    *   **For Fish Shell:**
+        ```bash
+        source venv/bin/activate.fish
+        ```
+
+3.  **Install Dependencies:**
+    With your virtual environment activated, install the required Python packages:
+    ```bash
+    pip install pytchat rich
+    ```
+
+## Usage
+
+1.  **Run the Script:**
+    Ensure your virtual environment is activated, then run the `pytchat_listener.py` script:
+    ```bash
+    python pytchat_listener.py
+    ```
+
+2.  **Enter Video ID:**
+    The script will prompt you to "Enter the YouTube Live Stream Video ID:". Paste the 11-character ID of the live stream you wish to monitor and press Enter.
+
+3.  **Observe Chat:**
+    The script will then start fetching and displaying live chat messages in your terminal.
+
+4.  **Save Chat Log:**
+    To exit the script gracefully, press `Ctrl+C`. You will then be prompted if you want to save the chat log.
+
+## User Colors Persistence (`user_colors.json`)
+
+The script assigns unique, persistent colors to chatters. This mapping is stored in a file named `user_colors.json` in the project directory.
+
+*   If this file does not exist, it will be created automatically.
+*   If it exists, the script will load the previously assigned colors.
+*   You can manually edit this file to change a user's color or reset the mapping.