ภาษาไทย | English

คู่มือการใช้งาน YouTube Access Pro สำหรับ NVDA

เวอร์ชัน 2026.07.19  ·  ผู้พัฒนา: Peem Narkkhwan

YouTube Access Pro เป็นโปรแกรมเสริมสำหรับ NVDA ที่ให้ผู้ใช้สามารถค้นหา เล่น และดาวน์โหลดเนื้อหาจาก YouTube ได้อย่างเต็มรูปแบบ ควบคุมการทำงานทั้งหมดด้วยแป้นพิมพ์โดยไม่ต้องพึ่งเมาส์ พร้อมรองรับการอ่านสถานะโดย NVDA ตลอดการใช้งาน

สารบัญ
  1. ความต้องการของระบบ
  2. การเปิดและปิดหน้าต่าง
  3. โครงสร้างหน้าต่างหลัก
  4. แท็บ Search and Download
  5. แท็บ Playlists
  6. แท็บ Subscriptions (ติดตามช่อง)
  7. คีย์ลัดทั่วทั้งระบบ (Global Hotkeys)
  8. แท็บ Settings
  9. การแก้ปัญหาเบื้องต้น

1. ความต้องการของระบบ

2. การเปิดและปิดหน้าต่าง

การกระทำคีย์ลัด
เปิดหน้าต่างโปรแกรมNVDA+Y
เปิดจากเมนู Tools ของ NVDAเมนู NVDA → Tools → YouTube Access Pro
ซ่อนหน้าต่าง (การเล่นเสียงยังคงดำเนินต่อไป)Escape
ออกจากโปรแกรมปุ่ม Exit ในแต่ละแท็บ หรือ Alt+F4
หมายเหตุ: การซ่อนหน้าต่างไม่หยุดเพลง — เพลงจะเล่นต่อไปในพื้นหลัง หากมีการดาวน์โหลดค้างอยู่ ระบบจะแสดงกล่องยืนยันก่อนออกจากโปรแกรมเสมอ ไม่ว่าจะออกด้วยปุ่ม Exit หรือ Alt+F4
การนำทางด้วย Tab: การกด Tab จะหยุดอยู่ที่ปุ่ม Exit และไม่วนกลับไปจุดเริ่มต้น หากต้องการย้อนกลับให้กด Shift+Tab

3. โครงสร้างหน้าต่างหลัก

หน้าต่างหลักประกอบด้วย 4 แท็บ สลับแท็บด้วย Ctrl+Tab / Ctrl+Shift+Tab หรือกด Ctrl+1 ถึง Ctrl+4 เพื่อไปยังแท็บนั้นโดยตรงตามลำดับต่อไปนี้:

  1. Search and Download — ค้นหา เล่น และดาวน์โหลด
  2. Playlists — จัดการเพลย์ลิสต์ส่วนตัว
  3. Subscriptions — ติดตามช่อง YouTube และเรียกดูเนื้อหาแบบ Videos, Shorts, Live, Playlists
  4. Settings — ตั้งค่าการทำงานของโปรแกรม

กด Ctrl+F จากตำแหน่งใดก็ได้ในหน้าต่างเพื่อไปยังช่องค้นหาโดยตรง

ความช่วยเหลือด่วน: กด Ctrl+F1 ในแท็บใดก็ได้ เพื่อให้โปรแกรมอ่านสรุปวิธีใช้งานและคีย์ลัดของแท็บนั้นทันที เหมาะสำหรับผู้เริ่มใช้งานที่ยังไม่คุ้นเคยกับคู่มือฉบับเต็ม (คีย์ F1 เพียงอย่างเดียวยังคงทำหน้าที่ดาวน์โหลดเป็นเสียงตามปกติ ไม่ได้ถูกแทนที่)
การเปลี่ยนภาษาของโปรแกรม: กด Ctrl+T จากตำแหน่งใดก็ได้ในหน้าต่างเพื่อสลับภาษาที่โปรแกรมแสดงผลและอ่านออกเสียงระหว่างไทยกับอังกฤษ การตั้งค่านี้แยกจากภาษาของ NVDA เอง จึงไม่จำเป็นต้องเปลี่ยนภาษาของ NVDA เพื่อใช้งานโปรแกรมเป็นภาษาไทย ภาษาที่เลือกไว้จะถูกจดจำและใช้ในการเปิดครั้งถัดไปโดยอัตโนมัติ

