Skip to content
Features

Automatic Credit Files for Every YouTube Download

In short

B-ROLL writes a .credits.txt file next to each finished download and appends the same block to a running credits.txt in the same folder. Each block records the title, creator, channel link, video URL, upload date and the license as yt-dlp reports it, plus a copy-paste credit line. Always check the license on the video page itself.

Part of B-ROLL Features for Video Editors

On this page

What credit files does B-ROLL write?

B-ROLL writes a .credits.txt file next to every download with the title, creator, channel, source URL, upload date and license. The same block is also appended to a running credits.txt in the same folder, so one folder gives you one list of sources.

Both files are plain UTF-8 text, and the option is on by default. For a ProRes or DNxHR download, B-ROLL writes the credits after the conversion, so the name matches the finished .mov:

  • Harbor at Dawn, Drone Footage.credits.txt: one block, for that file only.
  • credits.txt: every block written in the folder, in the order the downloads finished.

A credits file answers the question a client or platform asks months later: where did this shot come from? Every other tool is listed on the B-ROLL Features for Video Editors page.

What is inside a B-ROLL .credits.txt block?

A B-ROLL credits block has six labeled lines (Title, Creator, Channel, Source, Uploaded, License) and a ready credit line. B-ROLL asks yt-dlp for these values after the download, using the field names in the yt-dlp README.

The table lists every line of a credits block, an example value and where the value comes from.

Line Example value Where it comes from When the value is missing
Title Harbor at Dawn, Drone Footage yt-dlp title Not applicable
Creator Example Channel yt-dlp channel, else uploader Not applicable
Channel https://www.youtube.com/@examplechannel yt-dlp channel_url, else uploader_url Line left out
Source https://www.youtube.com/watch?v=XXXXXXXXXXX The video URL Not applicable
Uploaded 2025-05-17 yt-dlp upload_date, written as YYYY-MM-DD Line left out
License Standard YouTube License yt-dlp license “Standard YouTube License”
Credit (copy-paste) “Title” by Creator, then the URL Built by B-ROLL from Title, Creator and Source Not applicable

A complete block looks like the example that follows. The app writes a long dash between the creator and the URL on the credit line; the example shows a hyphen in its place.

Text
Title:     Harbor at Dawn, Drone Footage
Creator:   Example Channel
Channel:   https://www.youtube.com/@examplechannel
Source:    https://www.youtube.com/watch?v=XXXXXXXXXXX
Uploaded:  2025-05-17
License:   Standard YouTube License

Credit (copy-paste):
"Harbor at Dawn, Drone Footage" by Example Channel - https://www.youtube.com/watch?v=XXXXXXXXXXX

When the License line contains “Creative Commons”, B-ROLL adds a second block with the license in the credit line. The same long dash appears in its heading and before the license:

Text
Creative Commons - attribution required:
"{title}" by {creator} ({channel URL, else video URL}) - {license}.

How does the running credits.txt work?

The running credits.txt collects one block per finished download in the same folder. B-ROLL appends each new block at the end, separated from the previous one by a line of 48 horizontal box-drawing characters.

Folders decide how the list is split. Keep one download folder per project and credits.txt becomes that project’s source list, ready to turn into a spreadsheet video credits log for a client or producer. A folder layout that fits this is in how to organize downloaded YouTube clips.

Two cases put blocks in a different folder:

  • Separate audio folder: with “Save audio to a different folder” on, audio downloads and their credits land in the audio folder.
  • Channel and playlist dialog: videos chosen in “Download from channel” go into a subfolder named after the channel, with its own credits.txt. For a playlist link, the subfolder takes the channel name of the first listed video.

The channel dialog turns up to 5 chosen videos into separate download cards, and each card writes its own credits block. More than 5 videos become one grouped card, and per-video credits for a grouped card are not confirmed, so open credits.txt after a grouped batch and add any missing block by hand from the video page.

Clips from the YouTube clip downloader stay in the main folder, each with its own block and a file named after the clip, such as Interview [02-10 to 02-38].credits.txt. A clip’s Source line holds the full video URL without a timestamp, so the time range lives only in the file name. Clip names carry minutes and seconds but not the hour, so for parts past the first hour of a video, add the hour to your log by hand.

How do you turn a credits block into an on-screen or description credit?

