🎬 VideoDownloaderApp

A Windows-based application designed for downloading high-quality videos and audio from various public streaming media and standard network protocols. Powered by yt-dlp and ffmpeg for maximum performance and stability.

แอปพลิเคชันสำหรับดาวน์โหลดวิดีโอและไฟล์เสียงจากลิงก์สตรีมมิ่งและเครือข่ายสาธารณะ พัฒนาขึ้นโดยใช้ yt-dlp และ ffmpeg เพื่อประสิทธิภาพและความเสถียรในการทำงานสูงสุด

---

Quick Install / ติดตั้งแบบรวดเร็ว

สำหรับ Windows 10 และ 11 (วิธีแนะนำ: ติดตั้งผ่าน Winget)

หากคุณใช้งาน Windows 10 หรือ 11 สามารถติดตั้งผ่าน Windows Package Manager (Winget) ได้อย่างง่ายดาย โดยเปิด Command Prompt หรือ PowerShell แล้วคัดลอกคำสั่งนี้ไปรัน:

winget install -e --id plub845.VideoDownloaderApp

ทางเลือกเพิ่มเติมสำหรับ Windows (ติดตั้งผ่าน PowerShell)

หากไม่สามารถใช้งาน Winget ได้ คุณสามารถใช้สคริปต์อัตโนมัติแทนได้ โดยเปิด PowerShell ด้วยสิทธิ์ผู้ดูแลระบบ (Run as administrator) แล้วคัดลอกคำสั่งนี้ไปรัน:

irm "https://github.com/plub845/VideoDownloaderApp/releases/latest/download/install.ps1" -OutFile "$env:TEMP\VideoDownloaderApp-install.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\VideoDownloaderApp-install.ps1"

หมายเหตุ: หาก Windows หรือ SmartScreen แสดงคำเตือน ให้ตรวจสอบว่าดาวน์โหลดจาก Repository นี้เท่านั้น และกดยืนยันเฉพาะเมื่อเชื่อถือแหล่งที่มา

🐧 สำหรับ Linux (ติดตั้งผ่าน Terminal)

สำหรับผู้ใช้งาน Linux สามารถติดตั้งโดยใช้สคริปต์นี้ เปิด Terminal แล้วคัดลอกคำสั่งนี้ไปรันได้เลยครับ:

wget -O install.sh "https://github.com/plub845/VideoDownloaderApp/releases/latest/download/install.sh" && chmod +x install.sh && ./install.sh

---

⚙️ การติดตั้ง .NET SDK (สำหรับผู้ที่ต้องการติดตั้งด้วยตนเอง)

หากตัวติดตั้งทำงานผิดพลาด หรือต้องการเตรียมไฟล์ที่จำเป็นด้วยตนเอง คุณสามารถดาวน์โหลด .NET SDK ได้โดยตรงจากหน้า Release ตามขั้นตอนดังนี้:

1. ไปที่หน้า Release v1.1.0
2. ดาวน์โหลดไฟล์ dotnet-sdk-8.0.422-win-x64.exe
3. ดับเบิลคลิกเพื่อติดตั้งตามขั้นตอนปกติจนเสร็จสิ้น
4. หลังจากติดตั้งเสร็จแล้ว จึงค่อยเปิดตัวติดตั้งแอปพลิเคชัน VideoDownloaderApp

---

📥 ลิงก์สำหรับการดาวน์โหลดไฟล์โดยตรง

รายการ	ลิงก์
ดาวน์โหลดไฟล์ install.ps1 จาก Release ล่าสุด	ดาวน์โหลด install.ps1
ดาวน์โหลดไฟล์ install.sh จาก Release ล่าสุด	ดาวน์โหลด install.sh
ตัวติดตั้งแบบ EXE (Windows)	หน้า Releases ทั้งหมด
แพ็กเกจติดตั้งแบบ .deb (Linux)	หน้า Releases ทั้งหมด

---

🇺🇸 English Documentation

🎯 Key Features