4. แท็บ Search and Download

4.1 ช่องค้นหา (Search text or paste a link)

4.2 ประเภทการค้นหา (Search type)

เมื่อโฟกัสอยู่ที่ตัวเลือก Search type สามารถกด Enter เพื่อเริ่มค้นหาได้ทันที

การเปิดผลลัพธ์ที่เป็นช่อง (ทั้งจากการค้นหาแบบ Channel และจากการเลือกชื่อผู้อัปโหลดในผลลัพธ์อื่น) จะแสดงรายการคลิปของช่องนั้นในลิสต์เดียวกัน เช่นเดียวกับการเปิดเพลย์ลิสต์ กด Ctrl+S ที่แถวของช่องเพื่อติดตามช่องนั้นได้ทันที โดยไม่จำเป็นต้องเปิดดูคลิปก่อน

4.3 รายการผลการค้นหา

คีย์ลัดการทำงาน
Enter หรือ F7เล่น/หยุดรายการที่เลือก หรือเปิดดูรายการภายในเพลย์ลิสต์
Backspaceย้อนกลับจากมุมมองเพลย์ลิสต์
Spaceหยุดชั่วคราว/เล่นต่อ (ขณะกำลังเล่น)
Homeเพิ่มระดับเสียง (ขณะกำลังเล่น)
Endลดระดับเสียง (ขณะกำลังเล่น)
/ กรอถอยหลัง/เดินหน้า 3 วินาที
Ctrl+← / Ctrl+→กรอถอยหลัง/เดินหน้า 30 วินาที
F8หยุดชั่วคราว/เล่นต่อ
F9เพลงก่อนหน้า (พร้อมอ่านชื่อเพลง)
F10เพลงถัดไป (พร้อมอ่านชื่อเพลง)
F11ลดระดับเสียง
F12เพิ่มระดับเสียง
F1ดาวน์โหลดเป็นไฟล์ MP3
F2ดาวน์โหลดเป็นไฟล์ MP4
F3อ่านสถานะดาวน์โหลดของรายการที่เลือก
F4อ่านจำนวนการดาวน์โหลดที่กำลังดำเนินการทั้งหมด
F5เปิดโฟลเดอร์ดาวน์โหลด
Ctrl+Cคัดลอกลิงก์ของรายการที่เลือก
Ctrl+Bเปิดลิงก์วิดีโอในเบราว์เซอร์
Ctrl+Pเพิ่มวิดีโอที่เลือกเข้าเพลย์ลิสต์
Ctrl+Sติดตามช่องของรายการที่เลือก (ใช้ได้กับวิดีโอ เพลย์ลิสต์ และช่อง)
คีย์ F9/F10 ใช้นำทางระหว่างรายการในผลการค้นหาหรือเพลย์ลิสต์ที่กำลังเล่นอยู่ และจะอ่านชื่อของรายการที่เริ่มเล่นให้ฟังด้วย
รายการนี้มีเมนูเพิ่มเติมที่รวมคำสั่งทั้งหมดข้างต้นไว้ในที่เดียว เปิดได้ด้วยปุ่ม Menu บนคีย์บอร์ด, Shift+F10, หรือการคลิกขวา

5. แท็บ Playlists

ใช้จัดการเพลย์ลิสต์ส่วนตัว โดยแผงด้านซ้ายแสดงรายชื่อเพลย์ลิสต์ และแผงด้านขวาแสดงวิดีโอภายในเพลย์ลิสต์ที่เลือก

5.1 แผงซ้าย — รายชื่อเพลย์ลิสต์

