VidFetch guide

A friendly, step-by-step guide to enjoying YouTube, and keeping what you want from it, with a screen reader and the keyboard.

By Laurent Cadet de Fontenay, with assistance from Claude. Version 0.7.0-beta.1, a beta: please say what goes wrong.

Contents

About this guide

This guide is for anyone new to VidFetch, and especially for people who use a screen reader such as JAWS, NVDA or Narrator.

Why use VidFetch?

YouTube's website is a crowded place to reach with a screen reader. There is a lot to wade through before you get to the thing you came for, and parts of it, such as the related videos and the comments, many of us simply never bother with.

VidFetch puts YouTube into plain lists and keys. Search and you get a list. Press Enter and it plays, in a window with simple keys for moving about, changing the speed and skipping to the next. Related videos, comments and a video's whole transcript are a keystroke away. You can follow channels with no Google account at all, and keep what you like as sound or video files of your own. It can also download from many other video sites.

It is one small program using real Windows controls, with nothing to install, and it has been tested with JAWS, NVDA and Narrator.

Words you will meet

Part 1: Getting started

Tutorial 1: Get VidFetch and start it

  1. Go to the VidFetch releases page. Under the newest release there are two files. vidfetch.exe is the program itself. vidfetch.zip is the same thing zipped, which is easier if your browser refuses to keep a program: Microsoft Edge in particular makes that a fiddly job with a screen reader.
  2. Put vidfetch.exe in a folder of its own, for example in Documents, and run it. If you took the zip, extract it first.
  3. VidFetch is not yet signed with a certificate, so the first time, Windows may say "Windows protected your PC". Choose More info, then Run anyway. You will only be asked once. Windows Defender may then take about ten seconds to look it over before the window opens.
  4. A welcome message appears. Read it with the arrow keys and press Enter.

You are now in the main window. Its list of downloads is empty for now.

Tutorial 2: Find something and listen to it

  1. Press Ctrl+F. Type what you are looking for and press Enter. The other boxes in this window are optional, and you can come back to them another time.
  2. The first time you listen, VidFetch asks to fetch yt-dlp. Say yes.
  3. The YouTube window opens with a list of videos. Move through it with the Up and Down arrows. Each line has the title, the channel, the length and how old it is.
  4. Press Enter on one. You hear "Please wait", and then it plays.
  5. Try the keys: Left and Right move 2 seconds, Up and Down change the volume, Shift with Up and Down the speed, T says how far along you are, and Page Down goes to the next video in the list.
  6. Escape closes the player, and you are back on the same video. Press Enter and it carries on where you stopped.

Two keys are worth learning now. Backspace goes back one list. Escape stops or leaves: it closes the YouTube window from whichever list you are in.

Tutorial 3: Download what you want to keep

  1. In the YouTube window, on a video, press Ctrl+D. It starts at once, as sound only. You can carry on listening or searching while it runs.
  2. VidFetch tells you when it has finished. Press Escape to get back to the main window, and the download is in the list. Enter plays it.
  3. To have the picture as well from now on, choose Options menu, Download as, Video.

To download from an address instead, copy it in your browser with Alt+D then Ctrl+C, press Ctrl+N in VidFetch, where the address is already filled in, and press Enter. A whole playlist works the same way, and gets a folder of its own.

Part 2: Enjoying YouTube

Tutorial 4: Wander through related videos

On any video, press Ctrl+R to list what YouTube suggests beside it. Press Ctrl+R again on one of those to go further, as far as you like. Backspace comes back a step at a time. It also works on a download from YouTube in the main window.

Tutorial 5: Read the comments and the transcript

  1. On a video, press Ctrl+K. After a moment a window opens with the first 100 comments, each with who wrote it, when, and how many liked it. Read with the arrow keys and press Escape when you are done.
  2. Press Ctrl+T for the transcript: everything said in the video, with times, if the video has captions. It needs no download.
  3. In either window, Copy all text (Alt+O) puts it all on the clipboard, handy for pasting a long transcript into an AI assistant for a summary.