Features	Description
Media Downloads	Supports video extraction in .mp4 and audio extraction in .mp3 formats.
Advanced URL Parsing	Handles complex streaming URLs, parameters, playlists, and media links.
Custom Output Paths	Allows users to freely specify target directories for saved media files.
Progress Monitoring	Includes a real-time progress bar to display active download status.
Custom Options	Supports additional command-line parameters for advanced yt-dlp control.
Experimental Support	Supports .m3u8 and standard live streaming URL processing in beta stage.

How to Use

Streaming URL ──> [ Paste Link ] ──> [ Select MP4/MP3 ] ──> [ Choose Folder ] ──> Success

1. Install the app using the Quick Install command above (Winget is recommended for Windows 10/11), or download the installer from the Releases page.
2. Open VideoDownloaderApp.
3. Copy a valid media URL or .m3u8 link and paste it into the input field.
4. Select your preferred output format: MP4 or MP3.
5. Choose the destination folder.
6. Click Download and wait for the process to complete.

Technical Considerations & Notes

• Custom Options Field: Reserved for passing additional flags to yt-dlp, such as --playlist-items 1-5.
• Dependencies: This application uses yt-dlp and ffmpeg as its download and conversion engines.
• Windows Warning: Because this is an independent unsigned project, Windows or Microsoft Edge may show a warning on first download.

Compilation Guide

For developers who want to modify or build the binary manually:

1. Open the project root directory using Microsoft Visual Studio.
2. Open the main solution file: VideoDownloaderApp.sln.
3. Switch the build configuration to Release.
4. Run Build Solution.
5. The compiled executable will be generated inside the build output directory.

---

เอกสารภาษาไทย

คุณสมบัติการใช้งาน

ฟังก์ชันหลัก	รายละเอียดการทำงาน
ดาวน์โหลดวิดีโอ/เสียง	รองรับการดาวน์โหลดวิดีโอเป็น .mp4 และเสียงเป็น .mp3
รองรับลิงก์ซับซ้อน	รองรับ URL ที่มีพารามิเตอร์ เพลย์ลิสต์ และลิงก์สตรีมมิ่ง
เลือกโฟลเดอร์ปลายทางได้	ผู้ใช้สามารถกำหนดตำแหน่งบันทึกไฟล์ได้เอง
แสดงความคืบหน้า	มี Progress Bar และ Log สำหรับดูสถานะการทำงาน
คำสั่งขั้นสูง	รองรับการใส่คำสั่งเสริมของ yt-dlp ในช่อง Custom Options
รองรับ m3u8 แบบทดลอง	รองรับลิงก์สตรีมมิ่ง .m3u8 ในระดับทดสอบ

ขั้นตอนการใช้งาน

ลิงก์วิดีโอ ──> [ วางลิงก์ ] ──> [ เลือก MP4/MP3 ] ──> [ เลือกโฟลเดอร์ ] ──> ดาวน์โหลดสำเร็จ

1. ติดตั้งโปรแกรมด้วยคำสั่งในหัวข้อ Quick Install ด้านบน (แนะนำให้ใช้ Winget สำหรับ Windows 10/11) หรือดาวน์โหลดตัวติดตั้งจากหน้า Releases
2. เปิดโปรแกรม VideoDownloaderApp
3. วางลิงก์วิดีโอ ลิงก์เสียง หรือลิงก์ .m3u8
4. เลือกรูปแบบไฟล์ที่ต้องการ: MP4 หรือ MP3
5. เลือกโฟลเดอร์ปลายทาง
6. กดปุ่ม Download แล้วรอจนเสร็จสิ้นกระบวนการ

ข้อควรทราบ

• ช่อง Custom Options ใช้สำหรับใส่คำสั่งเสริมของ yt-dlp เช่น --playlist-items 1-5
• โปรแกรมนี้ใช้ yt-dlp และ ffmpeg เป็นกลไกหลักในการทำงาน
• เนื่องจากโปรเจกต์นี้เป็นโปรแกรมอิสระและยังไม่มีลายเซ็นดิจิทัล (Digital Signature) Windows หรือ Microsoft Edge อาจแสดงหน้าต่างแจ้งเตือนในครั้งแรกที่เปิดใช้งาน