คีย์ลัดการทำงาน
F1ดาวน์โหลดทั้งเพลย์ลิสต์เป็นไฟล์ MP3
F2ดาวน์โหลดทั้งเพลย์ลิสต์เป็นไฟล์ MP4
F3อ่านสถานะดาวน์โหลดของเพลย์ลิสต์
F4อ่านจำนวนการดาวน์โหลดทั้งหมด
F5เปิดโฟลเดอร์ดาวน์โหลด
Deleteลบเพลย์ลิสต์ (ระบบจะถามยืนยันก่อนทุกครั้ง)
R (ไม่สนตัวพิมพ์เล็ก/ใหญ่)เปลี่ยนชื่อเพลย์ลิสต์

5.2 แผงขวา — วิดีโอในเพลย์ลิสต์

คีย์ลัดการทำงาน
Enter หรือ F7เล่นวิดีโอที่เลือก (เล่นต่อเนื่องจากรายการนั้น)
Spaceหยุดชั่วคราว/เล่นต่อ (ขณะกำลังเล่น)
Homeเพิ่มระดับเสียง (ขณะกำลังเล่น)
Endลดระดับเสียง (ขณะกำลังเล่น)
/ กรอถอยหลัง/เดินหน้า 3 วินาที
Ctrl+← / Ctrl+→กรอถอยหลัง/เดินหน้า 30 วินาที
F8หยุดชั่วคราว/เล่นต่อ
F9เพลงก่อนหน้า (พร้อมอ่านชื่อเพลง)
F10เพลงถัดไป (พร้อมอ่านชื่อเพลง)
F11ลดระดับเสียง
F12เพิ่มระดับเสียง
F1ดาวน์โหลดวิดีโอที่เลือกเป็นไฟล์ MP3
F2ดาวน์โหลดวิดีโอที่เลือกเป็นไฟล์ MP4
F3อ่านสถานะดาวน์โหลดของวิดีโอที่เลือก
F4อ่านจำนวนการดาวน์โหลดทั้งหมด
F5เปิดโฟลเดอร์ดาวน์โหลด
Deleteลบวิดีโอออกจากเพลย์ลิสต์ (ระบบจะถามยืนยันก่อนทุกครั้ง)
Ctrl+Cคัดลอกลิงก์วิดีโอที่เลือก
ทั้งรายชื่อเพลย์ลิสต์และรายการวิดีโอมีเมนูเพิ่มเติมเช่นกัน เปิดได้ด้วยปุ่ม Menu, Shift+F10, หรือการคลิกขวา

6. แท็บ Subscriptions (ติดตามช่อง)

ใช้ติดตามช่อง YouTube ที่ชื่นชอบ แล้วเรียกดูเนื้อหาของช่องนั้นในรูปแบบเดียวกับ YouTube เอง คือแบ่งเป็นหมวด Videos, Shorts, Live และ Playlists โดยไม่ต้องค้นหาชื่อช่องซ้ำทุกครั้ง

วิธีเริ่มติดตามช่อง: ไปที่แท็บ Search and Download ค้นหาคลิปของช่องที่ต้องการ (หรือค้นหาแบบ Channel โดยตรง) แล้วกด Ctrl+S ที่รายการนั้น

6.1 รายการช่องที่ติดตาม

คีย์ลัดการทำงาน
Enterเปิดดูเนื้อหาของช่องนั้น (ไปยังหมวด Videos/Shorts/Live/Playlists)
F1ดาวน์โหลดคลิปล่าสุดทั้งหมดของช่องนี้เป็นไฟล์ MP3
F2ดาวน์โหลดคลิปล่าสุดทั้งหมดของช่องนี้เป็นไฟล์ MP4
F3อ่านสถานะดาวน์โหลดของช่องนี้
Deleteเลิกติดตามช่อง (ระบบจะถามยืนยันก่อนทุกครั้ง)
Spaceหยุดชั่วคราว/เล่นต่อ (ขณะกำลังเล่น)
Homeเพิ่มระดับเสียง (ขณะกำลังเล่น)
Endลดระดับเสียง (ขณะกำลังเล่น)

6.2 การไล่ดูหมวดหมู่ของช่อง

เมื่อกด Enter บนช่องในรายการหัวข้อ 6.1 รายการทางขวาจะแสดงหมวดของช่องนั้นก่อน ได้แก่ Videos, Shorts, Live และ Playlists กด Enter บนหมวดใดเพื่อเปิดดู