Tutorial 6: Follow a channel, without an account

  1. On a video by a channel you like, press Shift+F10 and choose Follow channel. Or search with Look for set to Channels.
  2. Ctrl+L shows the latest from every channel you follow, newest first. Those you have not seen start with the word New.
  3. Ctrl+Shift+L lists your channels. Enter on one shows its videos, More near the end fetches older ones, and the last line has its playlists. Ctrl+Shift+F searches within it.

Your list stays on your computer. YouTube is never told who you are.

Tutorial 7: Bring in your YouTube subscriptions

If you subscribe to channels on YouTube, you need not follow them again one at a time. Google will give you the list, through its service called Takeout. It takes a few minutes, and Google sends an email when the file is ready. Google changes its pages from time to time, so the wording may differ a little.

  1. In your browser, go to takeout.google.com, and sign in to the Google account you use for YouTube.
  2. Under "Create a new export", press the "Deselect all" button. Otherwise Google would export your mail, your photos and everything else.
  3. Find the checkbox "YouTube and YouTube Music", far down the page, and check it.
  4. Just below it is a button called "All YouTube data included". Press it. In the window that opens, uncheck everything except "subscriptions", and press OK.
  5. Go to the "Next step" button at the bottom and press it. Leave the choices as they are: send the download link by email, export once, as a .zip file. Press "Create export".
  6. When the email arrives, usually within a few minutes, follow its link and download the zip file. Google may ask for your password again.
  7. In VidFetch's main window, choose File menu, Import channels from a file. Choose the zip file. There is no need to extract it.
  8. VidFetch says how many channels were new. Ctrl+Shift+L lists them, and Ctrl+L shows what is new from them.

VidFetch also reads the export files of FreeTube, a private YouTube program for computers, and of NewPipe, one for Android phones, so you can bring your channels from those too. File menu, Save a backup of your channels writes a file that VidFetch, NewPipe and FreeTube can read.

Tutorial 8: Listen to an address from your browser or another site

  1. Copy the address, press Ctrl+N, and press Alt+L, Listen without downloading.
  2. A single video plays. The address of a YouTube playlist or channel opens its list of videos in the YouTube window.
  3. While it plays, Ctrl+D downloads it after all.

Part 3: Everything in detail

The rest of this guide describes each part of VidFetch in full.

Downloading a video or a playlist

  1. In the browser, open the video or the playlist, and copy its address with Alt+D then Ctrl+C.
  2. In VidFetch, press Ctrl+N, New download. The address on the clipboard is already in the web address box, chosen, so pasting or typing another replaces it.
  3. Press Enter to start. Tab first if you want to check how it will be saved: the next two boxes are Download as (Alt+A) and Picture quality (Alt+Q), changed with the arrow keys, and the What will happen box (Alt+H) says what this address is and where the download goes.

A YouTube video that is part of a playlist, such as one opened from the playlist's page, has both in its address. VidFetch then asks whether to download the whole playlist or just this video; Enter, or Escape, downloads just the video. A YouTube mix, the endless list YouTube makes for a video, is never taken as a playlist.

The Status box says how far the download has got. Escape stops it. When it is done, VidFetch says so, and the download is chosen in the list: Enter plays it.

If you ask for a video you already have, at the same format and quality, VidFetch asks whether to download it again; Enter, or Escape, cancels, and the copy you have is chosen in the list. A different format or picture quality just downloads. VidFetch remembers a download if you rename it in VidFetch, but not if you rename or move it in File Explorer.

The queue

While one download runs, press Ctrl+N for the next, or Ctrl+U on a playlist: it waits its turn, with the choices it had when you asked for it. The downloads that follow start by themselves, without a word; VidFetch says when each one finishes, and the Status box says how far the current one has got and how many more are waiting.

Escape stops only the download running now, and the next one starts. Show queue (Ctrl+Q) lists what is running and what is waiting; Delete takes the chosen one out, and Remove all empties the queue. So to stop everything, press Ctrl+Q, remove all, close it, and press Escape.

The queue shows each download's title, once it is known: a few seconds after it is added, or longer for a playlist or another site. Until then it shows the address.

If a download fails, the others carry on, and VidFetch says why once they are all done.

