懶貓 YouTube 本機下載器 — Ubuntu 快速安裝
=======================================

支援系統：Ubuntu x86_64
發行方式：原生 deb／套件版本的 Google Chrome、Microsoft Edge、Brave、Firefox test 各有獨立安裝包

安裝方式
--------
1. 將 ZIP 完整解壓縮。
2. 在解壓後的根目錄開啟終端機。
3. 執行：

   bash 安裝-Ubuntu.sh

4. 安裝包已內附 FFmpeg；系統已有健康的 ffmpeg／ffprobe 時會沿用，否則安裝私有副本。若缺少 Python、python3-venv、Zenity 或 Deno，安裝程式會先列出將執行的動作並詢問確認。
5. 顯示「安裝完成」後，設定助手會用這個包指定的瀏覽器開啟本機圖文說明頁；頁面會顯示實際擴充功能路徑，並提供複製按鈕。

注意事項
--------
- 請勿使用 sudo 執行整個安裝程式；只有 apt 安裝 Python／venv 或圖形工具等系統必要元件時才會要求 sudo，內附 FFmpeg 不需要 sudo。
- Snap／Flatpak 瀏覽器受到沙盒限制，目前不列為 Native Messaging 的正式支援組合；建議使用原生 deb／套件版本。
- Chrome／Edge／Brave 基於瀏覽器安全限制，第一次仍需手動按「載入未封裝項目」。
- 每個包只設定檔名指定的瀏覽器，不會自動安裝其他瀏覽器的擴充功能。要增加另一個瀏覽器，請執行該瀏覽器的安裝包；原有瀏覽器設定會保留。
- ~/.local/share/tw.local.ytdownload/browser-setup.sh 可從已登錄的瀏覽器中選擇一個，重新開啟對應的本機說明頁。
- Wayland 請在圖文說明頁的步驟 3 按「複製」取得路徑；不需要另外安裝 wl-clipboard。X11 若已有 xclip，設定助手可額外預先複製；沒有也不影響安裝。
- 沒有桌面、瀏覽器無法啟動或頁面複製按鈕無法使用時，設定助手仍會在終端機印出管理頁網址、完整路徑與手動載入步驟。
- Firefox test 包的「暫用附加元件」會在 Firefox 關閉或重新啟動後移除，必須重新載入；永久使用需要已簽署的未上架 XPI，或允許未簽署附加元件的開發版本。

預設安裝位置
------------
~/.local/share/tw.local.ytdownload

解除安裝
--------
安裝完成畫面會列出解除安裝指令。共用解除安裝器會移除本工具建立的檔案（包括私有 FFmpeg）、所有已設定瀏覽器的 Native Messaging manifest 與選用的 systemd 使用者計時器，不會移除共用的 Python、系統 FFmpeg、Deno 或瀏覽器。

若安裝失敗
----------
請從畫面上方找到第一個錯誤訊息；修正該項後，再重新執行「bash 安裝-Ubuntu.sh」。重跑安裝程式會修復現有安裝，不需要先解除安裝。