6.3 เมื่อเปิดดูรายการคลิปแล้ว

คีย์ลัดการทำงาน
Enter หรือ F7เล่น/หยุดคลิปที่เลือก
Backspaceย้อนกลับขึ้นไปหนึ่งชั้น
Spaceหยุดชั่วคราว/เล่นต่อ (ขณะกำลังเล่น)
Homeเพิ่มระดับเสียง (ขณะกำลังเล่น)
Endลดระดับเสียง (ขณะกำลังเล่น)
/ กรอถอยหลัง/เดินหน้า 3 วินาที
Ctrl+← / Ctrl+→กรอถอยหลัง/เดินหน้า 30 วินาที
F8หยุดชั่วคราว/เล่นต่อ
F9เพลงก่อนหน้า (พร้อมอ่านชื่อเพลง)
F10เพลงถัดไป (พร้อมอ่านชื่อเพลง)
F11ลดระดับเสียง
F12เพิ่มระดับเสียง
F1ดาวน์โหลดคลิปที่เลือกเป็นไฟล์ MP3
F2ดาวน์โหลดคลิปที่เลือกเป็นไฟล์ MP4
F3อ่านสถานะดาวน์โหลดของคลิปที่เลือก
F4อ่านจำนวนการดาวน์โหลดที่กำลังดำเนินการทั้งหมด
F5เปิดโฟลเดอร์ดาวน์โหลด
Ctrl+Cคัดลอกลิงก์ของคลิปที่เลือก
ดาวน์โหลดที่เริ่มจากแท็บนี้ (ทั้งทีละคลิปด้วย F1/F2 หรือทั้งช่องด้วย F1/F2 บนรายการช่อง) จะถูกจัดเก็บลงในโฟลเดอร์ย่อยที่ตั้งชื่อตามช่องนั้นโดยอัตโนมัติ เช่นเดียวกับที่แท็บ Playlists จัดเก็บตามชื่อเพลย์ลิสต์
ทั้งรายชื่อช่องและรายการคลิปมีเมนูเพิ่มเติมเช่นกัน เปิดได้ด้วยปุ่ม Menu, Shift+F10, หรือการคลิกขวา

7. คีย์ลัดทั่วทั้งระบบ (Global Hotkeys)

คีย์ลัดกลุ่มนี้ใช้งานได้จากทุกโปรแกรม เมื่อเปิดตัวเลือก Enable global player hotkeys ไว้ในแท็บ Settings (คีย์ควบคุมการเล่นส่วนใหญ่ต้องมี mpv กำลังเล่นอยู่ด้วย ยกเว้นกลุ่มตัวจับเวลาปิด — ดูหมายเหตุด้านล่าง)

คีย์ลัดการทำงาน
NVDA+Yเปิด/แสดงหน้าต่างโปรแกรม (ใช้งานได้เสมอ)
F7หยุดเล่น
Shift+F7เล่นซ้ำรายการล่าสุด
F8หยุดชั่วคราว/เล่นต่อ
F9เพลงก่อนหน้า (พร้อมอ่านชื่อเพลง)
F10เพลงถัดไป (พร้อมอ่านชื่อเพลง)
Shift+F9กรอถอยหลัง 30 วินาที
Shift+F10กรอเดินหน้า 30 วินาที
F11ลดระดับเสียง
F12เพิ่มระดับเสียง
Shift+F11ลดความเร็วการเล่น
Shift+F12เพิ่มความเร็วการเล่น
F6เพิ่มเวลาของตัวจับเวลาปิดครั้งละ 5 นาที
Shift+F6ลดเวลาของตัวจับเวลาปิดครั้งละ 5 นาที
Ctrl+F6แจ้งเวลาที่เหลือก่อนตัวจับเวลาปิดจะทำงาน (นาที:วินาที)
หมายเหตุ: NVDA+Y ใช้งานได้เสมอโดยไม่ขึ้นกับการตั้งค่านี้ ส่วนคีย์กลุ่ม F7F12 จะทำงานเมื่อเปิด "Enable global player hotkeys" และมี mpv กำลังเล่นอยู่เท่านั้น ในขณะที่ F6, Shift+F6 และ Ctrl+F6 ต้องการเพียงเปิดตัวเลือกดังกล่าว และทำงานได้ไม่ว่าขณะนั้นจะกำลังเล่นเพลงอยู่หรือไม่ เนื่องจากตัวจับเวลาปิดเป็นอิสระจากสถานะการเล่น ตัวจับเวลาจะเริ่มนับตั้งแต่ตอนตั้งค่าและจะไม่ถูกรีเซ็ตจนกว่าจะมีการตั้งเวลาใหม่อีกครั้ง เมื่อเปิดตัวเลือกเตือนล่วงหน้าไว้ในแท็บ Settings จะมีเสียงพูดแจ้งเมื่อเหลือเวลา 1 นาที และเสียงบี๊บสั้นนับถอยหลังทีละวินาทีในช่วง 10 วินาทีสุดท้าย เมื่อถึงเวลาปิดจริงจะมีเสียงพูดแจ้งพร้อมเสียงบี๊บยาวหนึ่งครั้งเสมอ ไม่ว่าจะเปิดตัวเลือกเตือนล่วงหน้านี้ไว้หรือไม่ก็ตาม