The queue is kept when VidFetch closes, with the download that was running. VidFetch asks before exiting while something runs or waits, and the next time it starts, it lists what had not finished and asks whether to carry on downloading or empty the queue. A download that was stopped half way starts again from the beginning; a playlist carries on with the videos it does not have yet. Empty queue, in the Download menu, takes out everything waiting at any time, after asking.

Playlists and channels

A playlist's videos are downloaded one after the other into a folder named after the playlist. Their files start with their place in the playlist, such as 03 - Title.mp4, so they sort in its order; Number the files of a playlist, in the Options menu, turns that off. A channel's address, such as its Videos page, works the same way.

A video that cannot be downloaded, because it is private or was removed, does not stop the rest. The report at the end lists each one with the reason.

Stopping keeps every video already saved. To carry on, or to fetch videos added to the playlist since, choose the playlist in the list and press Ctrl+U, Update playlist: only the videos not yet in its folder are downloaded. The folder holds a small file, VidFetch.json, which records which videos are there. You can rename the folder as you like, in VidFetch or in File Explorer, but keep that file in it.

Playing

Enter on a download plays it in VidFetch's own Play window, which opens at once. Its title says what is playing. It carries on from where you stopped last time, without a word, so that nothing talks over the sound; T says where you are and Home goes to the start. Stopping within 10 seconds of the start or the end is not remembered, so a finished one starts again.

Cut silences when playing, in the Options menu, is off to begin with. When it is on, every silence is cut down to a second; where playing is still counts the time cut.

The Play window plays the sound only, of a video too. To see a video's picture, choose Open video using default media player in its context menu or the Download menu, which plays it in the program Windows plays it with.

What the keys do is also in the Keys box (Alt+K) of the Play window.

A few YouTube videos will not stream, because of how YouTube's file for them is made, or because YouTube refuses for a moment. VidFetch says so, fetches the whole of the sound first, and then plays it. For a long video that can take a little while, the first time on any day. A download of such a video is not affected.

If a file has gone

If a download has gone from its folder, because you deleted it in File Explorer for example, it stays at the end of the main list as "no longer on this computer". Enter downloads it again, into the same folder; Delete takes it off the list. Deleting in VidFetch forgets it at once.

Listening to an address

In New download (Ctrl+N), Listen without downloading (Alt+L) plays the sound of the video whose address you gave, from YouTube or another site, in the Play window. Ctrl+D there downloads it after all.

The YouTube window

What comes from YouTube has a window of its own, in front of the main one, which waits behind it. Downloads carry on meanwhile. It opens with Search YouTube (Ctrl+F), New videos from channels (Ctrl+L), Your channels (Ctrl+Shift+L) or Recently played (Ctrl+H), in the main window's YouTube menu or in its own Go menu (Alt+G). Its title and its list's name say what it shows.

Ctrl+F opens Search YouTube. Besides what to search for, you can choose to look for videos, channels or playlists; to sort by most relevant, most popular or newest; when videos were uploaded; their length; and to leave out YouTube Shorts. YouTube itself no longer sorts results by date, so Newest first arranges each page of what it finds. For truly recent videos, also choose Today, This week or This month under Videos uploaded. Your choices stay until VidFetch closes. A live stream is listed as "live now": VidFetch cannot play or download it while it is live.

A channel's list has its latest videos; More, near the end, fetches older ones.

Searching asks YouTube directly, which is quick; if that ever fails, it searches with yt-dlp instead, which is slower. The last line, More, fetches the next page when you press Enter on it.

Following channels

VidFetch keeps its own list of channels you follow, with no account and no signing in. To follow a channel:

Ctrl+L, New videos from channels, fetches the latest videos of every channel you follow and lists them, newest first. Those that were not there when you last pressed Ctrl+L start with "New". Channels are only checked when you ask.

Ctrl+Shift+L, Your channels, lists the channels you follow. Enter on one shows its latest videos; Delete stops following it, after asking.

The last line of a channel's videos is its playlists. Enter lists them, each with how many videos it has; Enter on one shows its videos in its order, and Ctrl+D downloads it whole, after asking.