The fastest route is to copy the “Credit (copy-paste)” line from credits.txt into your video description. For a Creative Commons clip, use the Creative Commons block instead, because it adds the license that the attribution needs.

  1. Open credits.txt in the project’s download folder; each block is one clip.
  2. Copy the line under Credit (copy-paste) for every clip that made the final cut.
  3. Paste the lines into your description under a heading such as “Sources”, one line per clip.
  4. Use the Creative Commons block for clips whose License line names Creative Commons, so title, creator, source and license all appear.
  5. Use the Creator line for an on-screen credit, for example “Footage: Example Channel”, when the clip needs a credit in the picture.

Creative Commons calls the four elements of a good attribution TASL: title, author, source and license. The Creative Commons wiki on attribution also suggests crediting inside the video itself and in the description. Wording for end credits, descriptions and client deliverables is covered in how to credit a YouTube video.

What does the License line in a credits file tell you?

The License line tells you only what yt-dlp reported for the video. When yt-dlp reports nothing, B-ROLL writes “Standard YouTube License”, even if the video page shows another license, so check the license on the video page; the file is a convenience, not proof of rights.

As of September 2026, YouTube Help lists two license types: the Standard YouTube License, which is the default for every upload, and Creative Commons Attribution (CC BY). The same page says CC BY reuse needs the title, the author, the source URL and the license information, which is exactly what the Creative Commons block holds.

The Creative Commons block appears only when yt-dlp reports a Creative Commons license. B-ROLL’s Creative Commons block has not yet been checked against a live Creative Commons video, so compare it with the video page every time. How to find and reuse those videos is in Creative Commons on YouTube.

A credit line is a record, not a permission. YouTube’s copyright myths page says that giving credit to the copyright owner does not automatically give you the right to use the content. The longer answer is in does giving credit make it legal.

How do you switch credit files off in B-ROLL?

Open Advanced options with the ⋯ button next to Subtitles and turn off Save credits (attribution) for each download. B-ROLL remembers the choice in config.json, so it stays off until you turn it back on.

The app describes the option as: “Writes a .txt next to the video, adds it to a credits.txt for the folder, and embeds the creator in the file.” The embedding part applies only to MP4, MKV, WEBM and audio files, where yt-dlp writes the title, uploader, date and URL into the file’s metadata. ProRes and DNxHR .mov files never get embedded metadata.

Switching the option off therefore stops three things at once: the per-file .credits.txt, the running credits.txt and the embedded metadata. For ProRes and DNxHR downloads, the credit files are what links the file back to its source, so leave the option on whenever the footage belongs to someone else.

Frequently asked questions

Does a credit file make my use legal?

No. A credit file records where a clip came from and who made it, but credit alone does not give you the right to use someone else's footage. Permission, a license such as CC BY, or an exception like fair use decides that. The myths behind the idea are covered in does giving credit make it legal.

Where exactly are the credit files saved?

B-ROLL saves both credit files in the same folder as the downloaded file. The .credits.txt sits next to the video or audio file, and credits.txt collects every block written to the same folder. Audio sent to a separate audio folder, and channel downloads saved in a subfolder named after the channel, get their own credits.txt there.

Is the creator also embedded in the video file?

Only when the format is MP4, MKV, WEBM or audio. With Save credits on, yt-dlp embeds the title, uploader, date and URL as metadata in those files. ProRes and DNxHR .mov files carry no embedded credit, so keep the .credits.txt next to them as the record of the source.

Are credits written for playlists, channels and clips?

Only when each video has its own download card. Single videos, clips and up to 5 videos picked in the channel dialog each get a credits block, and a clip's Source line holds the full video URL without a timestamp. A grouped card of more than 5 videos, or a whole playlist on one card, may not get one block per video, so check credits.txt afterward. Clip naming is on the YouTube clip downloader page.

Why is a credits file missing for one download?

B-ROLL could not read the video's details after the download, or Save credits was off. The credits step is best effort: when the lookup fails, for example behind a sign-in wall, B-ROLL writes no file and shows no error. Look for the Credits saved line in the download log, and write the block by hand from the video page if it is missing.

Sources

  1. YouTube Help: License types on YouTube support.google.com
  2. YouTube Help: Common copyright myths support.google.com
  3. Creative Commons wiki: Recommended practices for attribution wiki.creativecommons.org
  4. yt-dlp README on GitHub github.com

Download B-ROLL, free

Windows 10 and 11 today, macOS and Linux planned. No account, no ads. Voluntary donations keep it free.

v1.0 · 20.3 MB installer · Windows 10 and 11