8. แท็บ Settings

ตัวเลือกคำอธิบาย
Download folderโฟลเดอร์สำหรับบันทึกไฟล์ที่ดาวน์โหลด
Video resolutionความละเอียดวิดีโอสำหรับการดาวน์โหลด MP4
Audio quality bitrateคุณภาพเสียงสำหรับการดาวน์โหลด MP3
Search result limitจำนวนผลการค้นหาสูงสุดที่แสดง
Announce player hotkeysกำหนดให้ NVDA อ่านสถานะเมื่อกดคีย์ลัดควบคุมการเล่น รวมถึงการกรอเดินหน้า/ถอยหลัง (ลูกศรซ้าย/ขวา, Shift+F9/F10) และการปรับเสียง (Home/End, F11/F12) ปิดตัวเลือกนี้เพื่อให้คีย์เหล่านี้ทำงานแบบเงียบ ส่วนคีย์ตัวจับเวลาปิด (F6/Shift+F6/Ctrl+F6) จะอ่านผลลัพธ์เสมอไม่ว่าจะตั้งค่านี้ไว้อย่างไร เนื่องจากเป็นวิธีเดียวที่จะทราบเวลาที่ตั้งไว้
Enable global player hotkeys outside this windowเปิดใช้คีย์ลัดกลุ่ม F6F12 ทั่วทั้งระบบ โดย F7F12 ต้องมีเสียงกำลังเล่นอยู่ ส่วนกลุ่มตัวจับเวลาปิด (F6/Shift+F6/Ctrl+F6) ใช้ได้ไม่ว่าจะกำลังเล่นอยู่หรือไม่
Automatically play the next item when the current one endsเล่นรายการถัดไปโดยอัตโนมัติเมื่อรายการปัจจุบันจบ (ปิดไว้เป็นค่าเริ่มต้น)
Play advance warnings before the sleep timer stops playbackแจ้งเตือนล่วงหน้าก่อนตัวจับเวลาปิดจะหยุดเล่นเพลง ด้วยเสียงพูดเมื่อเหลือ 1 นาที และเสียงบี๊บสั้นนับถอยหลังทีละวินาทีในช่วง 10 วินาทีสุดท้าย การปิดตัวเลือกนี้จะข้ามเฉพาะสองส่วนดังกล่าว ส่วนเสียงพูดแจ้งพร้อมเสียงบี๊บยาวหนึ่งครั้งเมื่อถึงเวลาปิดจริงจะยังคงทำงานเสมอ (เปิดไว้เป็นค่าเริ่มต้น)
Export subscriptionsบันทึกรายชื่อช่องที่ติดตามทั้งหมดเป็นไฟล์ .json ตามตำแหน่งที่เลือก สำหรับสำรองข้อมูลหรือย้ายไปใช้งานบนเครื่องอื่น
Import subscriptionsเพิ่มรายชื่อช่องจากไฟล์ .json ที่เคยส่งออกไว้เข้าสู่รายการติดตามปัจจุบัน โดยไม่ลบช่องที่ติดตามอยู่แล้ว
yt-dlp libraryแสดงเวอร์ชันของไลบรารี yt-dlp ที่ใช้งานอยู่ในปัจจุบัน
Automatically check for yt-dlp updatesตรวจสอบอัปเดตของ yt-dlp โดยอัตโนมัติหลังเปิดหน้าต่างไม่นาน หากพบเวอร์ชันใหม่จะตรวจสอบค่า sha256 ก่อนติดตั้งเสมอ (เปิดไว้เป็นค่าเริ่มต้น)
Check for update nowตรวจสอบอัปเดตของ yt-dlp ทันที โดยไม่ต้องรอการตรวจสอบอัตโนมัติ

