v2.4 - yt-dlp Update

中文 | English

音樂下載器 v2.4.0

修正

• 更新yt-dlp版本，修正因YouTube端邏輯異動導致的下載失敗問題

新增

• yt-dlp下載參數新增 javascript_runtimes: ['quickjs']，透過QuickJS引擎執行YouTube端的簽章解密，提升下載成功率
• 新增相依套件 quickjs、quickjs-ng

備註

• 程式碼中新增一組預設關閉的cookiesfrombrowser選項（已註解），可視需求啟用以支援瀏覽器cookie登入下載，非本版本預設行為
• 完整功能說明與其他更多資訊，請查看 README.md。

---

musicDownloader v2.4.0

Fixed

• Updated yt-dlp to fix download failures caused by changes on YouTube's end

Added

• Added javascript_runtimes: ['quickjs'] to yt-dlp download options, using the QuickJS engine to handle YouTube's signature decryption and improve download success rate
• Added dependencies quickjs and quickjs-ng

Notes

• A disabled-by-default cookiesfrombrowser option (commented out) was added to the code, available for browser-cookie-based login downloads if needed — not enabled by default in this release
• For full feature details and more infos, see README.md.

v2.3 - Interface and Functionality Optimization

Music Downloader v2.3 Release Note

更新內容

• UI 改版：新增「選擇」、「開啟資料夾」、「清除」、「貼上」按鈕，操作更直覺。
• 新增進度條：下載時可即時顯示百分比進度。
• 改用 Thread 下載：下載期間視窗不再卡住、不會顯示「沒有回應」。
• 提高可攜性：將 ffmpeg 打包進程式（ffmpeg_bin），不再依賴寫死的 C:\ffmpeg\bin 路徑。

已修正

• 存檔路徑 bug 已修正：改為透過「選擇」按鈕指定資料夾，不再會發生因路徑變數未賦值而下載失敗的問題。

備註

完整功能說明與其他更多資訊，請查看 README.md。

---

What's new

• UI overhaul: added "Select folder", "Open folder", "Clear", and "Paste" buttons for a smoother workflow.
• Progress bar: shows real-time download percentage.
• Threaded downloads: the window no longer freezes or shows "Not Responding" during download.
• Improved portability: ffmpeg is now bundled with the app (ffmpeg_bin) instead of relying on a hardcoded C:\ffmpeg\bin path.

Fixed

• Save path bug fixed: folder selection now goes through the "選擇" (Select) button, so the previous crash from an unassigned path variable no longer occurs.

Note

For full feature details and more infos, see README.md.

v1.1 - URLs trimming allowed

YTmp3downloader v1.1 Release Note

更新內容

• 修正播放清單誤下載問題：當網址包含 &list=... 時，舊版會把整個播放清單都下載下來。v1.1 會自動偵測網址中的 &，只取其之前的部分作為下載網址，確保只下載單一影片。

已知問題

• 自訂存檔路徑仍無法使用：當「存檔路徑」欄位有填值時，程式會對尚未賦值的變數呼叫字串處理函式，導致下載失敗並跳出錯誤訊息。目前僅空白（預設下載資料夾）可正常運作，此問題尚未修正。

備註

完整功能說明、安裝方式與其他資訊，請查看 README.md。

---

YTmp3downloader v1.1 Release Note

What's new

• Fixed accidental playlist downloads: when a URL contained &list=..., the old version would download the entire playlist. v1.1 detects the & in the URL and keeps only the part before it, so only the single video is downloaded.

Known issues

• Custom save path still doesn't work: when the "存檔路徑" (save path) field is filled in, the app calls a string operation on a variable that hasn't been assigned yet, causing the download to fail. Only the default (blank = Downloads folder) currently works. Not fixed in this release.

Note

For full feature details, installation, and more infos, see README.md.

v1.0 - First Version

YTmp3downloader Release Note

專案簡介

• 一個 YouTube 轉 mp3 的小工具，輸入網址後透過 yt-dlp 下載音訊並轉成 mp3。
• 預設存到使用者的「下載」資料夾，也可以指定其他路徑。
• 下載完成後會自動把檔案的時間戳更新成現在時間。

安裝指南

• 直接執行打包好的 .exe 檔，不需要安裝 Python 或任何套件。
• 唯一需求：ffmpeg，需自行安裝並放在 C:\ffmpeg\bin（這個路徑是寫死的，沒裝在這裡會下載失敗）。

快速上手

1. 雙擊執行 .exe。
2. 在「YouTube網址」欄位貼上影片網址。
3. 「存檔路徑」留空 = 存到「下載」資料夾；要自訂路徑則直接輸入。
4. 點擊「下載影片」，畫面會顯示「下載中...」，完成後變成「下載完成！」。

常見問題

Q：跳出「請輸入YouTube網址」？
A：網址欄位是空的，先貼上連結。

Q：跳出「無法下載，請確認輸入是否錯誤」？
A：常見原因：

• 網址格式錯誤或影片不存在
• ffmpeg 不在 C:\ffmpeg\bin
• 目前已知問題：當「存檔路徑」欄位有填值時，程式會嘗試對尚未賦值的變數呼叫字串處理函式，導致例外、跳出此錯誤訊息。換句話說，自訂存檔路徑目前無法正常運作，僅空白（預設下載資料夾）可用。

Q：下載的檔案存在哪？
A：檔名為影片標題，副檔名最終會是 .mp3。

---

What it does

• A small YouTube to mp3 tool. Paste a URL, and it downloads the audio via yt-dlp and converts it to mp3.
• Saves to the user's "Downloads" folder by default, or a custom path if specified.
• After download, the file's timestamp is updated to the current time.

Installation

• Just run the bundled .exe — no Python or package installation needed.
• Only requirement: ffmpeg, which must be installed at C:\ffmpeg\bin (this path is hardcoded; download will fail if ffmpeg isn't there).

Quick start

1. Double-click the .exe.
2. Paste a YouTube URL into the "YouTube網址" field.
3. Leave "存檔路徑" blank to use the Downloads folder, or enter a custom path.
4. Click "下載影片". The status will show "下載中..." then "下載完成！" when done.

FAQ

Q: I get "請輸入YouTube網址" (please enter a URL)?
A: The URL field is empty — paste a link first.

Q: I get "無法下載，請確認輸入是否錯誤"?
A: Common causes:

• Invalid URL or video doesn't exist
• ffmpeg is missing from C:\ffmpeg\bin
• Known issue: when the "存檔路徑" (save path) field is filled in, the app tries to call a string operation on a variable that hasn't been assigned yet, causing an exception and this error. In short, custom save paths don't currently work — only the default (blank = Downloads folder) works.

Q: Where does the downloaded file go?
A: The filename is the video title, and the final extension is always .mp3.