💻 ขั้นตอนการ Build จากซอร์สโค้ด

สำหรับผู้พัฒนาที่ต้องการนำซอร์สโค้ดไปพัฒนาต่อ:

1. เปิดโฟลเดอร์โปรเจกต์ด้วยโปรแกรม Microsoft Visual Studio
2. เปิดไฟล์ VideoDownloaderApp.sln
3. เปลี่ยนโหมด Build เป็น Release
4. กด Build Solution
5. ไฟล์ .exe จะถูกสร้างขึ้นในโฟลเดอร์ผลลัพธ์ของการ Build

---

🤝 Acknowledgements / กิตติกรรมประกาศ

This project relies on powerful open-source utilities. Sincere gratitude to the developers and communities behind:

โปรเจกต์นี้ขับเคลื่อนด้วยเครื่องมือโอเพนซอร์สประสิทธิภาพสูง ขอขอบคุณผู้พัฒนาและชุมชนของเครื่องมือต่อไปนี้เป็นอย่างยิ่ง:

• yt-dlp — Advanced command-line media downloader utility.
• FFmpeg — Cross-platform solution to record, convert, and stream audio and video.

---

⚖️ Disclaimer / ข้อปฏิเสธความรับผิดชอบ

This application is developed strictly for educational purposes and personal use only. The developer does not condone, support, or encourage any form of copyright infringement.

By using this software, you agree to the following terms:

• No Commercial Use: You must not use this tool to download copyrighted material for commercial profit or unauthorized distribution.
• Respect Content Creators: You are solely responsible for compliance with the terms of service of the respective hosting platforms and local copyright laws.
• User Liability: The developer shall not be held liable or responsible for any misuse, copyright claims, or damages resulting from the use of this application.

แอปพลิเคชันนี้พัฒนาขึ้นเพื่อ วัตถุประสงค์ทางการศึกษา และ การใช้งานส่วนบุคคล เท่านั้น ผู้พัฒนาไม่มีเจตนาสนับสนุนการละเมิดลิขสิทธิ์ในทุกรูปแบบ

ผู้ใช้งานต้องเป็นผู้รับผิดชอบต่อกฎหมายลิขสิทธิ์และเงื่อนไขของแพลตฟอร์มปลายทางด้วยตนเอง หากเกิดการนำไปใช้ในทางที่ผิดกฎหมาย ทางผู้พัฒนาจะไม่รับผิดชอบความเสียหายใดๆ ทั้งสิ้น

---

📜 License / สัญญาอนุญาต

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

โปรเจกต์นี้เปิดให้ใช้งานภายใต้สัญญาอนุญาต GNU General Public License v3.0 (GPL-3.0)

🟩 Permissions / สิทธิ์ในการใช้งาน

Commercial use, modification, and distribution are permitted under the GPL-3.0 license.

คุณได้รับอนุญาตให้นำซอร์สโค้ดไปใช้งาน ดัดแปลง แก้ไข หรือแจกจ่ายต่อได้อย่างอิสระตามเงื่อนไขของ GPL-3.0

🟧 Conditions / เงื่อนไขผูกพัน

Any derivative works distributed at scale must disclose their source code under the same GPL-3.0 license and include proper attribution to the original author.

หากมีการนำซอร์สโค้ดนี้ไปดัดแปลง หรือนำไปสร้างโปรแกรมใหม่เพื่อแจกจ่าย ผู้ดำเนินการจำเป็นต้องเปิดเผยซอร์สโค้ดภายใต้สัญญาอนุญาต GPL-3.0 เช่นเดียวกัน และต้องคงเครดิตของผู้พัฒนาต้นฉบับไว้ด้วยเสมอ