กดปุ่ม Save settings เพื่อบันทึกการตั้งค่า

9. การแก้ปัญหาเบื้องต้น

ปัญหาวิธีแก้ไข
เปิดเบราว์เซอร์แทนที่จะเล่นด้วย mpvตรวจสอบว่ามีไฟล์ mpv อยู่ในโฟลเดอร์ lib ของโปรแกรมเสริมครบถ้วน
กด F5 แล้วไม่เปิดโฟลเดอร์มีการดาวน์โหลดกำลังดำเนินการอยู่ กรุณารอให้เสร็จสิ้นก่อน
F9/F10 ไม่ทำงานเมื่อใช้แบบทั่วทั้งระบบเปิดตัวเลือก "Enable global player hotkeys" ในแท็บ Settings
ต้องการกลับไปยังช่องค้นหาอย่างรวดเร็วกด Ctrl+F จากตำแหน่งใดก็ได้ในหน้าต่าง
ต้องการทราบจำนวนการดาวน์โหลดที่กำลังทำงานกด F4 เพื่ออ่านจำนวนการดาวน์โหลดทั้งหมด หรือ F3 บนรายการที่ต้องการเพื่ออ่านสถานะของรายการนั้นโดยเฉพาะ

User Guide — YouTube Access Pro Add-on for NVDA

Version 2026.07.19  ·  Author: Peem Narkkhwan

YouTube Access Pro is an NVDA add-on that gives users full access to YouTube: searching, playing, and downloading content entirely from the keyboard, with complete NVDA speech feedback throughout.

Contents
  1. Requirements
  2. Opening and Closing the Window
  3. Main Window Structure
  4. Search and Download Tab
  5. Playlists Tab
  6. Subscriptions Tab
  7. Global Hotkeys
  8. Settings Tab
  9. Troubleshooting

1. Requirements

2. Opening and Closing the Window

ActionShortcut
Open the add-on windowNVDA+Y
Open from the NVDA menuNVDA Menu → Tools → YouTube Access Pro
Hide the window (playback continues)Escape
Exit the add-onExit button on any tab, or Alt+F4
Note: Hiding the window does not stop playback; audio continues in the background. If a download is still active, a confirmation dialog always appears before exiting, whether triggered by the Exit button or Alt+F4.
Tab navigation: Pressing Tab stops at the Exit button and does not wrap back to the start. Press Shift+Tab to navigate backwards.

3. Main Window Structure

The window contains four tabs. Switch between them with Ctrl+Tab / Ctrl+Shift+Tab, or press Ctrl+1 through Ctrl+4 to jump directly to a tab in this order:

  1. Search and Download — search, play, and download
  2. Playlists — manage local playlists
  3. Subscriptions — follow YouTube channels and browse their Videos, Shorts, Live, and Playlists
  4. Settings — configure the add-on

Press Ctrl+F from anywhere in the window to jump directly to the search field.

Quick help: Press Ctrl+F1 on any tab to have the add-on speak a summary of that tab's usage and shortcuts immediately — useful for new users who have not yet read the full guide. Plain F1 is unaffected and still downloads as audio.
Switching the add-on's language: Press Ctrl+T from anywhere in the window to switch the add-on's displayed and spoken language between Thai and English. This setting is independent of NVDA's own language, so NVDA does not need to be set to Thai to use the add-on in Thai. The selected language is remembered and used automatically the next time the window opens.

