Merge remote-tracking branch 'origin/main'

README.md

@@ -9,12 +9,20 @@ Sync project and install dependencies.
 uv sync
 ```
 
-Run from source:
+Activate the virtual environment and run tool with Python:
-
 ```bash
+.venv/bin/activate # For Windows, use ".\.venv\Scripts\Activate.ps1" or ".\.venv\Scripts\activate.bat"
 python main.py
 ```
 
+# Run from build version
+Download this tool from [main repo](https://repo.weispace.net/wei/PlaylistSaver/releases) or [GitHub mirror](https://github.com/WeiDnite1222/PlaylistSaver) (Ensure the build version you downloaded support you 
+operating system and architecture)
+
+Use any decompress tool to unzip the build file, then open `PlaylistSaver.exe` (For Unix-like system is `PlaylistSaver`)
+
+See `How to use` to get information about how to use this tool.
+
 ## Build
 
 > [!IMPORTANT]
@@ -28,12 +36,52 @@ uv pip install -e ".[build]"
 
 Build this project with PyInstaller:
 
+On Windows, use `build.ps1` script:
 ```powershell
-.\build.ps1 -Clean
+.\build.ps1 -Clean # Or "powershell .\build.ps1 -Clean" if you use cmd
+```
+
+On other platform, run below command to build:
+```bash
+python -m PyInstaller PlaylistSaver.spec
 ```
 
 The build is written to `dist\PlaylistSaver`. This includes only the
 bundled mpv files matching the operating system and CPU architecture on which the
 build is performed. Build each target platform on that platform.
 
-## How to use
+## Before Use
+
+> [!IMPORTANT]
+> You must configure the secret key before use this tool.
+
+> [!NOTE]
+> The PlaylistSaverHelper (this tool's Chrome extenstion. Used for transfer YouTube cookie to the main program) haven't listed from the Chrome Extenstion Store. Install via the normal way is impossible.
+
+### Install Chrome extenstion
+
+1. First, download the compressed extenstion `PlaylistSaverHelper.zip` from [release page](https://repo.weispace.net/wei/PlaylistSaver/releases) (or [GitHub mirror](https://repo.weispace.net/wei/PlaylistSaver/releases))
+![Download extenstion](https://repo.weispace.net/wei/PlaylistSaver/raw/branch/main/repo_resources/download_extenstion.png)
+
+2. Unzip the compressed extenstion with any decompress tool.
+![decompress extenstion](https://repo.weispace.net/wei/PlaylistSaver/raw/branch/main/repo_resources/unzip_extenstion.png)
+
+3. Open Chrome and go to `chrome://extensions/`, then click `Open unpacked` button.
+![Open unpacked](https://repo.weispace.net/wei/PlaylistSaver/raw/branch/main/repo_resources/import_unpack.png)
+
+4. Enable the extension.
+![Enable extension](https://repo.weispace.net/wei/PlaylistSaver/raw/branch/main/repo_resources/enable_the_extenstion.png)
+
+### Configure secret key
+
+1. Open PlaylistSaver, then click `Helper Secret Key`
+![Open tool](https://repo.weispace.net/wei/PlaylistSaver/src/branch/main/repo_resources/open_tool.png)
+
+2. Copy secret key.
+![Copy key](https://repo.weispace.net/wei/PlaylistSaver/raw/branch/main/repo_resources/copy_key.png)
+
+3. Go to YouTube, press `Alt+Z` or click PlaylistSaver icon (on extension list) and click `option` to open helper page.
+![Open Helper via option button](https://repo.weispace.net/wei/PlaylistSaver/raw/branch/main/repo_resources/open_helper_page.png)
+
+4. Paste the key to the helper page. Then press `Save key`
+![Paste the secret key to the helper page. And press "Save key"](https://repo.weispace.net/wei/PlaylistSaver/raw/branch/main/repo_resources/save_key.png)