Skip to the guide
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.
- You do not need to read it all. Part 1 takes a few minutes and is all you need
to begin. Part 3 is there for when you want the details.
- Headings are your friend. Each part is a level 2 heading and each tutorial a
level 3 heading.
- Menus are written with a comma. "File menu, Import channels" means: open the
File menu with Alt+F, then choose Import channels.
- Press F1 when you are unsure. It opens this guide in your web browser.
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
- The main window lists your downloads.
- The YouTube window opens in front of it, and lists what you searched for, or a
channel, or a playlist, one list at a time.
- The Play window is where sound plays.
- Listening plays a video's sound straight from YouTube and saves nothing.
Downloading saves it on your computer.
- yt-dlp is a free program VidFetch uses to fetch videos. VidFetch gets it and
keeps it up to date for you.
Part 1: Getting started
Tutorial 1: Get VidFetch and start it
- 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.
- Put vidfetch.exe in a folder of its own, for example in Documents, and run it. If you took the
zip, extract it first.
- 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.
- 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
- 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.
- The first time you listen, VidFetch asks to fetch yt-dlp. Say yes.
- 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.
- Press Enter on one. You hear "Please wait", and then it plays.
- 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.
- 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
- 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.
- 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.
- 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
- 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.
- Press Ctrl+T for the transcript: everything said in the video, with times, if the
video has captions. It needs no download.
- 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
- On a video by a channel you like, press Shift+F10 and choose Follow channel. Or
search with Look for set to Channels.
- Ctrl+L shows the latest from every channel you follow, newest first. Those you have
not seen start with the word New.
- 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.
- In your browser, go to takeout.google.com, and sign in
to the Google account you use for YouTube.
- Under "Create a new export", press the "Deselect all" button. Otherwise Google would export your
mail, your photos and everything else.
- Find the checkbox "YouTube and YouTube Music", far down the page, and check it.
- 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.
- 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".
- When the email arrives, usually within a few minutes, follow its link and download the zip file.
Google may ask for your password again.
- In VidFetch's main window, choose File menu, Import channels from a file. Choose the zip file.
There is no need to extract it.
- 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
- Copy the address, press Ctrl+N, and press Alt+L, Listen without
downloading.
- A single video plays. The address of a YouTube playlist or channel opens its list of videos in
the YouTube window.
- 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
- In the browser, open the video or the playlist, and copy its address with Alt+D
then Ctrl+C.
- 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.
- 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.
- Play or pause (Alt+P, or Enter or the Space bar on it).
- Back 10 seconds (Alt+B) and Forward 10 seconds
(Alt+F).
- The Left and Right arrows: 2 seconds back or forward. Home:
the start. End: 10 seconds before the end. T: where playing is, said out loud,
with the chapter.
- The Up and Down arrows: louder or quieter, by 5%.
- Shift with Up and Down: faster or slower, a quarter at a time,
from half speed to three times as fast, with voices kept at their own pitch. The speed is kept for
the next one, and is also in the Options menu.
- Page Down and Page Up: the next or the previous in the list, saying only
its name. With Continuous play ticked in the Options menu, the next starts
by itself. From YouTube, the next one's sound is found while this one plays, so it starts at
once.
- Ctrl+Page Down and Ctrl+Page Up: the next chapter, or back to the start
of this one, of a YouTube video whose description lists its chapters. Each chapter's name is
said.
- Ctrl+D, while listening to a video online: downloads it.
- Where playing is (Alt+W): the time, such as "1:23 of 15:04,
playing", to read with the arrow keys. It changes as it plays, even while it has focus.
- Escape stops and closes it.
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.
- Enter listens to a video straight from YouTube in the Play window, without
downloading it. Closing the Play window leaves you on the same video, and Enter carries
on from there. On a channel or a playlist, Enter opens it; the Enter button says
which.
- Ctrl+D downloads a video with your usual settings, into the category shown in the
main window. On a playlist or a channel, it downloads them all, after asking.
- Ctrl+I shows a video's description.
- The Video menu (Alt+V) and the context menu (Shift+F10) also have Show
channel, Show channel's playlists, Follow and Unfollow channel, Copy web address and Open in
browser.
- Ctrl+R lists the videos related to the one chosen, and you can go on from there.
Ctrl+K shows its comments, the first 100 as YouTube sorts them, and Ctrl+T its
transcript, each in a window to read with the arrow keys, without downloading the video. All three
also work on a download from YouTube in the main window.
- Ctrl+Shift+F searches the channel of the row chosen, or the channel shown.
- Backspace goes back one list at a time, as in File Explorer. Escape stops
a lookup; if none is running, it closes the window, from whichever list. So does Close window
(Alt+C).
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:
- Follow its channel, in the context menu of a video found, or of a download.
- Paste a channel's address in New download (Ctrl+N), and press
Follow the channel instead (Alt+F).
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.
- Category (Alt+C), above the list: one category, or All
categories. New downloads go into the category shown, or into Uncategorised when all are shown.
New download has its own Category box too.
- The Category menu has New category, Rename category, and Delete category, which act on the
category shown.
Deleting a category moves what is in it into Uncategorised; nothing is lost.
- Ctrl+Shift+M, Move to category, moves the download chosen, a playlist whole, into
another category, or a new one.
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:
- Sound only, M4A, the choice to begin with: the sound exactly as the site sends
it, nothing lost and nothing converted. Most players, phones and Windows itself play it.
- Sound only, MP3: for a player that takes nothing else, such as an older car
stereo or a talking book player. It is converted, so it takes a little longer.
- Video: an MP4 with picture and sound, which every player plays. YouTube sends
the picture and the sound separately; VidFetch puts them together with Windows' own Media
Foundation, copying both as they are, so nothing is lost.
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:
- Category (Alt+C): which category the list shows, or all of
them.
- Downloads (Alt+W): the list. Enter plays the chosen
download, or shows a playlist's videos, F2 renames it, Delete deletes it, and Shift+F10 or the
Applications key opens its context menu.
- Play (Alt+P or Enter): plays the download in the Play
window. On a playlist, it is called Open playlist.
- New download (Alt+N or Ctrl+N).
- Update playlist (Alt+U or Ctrl+U): fetches the
chosen playlist's videos that are not in its folder yet.
- Show queue (Alt+Q or Ctrl+Q): what is running and
what is waiting.
- Rename (Alt+R or F2): a new name for the file, keeping
its ending, or for the playlist's folder.
- Show video in file explorer (Alt+X): opens the output folder with the
download chosen in it.
- Delete (Alt+L or Delete in the list): asks, with
"Keep it" the default, then moves the file, or the playlist's folder, to the Recycle Bin.
- Status (Alt+T): what is happening now. Pressing
Alt+T again says it again.
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.
- File: New download; Select output folder; Open library in file explorer;
Update yt-dlp; Fetch Deno; Import channels from a file; Save a backup of your channels; Exit.
- Download: what can be done to the download chosen in the list: Open playlist
or play video; Open video using default media player; Back; Update playlist; Show description
(Ctrl+I); Show captions; Related videos (Ctrl+R); Comments (Ctrl+K); Transcript
(Ctrl+T); Show queue (Ctrl+Q); Empty queue; Stop download
(Escape); Rename; Move to category; Show video in file explorer; Delete.
- YouTube: Search YouTube (Ctrl+F); New videos from channels
(Ctrl+L); Your channels (Ctrl+Shift+L); Recently played (Ctrl+H);
and, for a download from YouTube, Follow channel, Unfollow channel, Copy web address and Open in
browser.
- Category: New category, Rename category and Delete category; Move to category
(Ctrl+Shift+M).
- Options: Download as; Picture quality; Number playlist files in order; Save
captions file; Playing speed; Continuous play; Cut silences when playing; Offer copied web
addresses, which, when you copy a web address elsewhere and come back to VidFetch, opens New
download with it, where you can download it or listen to it. Each choice is saved at once and said.
- Help: this guide (F1), Check for a newer version, and About VidFetch.
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
- Private, age-restricted or members-only videos, which need signing in.
- Videos a site offers only as a stream in pieces, which would need FFmpeg to put together.
VidFetch says so when that is the reason.
- Live streams while they are live.
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
- Downloads: Videos\VidFetch in your user folder, unless you choose another in the File
menu.
- Settings: %APPDATA%\VidFetch\settings.txt, plain text, safe to edit while VidFetch is
closed. Beside it, downloaded.json remembers which single videos you have, to notice one
asked for again, and queue.json holds what had not finished when VidFetch closed;
channels.json the channels you follow, places.json where you stopped playing
each one, and history.json what you played lately.
- yt-dlp, and downloads in progress: %LOCALAPPDATA%\VidFetch. A stopped download is
kept there for a day, so starting it again carries on where it was.
Troubleshooting
- A video will not download or play. Read what VidFetch says: it gives the reason
when it can. If it suggests it, choose File menu, Update yt-dlp, and try again. YouTube changes often,
and an old yt-dlp is the usual cause.
- A video will not stream. VidFetch then fetches its sound first by itself, which
can take a little while for a long video.
- YouTube asks to confirm you are not a robot. That usually passes within an hour or
so. Try again later.
- A message mentions JavaScript or a challenge. Choose File menu, Fetch Deno.
- Search, comments or channels stop working altogether. YouTube may have changed
something VidFetch relies on. Help menu, Check for a newer version, and please report it on the
VidFetch issues page.
- Windows or an antivirus program objects to VidFetch. It is not signed with a
certificate. Download it only from the releases page linked in Tutorial 1.
Quick reference: the keys
In the main window
- Enter: play, or open a playlist. Backspace: back from a playlist's videos.
- Ctrl+N: new download. Ctrl+Q: the queue. Ctrl+U: update a playlist.
Escape: stop the download running.
- Ctrl+F: search YouTube. Ctrl+L: new videos. Ctrl+Shift+L: your
channels. Ctrl+H: recently played.
- Ctrl+I: description. Ctrl+R: related videos. Ctrl+K: comments.
Ctrl+T: transcript.
- F2: rename. Delete: delete. Ctrl+Shift+M: move to a category.
F1: this guide.
In the YouTube window
- Enter: play or open. Ctrl+D: download. Backspace: back one list.
Escape: stop looking, or close the window.
- Ctrl+I, Ctrl+R, Ctrl+K, Ctrl+T: as above.
Ctrl+Shift+F: search this channel. Shift+F10: everything else.
In the Play window
- Left and Right: 2 seconds. Home: start. End: 10 seconds
before the end. T: time elapsed.
- Up and Down: volume. Shift with them: speed.
- Page Down and Page Up: next or previous video. Ctrl with them:
next or previous chapter.
- Ctrl+D: download, when listening online. Escape: close player.
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.