4. Search and Download Tab

4.1 Search Field

4.2 Search Type

When focus is on the Search type control, press Enter to search immediately.

Opening a channel result — whether from a Channel search or from an uploader name elsewhere — shows that channel's videos in the same list, the same way opening a playlist does. Press Ctrl+S on a channel row to subscribe to it immediately, without opening its videos first.

4.3 Results List

KeyAction
Enter / F7Play/stop the selected item, or open a playlist's contents
BackspaceGo back from playlist view
SpacePause / resume (while playing)
HomeVolume up (while playing)
EndVolume down (while playing)
/ Seek −3 s / +3 s
Ctrl+← / Ctrl+→Seek −30 s / +30 s
F8Pause / resume
F9Previous track (announces title)
F10Next track (announces title)
F11Volume down
F12Volume up
F1Download as MP3
F2Download as MP4
F3Announce the selected item's download status
F4Announce the total number of active downloads
F5Open the download folder
Ctrl+CCopy the selected item's link
Ctrl+BOpen the video link in a browser
Ctrl+PAdd the selected video to a playlist
Ctrl+SSubscribe to the channel of the selected item (works on videos, playlists, and channels)
F9/F10 navigate between items in the current search results or playlist, and announce the title of whatever starts playing.
This list also has a context menu containing all of the commands above. Open it with the Menu key, Shift+F10, or a right-click.

5. Playlists Tab

Manage local playlists. The left pane lists playlists; the right pane lists the videos in the selected playlist.

5.1 Left Pane — Playlist List

KeyAction
F1Download the entire playlist as MP3
F2Download the entire playlist as MP4
F3Announce the playlist's download status
F4Announce the total number of active downloads
F5Open the download folder
DeleteDelete the selected playlist (always asks for confirmation)
R (not case-sensitive)Rename the selected playlist

5.2 Right Pane — Videos in Playlist

KeyAction
Enter / F7Play starting from the selected item
SpacePause / resume (while playing)
HomeVolume up (while playing)
EndVolume down (while playing)
/ Seek −3 s / +3 s
Ctrl+← / Ctrl+→Seek −30 s / +30 s
F8Pause / resume
F9Previous track (announces title)
F10Next track (announces title)
F11Volume down
F12Volume up
F1Download the selected video as MP3
F2Download the selected video as MP4
F3Announce the selected video's download status
F4Announce the total number of active downloads
F5Open the download folder
DeleteRemove the video from the playlist (always asks for confirmation)
Ctrl+CCopy the selected video's link
Both the playlist list and the video list also have a context menu. Open it with the Menu key, Shift+F10, or a right-click.

6. Subscriptions Tab

Subscribe to favorite YouTube channels and browse their content the same way YouTube itself does, split into Videos, Shorts, Live, and Playlists sections, without retyping the channel name each time.

To subscribe: in the Search and Download tab, find a video from the channel of interest (or search directly using the Channel search type), then press Ctrl+S on that result.

6.1 Subscribed Channels List

KeyAction
EnterBrowse that channel (opens its Videos/Shorts/Live/Playlists sections)
F1Download all of this channel's latest videos as MP3
F2Download all of this channel's latest videos as MP4
F3Announce this channel's download status
DeleteUnsubscribe from the channel (always asks for confirmation)
SpacePause / resume (while something is playing)
HomeVolume up (while something is playing)
EndVolume down (while something is playing)

6.2 Browsing a Channel's Sections

Pressing Enter on a channel in section 6.1 shows that channel's sections first: Videos, Shorts, Live, and Playlists. Press Enter on a section to open it.

6.3 Once a Video List Is Shown

