Release 2024.10.22
[yt-dlp.git] / .github / ISSUE_TEMPLATE / 4_bug_report.yml
bloba17770f6141b92b7c9f298b1a6b954641dc715b8
1 name: Core bug report
2 description: Report a bug unrelated to any particular site or extractor
3 labels: [triage, bug]
4 body:
5   - type: checkboxes
6     attributes:
7       label: DO NOT REMOVE OR SKIP THE ISSUE TEMPLATE
8       description: Fill all fields even if you think it is irrelevant for the issue
9       options:
10         - label: I understand that I will be **blocked** if I *intentionally* remove or skip any mandatory\* field
11           required: true
12   - type: checkboxes
13     id: checklist
14     attributes:
15       label: Checklist
16       description: |
17         Carefully read and work through this check list in order to prevent the most common mistakes and misuse of yt-dlp:
18       options:
19         - label: I'm reporting a bug unrelated to a specific site
20           required: true
21         - label: I've verified that I have **updated yt-dlp to nightly or master** ([update instructions](https://github.com/yt-dlp/yt-dlp#update-channels))
22           required: true
23         - label: I've checked that all provided URLs are playable in a browser with the same IP and same login details
24           required: true
25         - label: I've checked that all URLs and arguments with special characters are [properly quoted or escaped](https://github.com/yt-dlp/yt-dlp/wiki/FAQ#video-url-contains-an-ampersand--and-im-getting-some-strange-output-1-2839-or-v-is-not-recognized-as-an-internal-or-external-command)
26           required: true
27         - label: I've searched [known issues](https://github.com/yt-dlp/yt-dlp/issues/3766) and the [bugtracker](https://github.com/yt-dlp/yt-dlp/issues?q=) for similar issues **including closed ones**. DO NOT post duplicates
28           required: true
29         - label: I've read the [guidelines for opening an issue](https://github.com/yt-dlp/yt-dlp/blob/master/CONTRIBUTING.md#opening-an-issue)
30           required: true
31   - type: textarea
32     id: description
33     attributes:
34       label: Provide a description that is worded well enough to be understood
35       description: See [is-the-description-of-the-issue-itself-sufficient](https://github.com/yt-dlp/yt-dlp/blob/master/CONTRIBUTING.md#is-the-description-of-the-issue-itself-sufficient)
36       placeholder: Provide any additional information, any suggested solutions, and as much context and examples as possible
37     validations:
38       required: true
39   - type: checkboxes
40     id: verbose
41     attributes:
42       label: Provide verbose output that clearly demonstrates the problem
43       options:
44         - label: Run **your** yt-dlp command with **-vU** flag added (`yt-dlp -vU <your command line>`)
45           required: true
46         - label: "If using API, add `'verbose': True` to `YoutubeDL` params instead"
47           required: false
48         - label: Copy the WHOLE output (starting with `[debug] Command-line config`) and insert it below
49           required: true
50   - type: textarea
51     id: log
52     attributes:
53       label: Complete Verbose Output
54       description: |
55         It should start like this:
56       placeholder: |
57         [debug] Command-line config: ['-vU', 'https://www.youtube.com/watch?v=BaW_jenozKc']
58         [debug] Encodings: locale cp65001, fs utf-8, pref cp65001, out utf-8, error utf-8, screen utf-8
59         [debug] yt-dlp version nightly@... from yt-dlp/yt-dlp [b634ba742] (win_exe)
60         [debug] Python 3.8.10 (CPython 64bit) - Windows-10-10.0.22000-SP0
61         [debug] exe versions: ffmpeg N-106550-g072101bd52-20220410 (fdk,setts), ffprobe N-106624-g391ce570c8-20220415, phantomjs 2.1.1
62         [debug] Optional libraries: Cryptodome-3.15.0, brotli-1.0.9, certifi-2022.06.15, mutagen-1.45.1, sqlite3-2.6.0, websockets-10.3
63         [debug] Proxy map: {}
64         [debug] Request Handlers: urllib, requests
65         [debug] Loaded 1893 extractors
66         [debug] Fetching release info: https://api.github.com/repos/yt-dlp/yt-dlp-nightly-builds/releases/latest
67         yt-dlp is up to date (nightly@... from yt-dlp/yt-dlp-nightly-builds)
68         [youtube] Extracting URL: https://www.youtube.com/watch?v=BaW_jenozKc
69         <more lines>
70       render: shell
71     validations:
72       required: true
73   - type: markdown
74     attributes:
75       value: |
76         > [!CAUTION]
77         > ### GitHub is experiencing a high volume of malicious spam comments.
78         > ### If you receive any replies asking you download a file, do NOT follow the download links!
79         >
80         > Note that this issue may be temporarily locked as an anti-spam measure after it is opened.