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.