KeyAction
Enter / F7Play/stop the selected video
BackspaceGo back up one level
SpacePause / resume (while something is playing)
HomeVolume up (while something is playing)
EndVolume down (while something is playing)
/ Seek −3 s / +3 s
Ctrl+← / Ctrl+→Seek −30 s / +30 s
F8Pause / resume
F9Previous track (announces title)
F10Next track (announces title)
F11Volume down
F12Volume up
F1Download the selected video as MP3
F2Download the selected video as MP4
F3Announce the selected video's download status
F4Announce the total number of active downloads
F5Open the download folder
Ctrl+CCopy the selected video's link
Downloads started from this tab — individually with F1/F2, or in bulk from the channel list — are automatically saved into a subfolder named after that channel, the same way the Playlists tab organizes downloads by playlist name.
Both the channel list and the video list also have a context menu. Open it with the Menu key, Shift+F10, or a right-click.

7. Global Hotkeys

These shortcuts work system-wide when Enable global player hotkeys is turned on in Settings. Most of them also require mpv to be actively playing, except the sleep timer group — see the note below.

KeyAction
NVDA+YOpen / show the add-on window (always available)
F7Stop playback
Shift+F7Replay the last item
F8Pause / resume
F9Previous track (announces title)
F10Next track (announces title)
Shift+F9Seek backward 30 seconds
Shift+F10Seek forward 30 seconds
F11Volume down
F12Volume up
Shift+F11Decrease playback speed
Shift+F12Increase playback speed
F6Increase the sleep timer by 5 minutes
Shift+F6Decrease the sleep timer by 5 minutes
Ctrl+F6Announce the exact time remaining before the sleep timer fires (minutes:seconds)
Note: NVDA+Y always works regardless of this setting. The F7F12 keys require both "Enable global player hotkeys" to be on and mpv to be actively playing. F6, Shift+F6, and Ctrl+F6 only require the setting to be on — they work whether or not anything is currently playing, since the sleep timer is independent of playback state. The timer starts counting from the moment it is set and is not reset until set again. When "Play advance warnings..." is on in Settings, a spoken notice plays at 1 minute remaining, followed by a short beep once per second for the final 10 seconds. The moment playback actually stops, a spoken announcement and one longer confirmation beep always play, regardless of that setting.

8. Settings Tab

OptionDescription
Download folderThe folder where downloaded files are saved
Video resolutionResolution used for MP4 downloads
Audio quality bitrateBitrate used for MP3 downloads
Search result limitMaximum number of search results shown
Announce player hotkeysMakes NVDA speak feedback for player keys, including seek (Left/Right, Shift+F9/F10) and volume (Home/End, F11/F12). Turn this off for silent operation of those keys. The sleep timer keys (F6/Shift+F6/Ctrl+F6) always announce their result regardless of this setting, since that is the only way to know what value was just set.
Enable global player hotkeys outside this windowEnables the F6F12 shortcuts system-wide. F7F12 require audio to be actively playing; the sleep timer group (F6/Shift+F6/Ctrl+F6) works either way.
Automatically play the next item when the current one endsAutomatically continues to the next item when playback ends (off by default)
Play advance warnings before the sleep timer stops playbackPlays a spoken notice at 1 minute remaining, plus a short beep once per second for the final 10 seconds. Turning this off skips only those two warnings — the spoken announcement and confirmation beep when playback actually stops still always play (on by default).
Export subscriptionsSaves the full list of followed channels to a .json file of your choosing, for backup or moving to another computer
Import subscriptionsAdds channels from a previously exported .json file into the current subscriptions list, without removing any already followed
yt-dlp libraryShows the version of the bundled yt-dlp library currently in use
Automatically check for yt-dlp updatesChecks for a newer yt-dlp release shortly after the window opens; any update found is verified against its published sha256 checksum before installing (on by default)
Check for update nowRuns the same update check immediately instead of waiting for the automatic check

Press Save settings to apply changes.

9. Troubleshooting

ProblemSolution
A browser opens instead of playing through mpvCheck that the mpv files are present in the add-on's lib folder
F5 does not open the download folderA download is still in progress; wait for it to finish
F9/F10 do not work as global shortcutsTurn on "Enable global player hotkeys" in Settings
Need to jump to the search field quicklyPress Ctrl+F from anywhere in the window
Want to check how many downloads are activePress F4 for the total active count, or F3 on a specific item for its own status