Carl Sagan on The Demon-Haunted World and Science l Charlie Rose Rewind
YouTube Comments To File converts YouTube comments JSON file to a text file or an HTML file. The comments JSON file must be produced by yt-dlp. The program doesn't retrieve the comments by itself from YouTube. The output file is aim at readability, showing the comments and replies in a tree-like structure.
The program can also utilize an existing copy of yt-dlp to download and convert comments from YouTube. This mode nullifies the need to execute two scripts, one for yt-dlp, to get the comments JSON file, and another to convert the JSON file to text file or HTML file.
While this program was written with YouTube in mind, it should be applicable for any comment JSON file that yt-dlp can download, one of which is BiliBili. Here's a list of supported sites by yt-dlp.
YouTube Comments To File requires .NET 10 Runtime.
Comment threading is the ability to reply to a reply. A good example is Reddit, where you can have a whole conversation between people in the comments section. YouTube supports threaded comments up to three levels of replies, meaning level 1 top-level comment, level 2 reply to top-level comment, and level 3 reply to reply.
There is a convention on YouTube that if you want to reply to someone else's reply, you write their user name first in your reply. This program takes advantage of this convention to build threaded comments for all comments, regardless of YouTube limitation of three levels of replies. This is enabled by default. You can disable comment threading with option --disable-threading. If disabled, shows the comments the way they appear on YouTube.
Downloads comments to text file or HTML file. Uses verb download. Verb is optional to specify.
YouTubeCommentsToFile [download]
[--url URL...]
[--yt-dlp PATH]
[--deno PATH]
[--download-path PATH]
[--max-comments NUMBER]
[--max-parents NUMBER]
[--max-replies NUMBER]
[--max-replies-per-thread NUMBER]
[--sort-new]
[--sort-top]
[--filename-sanitization]
[--restrict-filenames]
[--windows-filenames]
[--trim-title LENGTH]
[--only-download-comments]
[--update-yt-dlp]
[--yt-dlp-options OPTIONS]
[URL...]YouTubeCommentsToFile builds a yt-dlp command line for downloading comments out of the options provided by the user. Then, it runs yt-dlp to download the comments JSON file. Once the JSON file is downloaded, YouTubeCommentsToFile converts it to a text file or an HTML file or both. If the option is enabled, the JSON file is deleted.
This is the core of yt-dlp command line which downloads comments.
yt-dlp --write-comments
--print-to-file "%(comments)#+j" "%(uploader&{} - |)s%(title)s.json"
--skip-download
--no-write-info-json--write-commentsretrieves the video comments.--print-to-filewrites the comments to a file."%(comments)#+j"writes the comments as JSON.#for pretty-printing,+for Unicode,jfor JSON."%(uploader&{} - |)s%(title)s.json"is the JSON file name.uploaderis the name of the uploader of the video.titleis the title of the video. If yt-dlp can retrieve the name of the uploader, the file name isuploader - title.json. If not, the file name istitle.json.--skip-downloadprevents from downloading the video itself.--no-write-info-jsonprevents from writing video metadata file.
List of video URLs to download their comments. This option can be used multiple times. This option can have space-separated URLs as its value. This option can be used interchangeably with URLs placed at the end of the command line ([URL...]). The --url option is useful when specifying URLs in configuration files.
--url URL... Video URLs to download their comments.Path to yt-dlp program. If not set, search for yt-dlp in YouTubeCommentsToFile directory. If not found, check if yt-dlp is accessible in the current environment. It is not necessary to set --yt-dlp if yt-dlp is accessible, for example, yt-dlp directory is set in Windows PATH environment variable.
--yt-dlp PATH Path to yt-dlp.Path to Deno program. If not set, search for Deno in YouTubeCommentsToFile directory. If not found, check if Deno is accessible in the current environment. If Deno is at the same location as yt-dlp, there is no need to specify a path to Deno. To download from YouTube, yt-dlp needs to solve JavaScript challenges presented by YouTube using an external JavaScript runtime. Deno is a JavaScript runtime best suited for this and yt-dlp enables it by default. Read more here.
--deno PATH Path to Deno.Path to where to download comments JSON file and convert it to text file or HTML file. If not set, download path is set to YouTubeCommentsToFile directory.
--download-path PATH Path to download and to convert comments.These options limit the number of comments and replies. If an option is not set, it is unlimited (all in yt-dlp). If all options are not set, downloads everything.
--max-comments NUMBER Maximum number of top-level comments
and replies to extract.
--max-parents NUMBER Maximum number of top-level comments to extract.
--max-replies NUMBER Maximum number of replies to extract.
--max-replies-per-thread NUMBER Maximum number of replies per top-level comment
to extract.Example 1: Download up to 10,000 top-level comments and replies, at most 100 replies for each top-level comment.
--max-comments 10000
--max-replies-per-thread 100Example 2: Download all top-level comments, up to 1000 replies, at most 10 replies for each top-level comment.
--max-replies 1000
--max-replies-per-thread 10Example 3: Download up to 1000 top-level comments, no replies.
--max-parents 1000
--max-replies 0Sort comments by new comments first or by top comments first. If no sort option is enabled, yt-dlp default sorting is to order comments by new comments first.
--sort-new Sort comments by new comments first.
--sort-top Sort comments by top comments first.These options determine how the file name is processed.
--filename-sanitization Sanitize Windows reserved characters by removing them or
by replacing with comparable character or by replacing
with underscore. Doesn't replace with Unicode characters.
--restrict-filenames Restrict filenames to only ASCII characters,
and avoid '&' and spaces in filenames.
--windows-filenames Force filenames to be Windows-compatible by replacing
Windows reserved characters with lookalike Unicode characters.
--trim-title LENGTH Limit the length of the video title in the filename
to the specified number of characters. Doesn't limit
the length of the video uploader.Download the comments JSON file and don't write text and HTML files. This option can be useful if you want to experiment with the options that write to output file but don't want to repeatedly download the video comments. Download the comments once, YouTubeCommentsToFile download --only-download-comments, and convert them multiple times, YouTubeCommentsToFile convert --json-file PATH.
--only-download-comments Whether to download comments JSON file and stop.Update yt-dlp before downloading comments. Updates to nightly release channel. YouTube and yt-dlp developers are engaged in a cat and mouse chase, YouTube being the mouse and yt-dlp being the cat. YouTube is making frequent changes to the site in order to curve, limit and stop scraping tools such as yt-dlp. The developers of yt-dlp are quick to respond with changes to the program, but as a result of that, the users can no longer update yt-dlp once in a-very-long-time. If yt-dlp is not frequently updated (daily, weekly) to the newest version, it's more than likely it will stop working properly. Hence the update option. This option automates the updating process and takes the burden of remembering to update the program off the user's shoulders.
--update-yt-dlp Whether to update yt-dlp to the latest version.Options for yt-dlp which are added to yt-dlp command line. This is for advanced yt-dlp features such as --config-locations, --cookies, --cookies-from-browser.
--yt-dlp-options OPTIONS Options added to yt-dlp command line.Quick reminder, double quotes in double quotes need to be escaped with a backslash.
--yt-dlp-options "--config-locations \"C:\A Path\With\A Space\yt-dlp.conf\" --cookies cookies.txt"- Download to text file:
YouTubeCommentsToFile download --yt-dlp C:\Path\To\yt-dlp.exe --deno C:\Path\To\deno.exe --download-path "C:\Path\To\Downloads Folder" https://www.youtube.com/watch?v=dtCwxFTMMDg- Download to HTML file:
YouTubeCommentsToFile download --yt-dlp C:\Path\To\yt-dlp.exe --deno C:\Path\To\deno.exe --download-path "C:\Path\To\Downloads Folder" --to-html https://www.youtube.com/watch?v=dtCwxFTMMDg- Download to more robust HTML file:
YouTubeCommentsToFile download --yt-dlp C:\Path\To\yt-dlp.exe --deno C:\Path\To\deno.exe --download-path "C:\Path\To\Downloads Folder" --to-html --show-comment-navigation-links --show-copy-links --uh https://www.youtube.com/watch?v=dtCwxFTMMDg- The
--yt-dlpoption can be omitted if yt-dlp is at the same directory as YouTubeCommentsToFile:
YouTubeCommentsToFile download --download-path "C:\Path\To\Downloads Folder" https://www.youtube.com/watch?v=dtCwxFTMMDg- Download all comments, sort by top comments first:
YouTubeCommentsToFile download --yt-dlp C:\Path\To\yt-dlp.exe --deno C:\Path\To\deno.exe --download-path "C:\Path\To\Downloads Folder" --sort-top https://www.youtube.com/watch?v=dtCwxFTMMDg- Download up to 10,000 top-level comments and replies, at most 100 replies for each top-level comment, sort by new comments first (default):
YouTubeCommentsToFile download --yt-dlp C:\Path\To\yt-dlp.exe --deno C:\Path\To\deno.exe --download-path "C:\Path\To\Downloads Folder" --max-comments 10000 --max-replies-per-thread 100 https://www.youtube.com/watch?v=dtCwxFTMMDg- Download all top-level comments, up to 1000 replies, at most 10 replies for each top-level comment, sort by new comments first:
YouTubeCommentsToFile download --yt-dlp C:\Path\To\yt-dlp.exe --deno C:\Path\To\deno.exe --download-path "C:\Path\To\Downloads Folder" --max-replies 1000 --max-replies-per-thread 10 --sort-new https://www.youtube.com/watch?v=dtCwxFTMMDg- Download up to 1000 top-level comments, no replies, sort by top comments first:
YouTubeCommentsToFile download --yt-dlp C:\Path\To\yt-dlp.exe --deno C:\Path\To\deno.exe --download-path "C:\Path\To\Downloads Folder" --max-parents 1000 --max-replies 0 --sort-top https://www.youtube.com/watch?v=dtCwxFTMMDg- Download to text file, use configuration file for yt-dlp, use cookies file for restricted video:
YouTubeCommentsToFile download --yt-dlp C:\Path\To\yt-dlp.exe --deno C:\Path\To\deno.exe --download-path "C:\Path\To\Downloads Folder" --yt-dlp-options "--config-locations \"C:\Path\To\yt-dlp.conf\" --cookies cookies.txt" https://www.youtube.com/watch?v=dtCwxFTMMDgConverts comments JSON file to text file or HTML file. Uses verb convert. Verb is required to specify.
YouTubeCommentsToFile convert
[--json-file PATH[|URL]...]
[--url URL]
[--yt-dlp PATH]
[--deno PATH]
[PATH[|URL]...]List of paths to comments JSON files or directories. If the specified path is a directory, the program will look for JSON files in that directory. A video URL, associated with the path, can be specified by concatenating with |. Otherwise, the URL is taken from option --url. The name of the output file is the same as the name of the JSON file. This option can be used multiple times. This option can have space-separated paths as its value. This option can be used interchangeably with JSON file paths placed at the end of the command line ([PATH[|URL]...]). The --json-file option is useful when specifying paths in configuration files.
--json-file PATH[|URL]... Paths to comments JSON files or directories.Since the video URL can't be extracted from the comments JSON file, by providing it, it makes the output file more robust by writing links to the video, to its comments and replies. URL is not required in order to write to output file.
--url URL Video URL.Path to yt-dlp program. If not set, search for yt-dlp in YouTubeCommentsToFile directory. If not found, check if yt-dlp is accessible in the current environment. It is not necessary to set --yt-dlp if yt-dlp is accessible, for example, yt-dlp directory is set in Windows PATH environment variable. yt-dlp is used to retrieve information about the video, therefore is not required to write to output file.
--yt-dlp PATH Path to yt-dlp.Path to Deno program. If not set, search for Deno in YouTubeCommentsToFile directory. If not found, check if Deno is accessible in the current environment. If Deno is at the same location as yt-dlp, there is no need to specify a path to Deno. To download from YouTube, yt-dlp needs to solve JavaScript challenges presented by YouTube using an external JavaScript runtime. Deno is a JavaScript runtime best suited for this and yt-dlp enables it by default.
- Setup Guide.
- Download Deno. For Windows, download
deno-x86_64-pc-windows-msvc.zipfrom Releases.
--deno PATH Path to Deno.- Convert to text file:
YouTubeCommentsToFile convert "C:\Path\To\Comments File.json"- Convert to HTML file:
YouTubeCommentsToFile convert --to-html "C:\Path\To\Comments File.json"- Convert more than one JSON file, with their respective URLs:
YouTubeCommentsToFile convert "C:\Path\To\Carl Sagan on The Demon-Haunted World and Science.json|https://www.youtube.com/watch?v=dtCwxFTMMDg" "C:\Path\To\Carl Sagan on the Existence of God.json|https://www.youtube.com/watch?v=ML4kiFCKZGo"- Convert to more robust HTML file. By specifying the URL, yt-dlp will download video information - title, uploader, upload date, description:
YouTubeCommentsToFile convert --json-file "C:\Path\To\Comments File.json" --url https://www.youtube.com/watch?v=dtCwxFTMMDg --yt-dlp C:\Path\To\yt-dlp.exe --deno C:\Path\To\deno.exe --to-html --show-comment-navigation-links --show-copy-links --uh- Highlight uploader, authors and texts. If a comment or reply matches any of the specified highlight items, the comment is highlighted:
YouTubeCommentsToFile convert --uh --ah @Alice Bob --th "Alice and Bob" "are entangled" "C:\Path\To\Comments File.json"- Filter by uploader, authors and texts. If a comment or reply matches any of the specified filter items, it is shown. Otherwise, it is removed:
YouTubeCommentsToFile convert --uf --af @Alice Bob --tf "Alice and Bob" "are entangled" "C:\Path\To\Comments File.json"When both --to-html and --to-html-and-text are disabled, writes only to text file.
--to-html Whether to write comments to HTML file.
--to-html-and-text Whether to write comments to HTML file
and to text file.Disable comment threading. Shows the comments the way they appear on YouTube.
--disable-threading Whether to disable comment threading.Hide elements from the output file.
--hide-comment-separators Whether to hide separators between top-level comments.
--hide-header Whether to hide the video information header,
containing title, URL, uploader, description.
--hide-likes Whether to hide likes count.
--hide-replies Whether to hide replies and leave only top-level comments.
--hide-time Whether to hide the posted time of the comment or reply.
--hide-video-description Whether to hide the video description from the
video information header.This option creates links to comments and replies. It is useful if you want to read the comments offline and when you decide to reply to someone's comment, the link will take you directly to it instead of searching for it on the video page. In convert mode, if --show-comment-link is enabled and the video URL (--url) is not provided, shows only the part of the URL that points to a comment (&lc= for YouTube). Then, you can copy that and add it to the video URL in the browser.
--show-comment-link Whether to show direct links comments and replies.These options determine the structure of the HTML output file.
--dark-theme Whether to use dark theme in HTML file.
--show-comment-navigation-links Whether to show next comment and previous
comment navigation links in HTML file.
--show-copy-links Whether to show copy text links for comments
and replies in HTML file.This option determines how much characters of indentation are between a comment and a reply or between a reply to another reply. Indentation size is between 2 and 10 characters. If this option is not set, indentation for text file and HTML file is 4 characters.
--indent-size SIZE The indentation size, in number of characters.This option determines how many characters a single line of text is allowed. If a comment has a line of text that is longer than that, the line is split into several lines which adhere to that length limitation. Line length is between 80 and 320 characters. If this option is not set, line length for text file is 120 characters and line length for HTML file is 150 characters.
--text-line-length LENGTH The maximum length of a line of text,
in number of characters.Delete JSON file after comments were written successfully to the output file.
--delete-json-file Whether to delete the comments JSON file
on successful completion.Highlight uploader: Search for comments and replies written by the uploader of the video. If found, highlight the comment or reply.
Filter uploader: Search for comments and replies written by the uploader of the video. If found, keep the conversation (comment and its replies). Otherwise, remove the conversation, if it didn't match any other filter items.
-u, --uh Highlight uploader.
--uf Filter uploader.
--uhf Highlight and filter uploader.- Highlight all comments written by the uploader of the video:
YouTubeCommentsToFile download --uh- Show only conversations that the uploader of the video participated in:
YouTubeCommentsToFile download --ufHighlight authors: Search for comments and replies written by any of the specified authors. If found, highlight the comment or reply.
Filter authors: Search for comments and replies written by any of the specified authors. If found, keep the conversation (comment and its replies). Otherwise, remove the conversation, if it didn't match any other filter items.
Author name can be written with or without a leading @.
--ah NAME... Highlight authors.
--af NAME... Filter authors.
--afi NAME... Filter authors. Author search is case-insensitive.
--ahf NAME... Highlight and filter authors.
--ahfi NAME... Highlight and filter authors. Author search is case-insensitive.
-a, --ahi NAME... Highlight authors. Author search is case-insensitive.- Highlight all comments written by either
@Aliceor@Bob. Search for author names is case sensitive:
YouTubeCommentsToFile download --ah @Alice Bob- Highlight all comments written by either
@Aliceor@Bob. Search for author names is case insensitive:
YouTubeCommentsToFile download --ahi alice @bob- Show only conversations that either
@Aliceor@Bobparticipated in. Search for author names is case insensitive:
YouTubeCommentsToFile download --afi alice bobHighlight texts: Search for any of the specified texts in the comment or reply. If found, highlight the comment or reply.
Filter texts: Search for any of the specified texts in the comment or reply. If found, keep the conversation (comment and its replies). Otherwise, remove the conversation, if it didn't match any other filter items.
--th TEXT... Highlight texts.
--tf TEXT... Filter texts.
--tfi TEXT... Filter texts. Text search is case-insensitive.
--thf TEXT... Highlight and filter texts.
--thfi TEXT... Highlight and filter texts. Text search is case-insensitive.
-t, --thi TEXT... Highlight texts. Text search is case-insensitive.- Highlight all comments that contain any of the text phrases
Alice and Bobandare entangled. Search for text phrases is case sensitive:
YouTubeCommentsToFile download --th "Alice and Bob" "are entangled"- Highlight all comments that contain any of the text phrases
Alice and Bobandare entangled. Search for text phrases is case insensitive:
YouTubeCommentsToFile download --thi "alice and bob" "are entangled"- Show only conversations with comments that contain any of the text phrases
Alice and Bobandare entangled. Search for text phrases is case sensitive:
YouTubeCommentsToFile download --tf "Alice and Bob" "are entangled"The program works with UTF-8 as its default encoding and that should cover almost all languages. However, if the video page is not in English (the title, the description, majority of the comments) and downloading comments fails or comes out garbled, use the --encoding-code-page option to change the encoding. You need to find beforehand what is the code page of the non-English language.
--encoding-code-page CODEPAGE The code page of the video page encoding.Or, use one of these predefined encodings.
--utf8 UTF-8. Code page 65001.
--arabic-iso Arabic (ISO-8859-6). Code page 28596.
Arabic, Persian, Urdu.
--arabic-windows Arabic (Windows-1256). Code page 1256.
--baltic-iso-13 Baltic (ISO-8859-13). Code page 28603.
Lithuanian, Latvian, Estonian.
--baltic-iso-4 Baltic (ISO-8859-4). Code page 28594.
Estonian, Latvian, Lithuanian, Greenlandic, Sami.
--baltic-windows Baltic (Windows-1257). Code page 1257.
--central-european Central European (Windows-1250). Code page 1250.
--chinese-simplified Chinese Simplified (GB2312). Code page 936.
--chinese-traditional Chinese Traditional (Big5). Code page 950.
--cyrillic-iso Cyrillic (ISO-8859-5). Code page 28595.
Russian, Ukrainian, Bulgarian, Belarusian,
Macedonian, Serbian.
--cyrillic-windows Cyrillic (Windows-1251). Code page 1251.
--eastern-european Eastern European (ISO-8859-2). Code page 28592.
Czech, Hungarian, Polish, Romanian, Croatian,
Slovak, Slovenian.
--greek-iso Greek (ISO-8859-7). Code page 28597.
--greek-windows Greek (Windows-1253). Code page 1253.
--hebrew-iso Hebrew (ISO-8859-8). Code page 28598.
--hebrew-windows Hebrew (Windows-1255). Code page 1255.
--japanese Japanese (Shift-JIS). Code page 932.
--korean Korean (Windows-949). Code page 949.
--south-european South European (ISO-8859-3). Code page 28593.
Maltese, Esperanto, Turkish.
--thai Thai (TIS-620). Code page 874.
--turkish-iso Turkish (ISO-8859-9). Code page 28599.
--turkish-windows Turkish (Windows-1254). Code page 1254.
--vietnamese Vietnamese (Windows-1258). Code page 1258.
--western-european-iso-1 Western European (ISO-8859-1). Code page 28591.
English, French, Spanish, German, Italian, Portuguese.
--western-european-iso-15 Western European (ISO-8859-15). Code page 28605.
English, French, German, Spanish, Finnish, Danish,
Swedish, Italian, Dutch.
--western-european-windows Western European (Windows-1252). Code page 1252.These options set the colors of various HTML elements. A color value can be a known name (Honeydew), hex code (#F0FFF0; F0FFF0) or RGB (240, 255, 240; 240 255 240).
--text-color COLOR The text color of the page.
--bg-color COLOR The background color of the page.
--comment-color COLOR The text color of the top-level comments
and replies.
--reply-color COLOR The text color of the replies.
--header-text-color COLOR The text color of the header.
--header-bg-color COLOR The background color of the header.
--author-color COLOR The text color of the author of the comment.
--replied-author-color COLOR The text color of the author that replied to the
comment, appearing at the start of the comment.
--other-author-color COLOR The text color of other author, appearing
anywhere else but the start of the comment.
--small-elements-color COLOR The text color of small elements, such as
pinned comment, comment time, likes.
--favorited-bg-color COLOR The background color of favorited by the
uploader of the video.
--highlight-uploader-text-color COLOR The text color of highlighted comments
written by the uploader of the video.
--highlight-uploader-bg-color COLOR The background color of highlighted comments
written by the uploader of the video.
--highlight-uploader-border-color COLOR The color of the border around highlighted
comments written by the uploader of the video.
--highlight-author-text-color COLOR The text color of highlighted comments
written by any of the searched authors.
--highlight-author-bg-color COLOR The background color of highlighted comments
written by any of the searched authors.
--highlight-author-border-color COLOR The color of the border around highlighted
comments written by any of the searched authors.
--highlight-text-text-color COLOR The text color of highlighted comments
containing any of the searched texts.
--highlight-text-bg-color COLOR The background color of highlighted comments
containing any of the searched texts.
--highlight-text-border-color COLOR The color of the border around highlighted
comments containing any of the searched texts.
--link-color COLOR The text color of HTML links.
--comment-navigation-link-color COLOR The text color of next comment and previous
comment navigation links.
--comment-link-color COLOR The text color of links to comments and replies.
--copy-text-color COLOR The text color of copy text links for comments
and replies.
--copy-text-success-color COLOR The text color of a success message after
copying a comment to the clipboard.
--copy-text-failure-color COLOR The text color of an error message after
failing to copy a comment to the clipboard.The colors of the HTML elements are determined by light theme (default theme) or dark theme (--dark-theme).
The following are the colors of these themes.
| Light Theme | Dark Theme | |||
|---|---|---|---|---|
| HTML Element | RGB | Hex | RGB | Hex |
Text--text-color |
15, 15, 15 | #0F0F0F | 241, 241, 241 | #F1F1F1 |
Background--bg-color |
255, 255, 255 | #FFFFFF | 15, 15, 15 | #0F0F0F |
Comment--comment-color |
15, 15, 15 | #0F0F0F | 241, 241, 241 | #F1F1F1 |
Reply--reply-color |
15, 15, 15 | #0F0F0F | 241, 241, 241 | #F1F1F1 |
Header Text--header-text-color |
15, 15, 15 | #0F0F0F | 241, 241, 241 | #F1F1F1 |
Header Background--header-bg-color |
242, 242, 242 | #F2F2F2 | 39, 39, 39 | #272727 |
Author--author-color |
15, 15, 15 | #0F0F0F | 241, 241, 241 | #F1F1F1 |
Replied Author--replied-author-color |
15, 128, 15 | #0F800F | 15, 128, 15 | #0F800F |
Other Author--other-author-color |
128, 15, 255 | #800FFF | 191, 15, 255 | #BF0FFF |
Small Elements--small-elements-color |
96, 96, 96 | #606060 | 170, 170, 170 | #AAAAAA |
Favorited Background--favorited-bg-color |
229, 235, 238 | #E5EBEE | 96, 96, 96 | #606060 |
Highlight Uploader: Text--highlight-uploader-text-color |
15, 15, 15 | #0F0F0F | 241, 241, 241 | #F1F1F1 |
Highlight Uploader: Background--highlight-uploader-bg-color |
255, 250, 238 | #FFFAEE | 140, 33, 23 | #8C2117 |
Highlight Uploader: Border--highlight-uploader-border-color |
183, 136, 0 | #B78800 | 252, 225, 150 | #FCE196 |
Highlight Author: Text--highlight-author-text-color |
15, 15, 15 | #0F0F0F | 241, 241, 241 | #F1F1F1 |
Highlight Author: Background--highlight-author-bg-color |
252, 241, 237 | #FCF1ED | 137, 57, 16 | #893910 |
Highlight Author: Border--highlight-author-border-color |
255, 67, 5 | #FF4305 | 255, 165, 0 | #FFA500 |
Highlight Text: Text--highlight-text-text-color |
15, 15, 15 | #0F0F0F | 241, 241, 241 | #F1F1F1 |
Highlight Text: Background--highlight-text-bg-color |
231, 239, 252 | #E7EFFC | 13, 57, 132 | #0D3984 |
Highlight Text: Border--highlight-text-border-color |
34, 110, 233 | #226EE9 | 231, 239, 252 | #E7EFFC |
Link--link-color |
0, 0, 238 | #0000EE | 62, 166, 255 | #3EA6FF |
Comment Navigation Link--comment-navigation-link-color |
0, 0, 238 | #0000EE | 62, 166, 255 | #3EA6FF |
Comment Link--comment-link-color |
0, 0, 238 | #0000EE | 62, 166, 255 | #3EA6FF |
Copy Text--copy-text-color |
0, 0, 238 | #0000EE | 62, 166, 255 | #3EA6FF |
Copy Text: Success--copy-text-success-color |
15, 170, 15 | #0FAA0F | 15, 170, 15 | #0FAA0F |
Copy Text: Failure--copy-text-failure-color |
255, 15, 15 | #FF0F0F | 213, 15, 15 | #D50F0F |
Configuration files allow to set options for the program without having to specify them at the command line every time. A configuration file is a text file with a list of command line options.
--config-locations PATH... Paths to configuration files or to directories containing
configuration files. Can be used multiple times and inside
other configuration files.- The option
--config-locationscan be used multiple times at the command line. - A relative path, specified at the command line, is relative to the directory from which the program is running from.
- The option
--config-locationscan be used multiple times in a configuration file. - A relative path, specified in a configuration file, is relative to the directory where the configuration file is at.
- If the path is a directory and not a file, the program looks for
youtube-comments-to-file-convert.conf*,youtube-comments-to-file-download.conf**,youtube-comments-to-file.confin the specified directory. - Options passed at the command line always override the same options set within configuration files.
- Configuration file doesn't support verbs
convertanddownload. The verb needs to be passed at the command line.
- One option per line.
- No whitespace after
-or--. - Comment starts with #.
- Values with a space need to be between quotes, just like in the command line.
- Configuration files are decoded first with UTF-8 encoding and fallback to the current system locale encoding.
Environment variables can be specified in options that set a path to a file or to a directory:
--config-locations, --json-file, --download-path, --yt-dlp, --deno.
An environment variable can be specified in one of three ways, regardless if the OS is Windows or Linux:
${VARIABLE}, $VARIABLE, %VARIABLE%.
On Windows, ~ is mapped to $HOME. If $HOME doesn't exist, it falls back to %USERPROFILE%. If %USERPROFILE% doesn't exist, it falls back to %HOMEDRIVE%%HOMEPATH%.
On Windows, %APPDATA% usually located at C:\Users\<username>\AppData\Roaming and %USERPROFILE% usually located at C:\Users\<username>.
On Linux, if $XDG_CONFIG_HOME is not set, it falls back to ~/.config. $XDG_CACHE_HOME falls back to ~/.cache.
- Two configuration files, one for
convertoperation and one fordownloadoperation, are located at the user's settings directory,C:\Users\<username>\AppData\Roaming, and are directly specified with--config-locationsat the command line.
YouTubeCommentsToFile convert --config-locations "%APPDATA%\convert.conf"
YouTubeCommentsToFile download --config-locations "%APPDATA%\download.conf"- The directory for downloaded comments is specified to be
YouTube Commentsdirectory under the user's profile directory. The full path isC:\Users\<username>\YouTube Comments.
YouTubeCommentsToFile download --download-path "%USERPROFILE%\YouTube Comments"- You don't have to use the built-in environment variables. You can define custom ones and reference them.
- On Windows, open the Environment Variables window. The top half of the window is the user variables. The bottom half of the window is the system variables.
- In the user variables, add an new entry.
Variable name:YouTube Comments
Variable value:C:\Users\<username>\YouTube Comments - Restart the computer. The environment variables are loaded when the computer starts.
- Use the environment variable
YouTube Commentsto specify the directory for downloaded comments.
YouTubeCommentsToFile download --download-path "%YouTube Comments%"The program loads configuration files from multiple locations in the following order, from high priority to low priority. Options from high priority configuration take precedence over options from low priority configuration.
- Main Configuration: Configuration files specified at the command line with
--config-locations. - Portable Configuration: Configuration files in the same directory as the YouTubeCommentsToFile executable.
youtube-comments-to-file-convert.conf*youtube-comments-to-file-download.conf**youtube-comments-to-file.conf
- Home Configuration: Configuration files at the directory that the program operates on. For
convertoperation, the directory of the JSON file, specified with--json-file. Fordownloadoperation, the directory to download comments to, specified with--download-path.youtube-comments-to-file-convert.conf*youtube-comments-to-file-download.conf**youtube-comments-to-file.conf
- User Configuration:
- Windows:
%APPDATA%\youtube-comments-to-file-convert.conf*%APPDATA%\youtube-comments-to-file-download.conf**%APPDATA%\youtube-comments-to-file.conf%APPDATA%\YouTubeCommentsToFile\convert*%APPDATA%\YouTubeCommentsToFile\download**%APPDATA%\YouTubeCommentsToFile\config***%APPDATA%\YouTubeCommentsToFile\convert.txt*%APPDATA%\YouTubeCommentsToFile\download.txt**%APPDATA%\YouTubeCommentsToFile\config.txt%USERPROFILE%\youtube-comments-to-file-convert.conf*%USERPROFILE%\youtube-comments-to-file-download.conf**%USERPROFILE%\youtube-comments-to-file.conf%USERPROFILE%\youtube-comments-to-file-convert.conf.txt*%USERPROFILE%\youtube-comments-to-file-download.conf.txt**%USERPROFILE%\youtube-comments-to-file.conf.txt%USERPROFILE%\.youtubecommentstofile\convert*%USERPROFILE%\.youtubecommentstofile\download**%USERPROFILE%\.youtubecommentstofile\config***%USERPROFILE%\.youtubecommentstofile\convert.txt*%USERPROFILE%\.youtubecommentstofile\download.txt**%USERPROFILE%\.youtubecommentstofile\config.txt
- Linux:
$XDG_CONFIG_HOME/youtube-comments-to-file-convert.conf*$XDG_CONFIG_HOME/youtube-comments-to-file-download.conf**$XDG_CONFIG_HOME/youtube-comments-to-file.conf$XDG_CONFIG_HOME/youtube-comments-to-file/convert*$XDG_CONFIG_HOME/youtube-comments-to-file/download**$XDG_CONFIG_HOME/youtube-comments-to-file/config***$XDG_CONFIG_HOME/youtube-comments-to-file/convert.txt*$XDG_CONFIG_HOME/youtube-comments-to-file/download.txt**$XDG_CONFIG_HOME/youtube-comments-to-file/config.txt~/youtube-comments-to-file-convert.conf*~/youtube-comments-to-file-download.conf**~/youtube-comments-to-file.conf~/youtube-comments-to-file-convert.conf.txt*~/youtube-comments-to-file-download.conf.txt**~/youtube-comments-to-file.conf.txt~/.youtube-comments-to-file/convert*~/.youtube-comments-to-file/download**~/.youtube-comments-to-file/config***~/.youtube-comments-to-file/convert.txt*~/.youtube-comments-to-file/download.txt**~/.youtube-comments-to-file/config.txt
- Windows:
- System Configuration: Linux only.
/etc/youtube-comments-to-file-convert.conf*/etc/youtube-comments-to-file-download.conf**/etc/youtube-comments-to-file.conf/etc/youtube-comments-to-file/convert*/etc/youtube-comments-to-file/download**/etc/youtube-comments-to-file/config***/etc/youtube-comments-to-file/convert.txt*/etc/youtube-comments-to-file/download.txt**/etc/youtube-comments-to-file/config.txt
* Only for convert operation.
** Only for download operation.
*** The name of the file is config without a file extension.
This options ignores the current config location but continues loading the rest of the configuration stack. If this option is specified in the command line, all the --config-locations, in the command line, are not loaded. If this option is specified in a configuration file, the file is not loaded.
--ignore-config Don't load the config location and continue loading
the rest of the configuration stack.This option stops the loading of the configuration stack from the point it appears. If this option is specified in the command line, the whole configuration stack is not loaded, including all the --config-locations in the command line. If this option is specified in a configuration file, the file is not loaded and the loading of the rest of the configuration stack is stopped.
--stop-config Don't load the config location and stop loading
the rest of the configuration stack.These options determine what and how much is printed out.
-v, --verbose Print debugging information.
-q, --quiet Don't print anything.
If used with '--verbose', print to standard error (stderr).
--yt-dlp-quiet Don't print output from yt-dlp.
--no-write-comments Don't download or write comments.--sleep-interval SECONDS Number of seconds to sleep between converting
multiple JSON files or downloading from multiple URLs.
--min-sleep-interval SECONDS Minimum number of seconds to sleep between converting
multiple JSON files or downloading from multiple URLs.
--max-sleep-interval SECONDS Maximum number of seconds to sleep between converting
multiple JSON files or downloading from multiple URLs.
--beep Make a beep sound when finished.
If used with '--quiet', make no sound.
--beep-on-errors Make a beep sound when finished with errors.
If used with '--quiet', make no sound.
--pause-on-errors Prevent the console from closing until a key is pressed
when finished with errors. If used with '--quiet',
this option is disabled.
-h, --help Display help screen.
--version Display version information.These tutorials show how to use YouTubeCommentsToFile with more than just the command line.
- Download YouTubeCommentsToFile from Releases.
- Download and install yt-dlp.
- Download Deno. For Windows, download
deno-x86_64-pc-windows-msvc.zipfrom Deno Releases. - Optional: Place YouTubeCommentsToFile, yt-dlp and Deno in the same directory. Make sure that directory doesn't need administrative rights (For example, on Windows, not under
C:\Program Files) because you want to update yt-dlp with no prompts.
- Create this script
download-comments.cmd. This script downloads comments to HTML file and the comments are sorted by top comments first.
@echo off
set "url=%~1"
call "C:\Path\To\YouTubeCommentsToFile.exe" --url "%url%" --download-path "C:\Path\To\Downloads Folder" --max-comments 100000 --max-replies-per-thread 100 --sort-top --to-html --show-comment-navigation-links --show-copy-links --uh --trim-title 150 --delete-json-file --beep-on-errors --yt-dlp "C:\Path\To\yt-dlp.exe" --update-yt-dlp --deno "C:\Path\To\deno.exe"
exit /b %ERRORLEVEL%You can omit the full path to the YouTubeCommentsToFile executable if the script is in the same directory as YouTubeCommentsToFile. You can omit --yt-dlp and --deno if the executables are in the same directory as the YouTubeCommentsToFile executable.
--url "URL"Video URL.--download-path "C:\Path\To\Downloads Folder"Download to the specified directory.--max-comments 100000 --max-replies-per-thread 100At most 100,000 comments and replies, at most 100 replies for each top-level comment.--sort-topSort by top comments first.--to-htmlSave comments to HTML output file.--show-comment-navigation-linksShow next comment and previous comment navigation links.--show-copy-linksShow copy text links.--uhHighlight uploader. Comments and replies, written by the uploader of the video, will be highlighted.--trim-title 150Limit the title of the video to at most 150 characters.--delete-json-fileDelete the comments JSON file after successfully writing to the HTML output file.--beep-on-errorsMake a beep sound when finished with errors.--yt-dlp "C:\Path\To\yt-dlp.exe"Path to yt-dlp.--update-yt-dlpUpdate yt-dlp before using it.--deno "C:\Path\To\deno.exe"Path to Deno.
- Open Command Line/Terminal/shell in the same directory where YouTubeCommentsToFile is at or change the path to it.
- Download comments with this command. Don't forget to change the URL below.
download-comments "https://www.youtube.com/watch?v=dtCwxFTMMDg"- Repeat steps 2 and 3.
This tutorial shows how to download comments directly from the browser without copying and pasting the video URL somewhere else.
This download method uses External Application Launcher browser extension. This browser extension exposes custom arguments to external programs. This extension will pass the URL from the browser to the YouTubeCommentsToFile executable. Read more about this extension in the support page. The extension is applicable on Chrome and other Chromium-based browsers, Firefox and Edge.
- Install External Application Launcher extension on your browser.
- Create configuration file
youtube-comments-to-file-download.confin the same directory as the YouTubeCommentsToFile executable. You can create this configuration file in other places. Read more about it in Configuration Stack.
# Download to the specified directory.
--download-path "C:\Path\To\Downloads Folder"
# At most 100,000 comments and replies.
--max-comments 100000
# At most 100 replies for each top-level comment.
--max-replies-per-thread 100
# Sort by top comments first.
--sort-top
# Save comments to HTML output file.
--to-html
# Show next comment and previous comment navigation links.
--show-comment-navigation-links
# Show copy text links.
--show-copy-links
# Highlight uploader.
# Comments and replies, written by the uploader of the video, will be highlighted.
--uh
# Limit the title of the video to at most 150 characters.
--trim-title 150
# Delete the comments JSON file after successfully writing to the HTML output file.
--delete-json-file
# Make a beep sound when finished with errors.
--beep-on-errors
# Path to yt-dlp.
--yt-dlp "C:\Path\To\yt-dlp.exe"
# Update yt-dlp before using it.
--update-yt-dlp
# Path to Deno.
--deno "C:\Path\To\deno.exe"- Open the extension options page through your browser, fill in the following text and check boxes and press the "Add Application" button when done.
- Display Name: Download Comments
- Executable Name: C:\Windows\System32\cmd.exe
- Arguments: /c start /d "C:\Path\To\YouTubeCommentsToFile Directory" YouTubeCommentsToFile.exe --url [HREF]
- Toolbar Button: Page Context, Link Context, Video Context
- Page Pattern: *://www.youtube.com/*, *://www.youtube-nocookie.com/*, *://music.youtube.com/*, *://www.bilibili.com/*, *://www.bilibili.tv/*
If the configuration file is not part of the Configuration Stack, different name or different location, specify the path to it with --config-locations.
- Arguments: /c start /d "C:\Path\To\YouTubeCommentsToFile Directory" YouTubeCommentsToFile.exe --config-locations "C:\Path\To\configuration-file.conf" --url [HREF]
- Go to YouTube and right-click on a link to a video in the YouTube main page or right-click on the video page itself. The button, to download comments, will be available in the context menu.
Side note, you can similarly use these steps to configure downloading the video itself with yt-dlp.
- Display Name: Download Video
- Arguments: /c start /d "C:\Path\To\yt-dlp Directory" yt-dlp.exe --config-location "C:\Path\To\yt-dlp-configuration-file.conf" [HREF]