Bringing your channels in. Tutorial 7 goes through this step by step. Import channels, in the File menu, reads the zip file from Google Takeout, or subscriptions.csv from inside it, the export files of FreeTube and NewPipe, and an OPML list. Those you already follow stay as they are.

Recently played

Ctrl+H lists, in the YouTube window, the last hundred things you played, downloads and videos online alike, newest first, each with where you stopped. Enter carries on from there; Delete takes one off the list, and deletes nothing. Enter on a download whose file has gone offers to download it again, if it came from YouTube.

Categories

Categories are folders inside the output folder, so File Explorer shows the same as VidFetch. Downloads that are in no category are in a folder called Uncategorised. The first time VidFetch starts with categories, it moves the downloads already in the output folder into Uncategorised, and says so.

A playlist's videos

Enter on a playlist shows its videos in the list, in the playlist's order, in place of all downloads; the list's name says which playlist it is. Everything works on them as on any download: Enter plays, F2 renames, Delete deletes, and the context menu has the rest. Backspace goes back to all downloads, on that playlist. Escape always stops the download running, here too.

A video deleted from a playlist's folder is not downloaded again when you update the playlist.

Video or sound only

Download as, in the Options menu and in the New download window:

Picture quality is how many lines high the picture is at most: 360, 480, 720 or 1080. Higher is sharper and larger. YouTube offers the kind of picture an MP4 holds up to 1080 lines; a video that is only in higher quality comes down at the best it has up to that.

Each file is tagged with its title, the channel that put it online, the year, and the address it came from; a playlist's videos also with the playlist's name as the album and their place as the track number. Media players and File Explorer show these.

Captions

Save captions, in the Options menu and the New download window, is off to begin with. When it is on, each download's captions are saved beside it as an SRT file, which media players show, such as Title.en.srt for Title.mp4. A person's captions are chosen when there are some in the video's language or in English, otherwise the site's automatic ones, in the language spoken. When a video has none, or the site refuses them, VidFetch says so, and the download itself is kept. Renaming or deleting a download in VidFetch does the same to its captions.

Show captions, in the Download menu and the context menu, shows a download's saved captions as running text, in paragraphs, each starting with its time, such as [1:23], to read with the arrow keys.

In the captions, a description, or any other message, Copy all text (Alt+O) copies all of it. To copy a part, select it and press Ctrl+C.

The main window

The list of downloads, most recent first, shows each file and playlist in the output folder, with what it is and when it was saved. Tab moves from the list to the buttons, then to the Status box:

The menus

A menu item that cannot apply now is greyed out, such as Update playlist on a single video. The buttons are never greyed out: they say why instead.

yt-dlp

VidFetch downloads with yt-dlp, a free program that knows YouTube and well over a thousand other sites. The first time, VidFetch asks to download it from its official page on GitHub, checks it against its published checksum, and keeps it in its own folder, in %LOCALAPPDATA%\VidFetch\tools. If yt-dlp is already on the computer's path, that one is used instead.

Video sites change often, and an old yt-dlp is the usual reason a download fails. VidFetch updates its copy every two weeks by itself; Update yt-dlp, in the File menu, does it now.

Deno. YouTube increasingly asks programs to answer questions in JavaScript, and yt-dlp uses a small free program, Deno, for that. VidFetch works without it today. If YouTube comes to need it, or a message says so, choose Fetch Deno in the File menu: VidFetch asks first, fetches it from its own page on GitHub, checks it, and yt-dlp uses it from then on. It takes about 100 megabytes on disk.

A newer VidFetch. VidFetch looks on GitHub once a week and says if there is a newer version; Check for a newer version, in the Help menu, looks now. It never installs anything by itself.

What VidFetch cannot download

Only download what you have the right to: your own videos, freely licensed ones, or for your own use where the law and the site allow it.

Where things are kept

Troubleshooting

Quick reference: the keys

In the main window

In the YouTube window

In the Play window

Credits and licence

VidFetch is free and open source, under the MIT licence, by Laurent Cadet de Fontenay with assistance from Claude. Its code is on GitHub. Downloads are by yt-dlp, which VidFetch fetches from its own page. VidFetch is not connected with YouTube or Google.