youtube-dl

KO | EN

gitlite — search

#python #go #rust #deep-learning #java #nodejs #windows #awesome #cli #awesome-list #pytorch #security #openai #mcp

(★ 140,982)

YouTube.com 및 기타 동영상 사이트에서 동영상을 다운로드하는 커맨드라인 프로그램

파일 탐색기

최종 버전 다운로드 (.zip)

- - 1_broken_site.md
  - 2_site_support_request.md
  - 3_site_feature_request.md
  - 4_bug_report.md
  - 5_feature_request.md
  - 6_question.md
  - config.yml
- - 1_broken_site.md
  - 2_site_support_request.md
  - 3_site_feature_request.md
  - 4_bug_report.md
  - 5_feature_request.md
- - ci.yml
- PULL_REQUEST_TEMPLATE.md
- youtube-dl
- - add-version.py
  - generate-download.py
  - sign-versions.py
  - update-copyright.py
  - update-feed.py
  - update-sites.py
- __init__.py
- bash-completion.in
- bash-completion.py
- buildserver.py
- check-porn.py
- cli_to_api.py
- create-github-release.py
- fish-completion.in
- fish-completion.py
- generate_aes_testdata.py
- lazy_load_template.py
- make_contributing.py
- make_issue_template.py
- make_lazy_extractors.py
- make_readme.py
- make_supportedsites.py
- posix-locale.sh
- prepare_manpage.py
- release.sh
- run_tests.bat
- run_tests.sh
- show-downloads-statistics.py
- SizeOfImage.patch
- SizeOfImage_w.patch
- utils.py
- wine-py2exe.sh
- zsh-completion.in
- zsh-completion.py
- .gitignore
- conf.py
- index.rst
- Makefile
- module_guide.rst
- supportedsites.md
- - .gitignore
  - ArrayAccess.as
  - ClassCall.as
  - ClassConstruction.as
  - ConstantInt.as
  - ConstArrayAccess.as
  - DictCall.as
  - EqualsOperator.as
  - LocalVars.as
  - MemberAssignment.as
  - NeOperator.as
  - PrivateCall.as
  - PrivateVoidCall.as
  - StaticAssignment.as
  - StaticRetrieval.as
  - StringBasics.as
  - StringCharCodeAt.as
  - StringConversion.as
- __init__.py
- helper.py
- parameters.json
- test_aes.py
- test_age_restriction.py
- test_all_urls.py
- test_cache.py
- test_compat.py
- test_download.py
- test_downloader_external.py
- test_downloader_http.py
- test_execution.py
- test_http.py
- test_InfoExtractor.py
- test_iqiyi_sdk_interpreter.py
- test_jsinterp.py
- test_netrc.py
- test_options.py
- test_postprocessors.py
- test_socks.py
- test_subtitles.py
- test_swfinterp.py
- test_traversal.py
- test_unicode_literals.py
- test_update.py
- test_utils.py
- test_verbose_output.py
- test_write_annotations.py
- test_youtube_lists.py
- test_youtube_misc.py
- test_youtube_signature.py
- test_YoutubeDL.py
- test_YoutubeDLCookieJar.py
- testcert.pem
- versions.json
- - __init__.py
  - common.py
  - dash.py
  - external.py
  - f4m.py
  - fragment.py
  - hls.py
  - http.py
  - ism.py
  - niconico.py
  - rtmp.py
  - rtsp.py
- - __init__.py
  - abc.py
  - abcnews.py
  - abcotvs.py
  - academicearth.py
  - acast.py
  - adn.py
  - adobeconnect.py
  - adobepass.py
  - adobetv.py
  - adultswim.py
  - aenetworks.py
  - afreecatv.py
  - airmozilla.py
  - aliexpress.py
  - aljazeera.py
  - allocine.py
  - alphaporno.py
  - alsace20tv.py
  - amara.py
  - amcnetworks.py
  - americastestkitchen.py
  - amp.py
  - animeondemand.py
  - anvato.py
  - aol.py
  - apa.py
  - aparat.py
  - appleconnect.py
  - applepodcasts.py
  - appletrailers.py
  - archiveorg.py
  - arcpublishing.py
  - ard.py
  - arkena.py
  - arnes.py
  - arte.py
  - asiancrush.py
  - atresplayer.py
  - atttechchannel.py
  - atvat.py
  - audimedia.py
  - audioboom.py
  - audiomack.py
  - awaan.py
  - aws.py
  - azmedien.py
  - baidu.py
  - bandaichannel.py
  - bandcamp.py
  - bbc.py
  - beatport.py
  - beeg.py
  - behindkink.py
  - bellmedia.py
  - bet.py
  - bfi.py
  - bfmtv.py
  - bibeltv.py
  - bigflix.py
  - bigo.py
  - bild.py
  - bilibili.py
  - biobiochiletv.py
  - biqle.py
  - bitchute.py
  - bleacherreport.py
  - blerp.py
  - bloomberg.py
  - bokecc.py
  - bongacams.py
  - bostonglobe.py
  - box.py
  - bpb.py
  - br.py
  - bravotv.py
  - breakcom.py
  - brightcove.py
  - businessinsider.py
  - buzzfeed.py
  - byutv.py
  - c56.py
  - caffeine.py
  - callin.py
  - camdemy.py
  - cammodels.py
  - camtube.py
  - camwithher.py
  - canalc2.py
  - canalplus.py
  - canvas.py
  - carambatv.py
  - cartoonnetwork.py
  - cbc.py
  - cbs.py
  - cbsinteractive.py
  - cbslocal.py
  - cbsnews.py
  - cbssports.py
  - ccc.py
  - ccma.py
  - cctv.py
  - cda.py
  - ceskatelevize.py
  - channel9.py
  - charlierose.py
  - chaturbate.py
  - chilloutzone.py
  - chirbit.py
  - cinchcast.py
  - cinemax.py
  - ciscolive.py
  - cjsw.py
  - clipchamp.py
  - cliphunter.py
  - clippit.py
  - cliprs.py
  - clipsyndicate.py
  - closertotruth.py
  - cloudflarestream.py
  - cloudy.py
  - clubic.py
  - clyp.py
  - cmt.py
  - cnbc.py
  - cnn.py
  - comedycentral.py
  - common.py
  - commonmistakes.py
  - commonprotocols.py
  - condenast.py
  - contv.py
  - corus.py
  - coub.py
  - cpac.py
  - cracked.py
  - crackle.py
  - crooksandliars.py
  - crunchyroll.py
  - cspan.py
  - ctsnews.py
  - ctv.py
  - ctvnews.py
  - cultureunplugged.py
  - curiositystream.py
  - cwtv.py
  - dailymail.py
  - dailymotion.py
  - daum.py
  - dbtv.py
  - dctp.py
  - deezer.py
  - defense.py
  - democracynow.py
  - dfb.py
  - dhm.py
  - digg.py
  - digiteka.py
  - discovery.py
  - discoverygo.py
  - discoverynetworks.py
  - discoveryvr.py
  - disney.py
  - dispeak.py
  - dlf.py
  - dlive.py
  - dotsub.py
  - douyutv.py
  - dplay.py
  - drbonanza.py
  - dreisat.py
  - dropbox.py
  - drtuber.py
  - drtv.py
  - dtube.py
  - dumpert.py
  - dvtv.py
  - dw.py
  - eagleplatform.py
  - ebaumsworld.py
  - echomsk.py
  - egghead.py
  - ehow.py
  - eighttracks.py
  - einthusan.py
  - eitb.py
  - ellentube.py
  - elpais.py
  - embedly.py
  - engadget.py
  - epidemicsound.py
  - eporner.py
  - eroprofile.py
  - escapist.py
  - espn.py
  - esri.py
  - europa.py
  - expotv.py
  - expressen.py
  - extractors.py
  - extremetube.py
  - eyedotv.py
  - facebook.py
  - faz.py
  - fc2.py
  - fczenit.py
  - fifa.py
  - filmon.py
  - filmweb.py
  - firsttv.py
  - fivemin.py
  - fivetv.py
  - flickr.py
  - folketinget.py
  - footyroom.py
  - formula1.py
  - fourtube.py
  - fox.py
  - fox9.py
  - foxgay.py
  - foxnews.py
  - foxsports.py
  - franceculture.py
  - franceinter.py
  - francetv.py
  - freesound.py
  - freespeech.py
  - freshlive.py
  - frontendmasters.py
  - fujitv.py
  - funimation.py
  - funk.py
  - fusion.py
  - gaia.py
  - gameinformer.py
  - gamespot.py
  - gamestar.py
  - gaskrank.py
  - gazeta.py
  - gbnews.py
  - gdcvault.py
  - gedidigital.py
  - generic.py
  - gfycat.py
  - giantbomb.py
  - giga.py
  - gigya.py
  - glide.py
  - globalplayer.py
  - globo.py
  - go.py
  - godtube.py
  - golem.py
  - googledrive.py
  - googlepodcasts.py
  - googlesearch.py
  - goshgay.py
  - gputechconf.py
  - groupon.py
  - hbo.py
  - hearthisat.py
  - heise.py
  - hellporno.py
  - helsinki.py
  - hentaistigma.py
  - hgtv.py
  - hidive.py
  - historicfilms.py
  - hitbox.py
  - hitrecord.py
  - hketv.py
  - hornbunny.py
  - hotnewhiphop.py
  - hotstar.py
  - howcast.py
  - howstuffworks.py
  - hrfernsehen.py
  - hrti.py
  - huajiao.py
  - huffpost.py
  - hungama.py
  - hypem.py
  - ign.py
  - iheart.py
  - imdb.py
  - imggaming.py
  - imgur.py
  - ina.py
  - inc.py
  - indavideo.py
  - infoq.py
  - instagram.py
  - internazionale.py
  - internetvideoarchive.py
  - iprima.py
  - iqiyi.py
  - ir90tv.py
  - itv.py
  - ivi.py
  - ivideon.py
  - iwara.py
  - izlesene.py
  - jamendo.py
  - jeuxvideo.py
  - joj.py
  - jove.py
  - jwplatform.py
  - kakao.py
  - kaltura.py
  - kankan.py
  - karaoketv.py
  - karrierevideos.py
  - keezmovies.py
  - ketnet.py
  - khanacademy.py
  - kickstarter.py
  - kinja.py
  - kinopoisk.py
  - kommunetv.py
  - konserthusetplay.py
  - krasview.py
  - kth.py
  - ku6.py
  - kusi.py
  - kuwo.py
  - la7.py
  - laola1tv.py
  - lbry.py
  - lci.py
  - lcp.py
  - lecture2go.py
  - lecturio.py
  - leeco.py
  - lego.py
  - lemonde.py
  - lenta.py
  - libraryofcongress.py
  - libsyn.py
  - lifenews.py
  - limelight.py
  - line.py
  - linkedin.py
  - linuxacademy.py
  - litv.py
  - livejournal.py
  - livestream.py
  - lnkgo.py
  - localnews8.py
  - lovehomeporn.py
  - lrt.py
  - lynda.py
  - m6.py
  - mailru.py
  - malltv.py
  - mangomolo.py
  - manyvids.py
  - maoritv.py
  - markiza.py
  - massengeschmacktv.py
  - matchtv.py
  - mdr.py
  - medaltv.py
  - medialaan.py
  - mediaset.py
  - mediasite.py
  - medici.py
  - megaphone.py
  - meipai.py
  - melonvod.py
  - meta.py
  - metacafe.py
  - metacritic.py
  - mgoon.py
  - mgtv.py
  - miaopai.py
  - microsoftvirtualacademy.py
  - minds.py
  - ministrygrid.py
  - minoto.py
  - miomio.py
  - mit.py
  - mitele.py
  - mixcloud.py
  - mlb.py
  - mnet.py
  - moevideo.py
  - mofosex.py
  - mojvideo.py
  - morningstar.py
  - motherless.py
  - motorsport.py
  - movieclips.py
  - moviezine.py
  - movingimage.py
  - msn.py
  - mtv.py
  - muenchentv.py
  - mwave.py
  - mychannels.py
  - myspace.py
  - myspass.py
  - myvi.py
  - myvideoge.py
  - myvidster.py
  - nationalgeographic.py
  - naver.py
  - nba.py
  - nbc.py
  - ndr.py
  - ndtv.py
  - nerdcubed.py
  - neteasemusic.py
  - netzkino.py
  - newgrounds.py
  - newstube.py
  - nextmedia.py
  - nexx.py
  - nfl.py
  - nhk.py
  - nhl.py
  - nick.py
  - niconico.py
  - ninecninemedia.py
  - ninegag.py
  - ninenow.py
  - nintendo.py
  - njpwworld.py
  - nobelprize.py
  - nonktube.py
  - noovo.py
  - normalboots.py
  - nosvideo.py
  - nova.py
  - nowness.py
  - noz.py
  - npo.py
  - npr.py
  - nrk.py
  - nrl.py
  - ntvcojp.py
  - ntvde.py
  - ntvru.py
  - nuevo.py
  - nuvid.py
  - nytimes.py
  - nzz.py
  - odatv.py
  - odnoklassniki.py
  - oktoberfesttv.py
  - once.py
  - ondemandkorea.py
  - onet.py
  - onionstudios.py
  - ooyala.py
  - openload.py
  - ora.py
  - orf.py
  - outsidetv.py
  - packtpub.py
  - palcomp3.py
  - pandoratv.py
  - parliamentliveuk.py
  - patreon.py
  - pbs.py
  - pearvideo.py
  - peekvids.py
  - peertube.py
  - people.py
  - performgroup.py
  - periscope.py
  - philharmoniedeparis.py
  - phoenix.py
  - photobucket.py
  - picarto.py
  - piksel.py
  - pinkbike.py
  - pinterest.py
  - pladform.py
  - platzi.py
  - playfm.py
  - playplustv.py
  - plays.py
  - playstuff.py
  - playtvak.py
  - playvid.py
  - playwire.py
  - pluralsight.py
  - podomatic.py
  - pokemon.py
  - polskieradio.py
  - popcorntimes.py
  - popcorntv.py
  - porn91.py
  - porncom.py
  - pornhd.py
  - pornhub.py
  - pornotube.py
  - pornovoisines.py
  - pornoxo.py
  - pr0gramm.py
  - presstv.py
  - prosiebensat1.py
  - puhutv.py
  - puls4.py
  - pyvideo.py
  - qqmusic.py
  - r7.py
  - radiobremen.py
  - radiocanada.py
  - radiode.py
  - radiofrance.py
  - radiojavan.py
  - rai.py
  - raywenderlich.py
  - rbgtum.py
  - rbmaradio.py
  - rds.py
  - redbulltv.py
  - reddit.py
  - redtube.py
  - regiotv.py
  - rentv.py
  - restudy.py
  - reuters.py
  - reverbnation.py
  - rice.py
  - rmcdecouverte.py
  - ro220.py
  - rockstargames.py
  - roosterteeth.py
  - rottentomatoes.py
  - roxwel.py
  - rozhlas.py
  - rtbf.py
  - rte.py
  - rtl2.py
  - rtlnl.py
  - rtp.py
  - rts.py
  - rtve.py
  - rtvnh.py
  - rtvs.py
  - ruhd.py
  - rumble.py
  - rutube.py
  - rutv.py
  - ruutu.py
  - ruv.py
  - s4c.py
  - safari.py
  - samplefocus.py
  - sapo.py
  - savefrom.py
  - sbs.py
  - screencast.py
  - screencastomatic.py
  - scrippsnetworks.py
  - scte.py
  - seeker.py
  - senateisvp.py
  - sendtonews.py
  - servus.py
  - sevenplus.py
  - sexu.py
  - seznamzpravy.py
  - shahid.py
  - shared.py
  - showroomlive.py
  - simplecast.py
  - sina.py
  - sixplay.py
  - sky.py
  - skyit.py
  - skylinewebcams.py
  - skynewsarabia.py
  - slideshare.py
  - slideslive.py
  - slutload.py
  - snotr.py
  - sohu.py
  - sonyliv.py
  - soundcloud.py
  - soundgasm.py
  - southpark.py
  - spankbang.py
  - spankwire.py
  - spiegel.py
  - spike.py
  - sport5.py
  - sportbox.py
  - sportdeutschland.py
  - spotify.py
  - spreaker.py
  - springboardplatform.py
  - sprout.py
  - srgssr.py
  - srmediathek.py
  - stanfordoc.py
  - steam.py
  - stitcher.py
  - storyfire.py
  - streamable.py
  - streamcloud.py
  - streamcz.py
  - streamsb.py
  - streetvoice.py
  - stretchinternet.py
  - stv.py
  - sunporno.py
  - sverigesradio.py
  - svt.py
  - swrmediathek.py
  - syfy.py
  - sztvhu.py
  - tagesschau.py
  - tass.py
  - tbs.py
  - tdslifeway.py
  - teachable.py
  - teachertube.py
  - teachingchannel.py
  - teamcoco.py
  - teamtreehouse.py
  - techtalks.py
  - ted.py
  - tele13.py
  - tele5.py
  - telebruxelles.py
  - telecinco.py
  - telegraaf.py
  - telemb.py
  - telequebec.py
  - teletask.py
  - telewebion.py
  - tennistv.py
  - tenplay.py
  - testurl.py
  - tf1.py
  - tfo.py
  - theintercept.py
  - theplatform.py
  - thescene.py
  - thestar.py
  - thesun.py
  - theweatherchannel.py
  - thisamericanlife.py
  - thisav.py
  - thisoldhouse.py
  - thisvid.py
  - threeqsdn.py
  - tiktok.py
  - tinypic.py
  - tmz.py
  - tnaflix.py
  - toggle.py
  - tonline.py
  - toongoggles.py
  - toutv.py
  - toypics.py
  - traileraddict.py
  - trilulilu.py
  - trovo.py
  - trunews.py
  - trutv.py
  - tube8.py
  - tubitv.py
  - tudou.py
  - tumblr.py
  - tunein.py
  - tunepk.py
  - turbo.py
  - turner.py
  - tv2.py
  - tv2dk.py
  - tv2hu.py
  - tv4.py
  - tv5mondeplus.py
  - tv5unis.py
  - tva.py
  - tvanouvelles.py
  - tvc.py
  - tver.py
  - tvigle.py
  - tvland.py
  - tvn24.py
  - tvnet.py
  - tvnoe.py
  - tvnow.py
  - tvp.py
  - tvplay.py
  - tvplayer.py
  - tweakers.py
  - twentyfourvideo.py
  - twentymin.py
  - twentythreevideo.py
  - twitcasting.py
  - twitch.py
  - twitter.py
  - udemy.py
  - udn.py
  - ufctv.py
  - uktvplay.py
  - umg.py
  - unistra.py
  - unity.py
  - uol.py
  - uplynk.py
  - urort.py
  - urplay.py
  - usanetwork.py
  - usatoday.py
  - ustream.py
  - ustudio.py
  - varzesh3.py
  - vbox7.py
  - veehd.py
  - veoh.py
  - vesti.py
  - vevo.py
  - vgtv.py
  - vh1.py
  - vice.py
  - vidbit.py
  - viddler.py
  - videa.py
  - videodetective.py
  - videofyme.py
  - videomore.py
  - videopress.py
  - vidio.py
  - vidlii.py
  - vidme.py
  - vier.py
  - viewlift.py
  - viidea.py
  - viki.py
  - vimeo.py
  - vimple.py
  - vine.py
  - viqeo.py
  - viu.py
  - vk.py
  - vlive.py
  - vodlocker.py
  - vodpl.py
  - vodplatform.py
  - voicerepublic.py
  - voot.py
  - voxmedia.py
  - vrak.py
  - vrt.py
  - vrv.py
  - vshare.py
  - vtm.py
  - vube.py
  - vuclip.py
  - vvvvid.py
  - vyborymos.py
  - vzaar.py
  - wakanim.py
  - walla.py
  - washingtonpost.py
  - wat.py
  - watchbox.py
  - watchindianporn.py
  - wdr.py
  - webcaster.py
  - webofstories.py
  - weibo.py
  - weiqitv.py
  - whyp.py
  - wistia.py
  - worldstarhiphop.py
  - wsj.py
  - wwe.py
  - xbef.py
  - xboxclips.py
  - xfileshare.py
  - xhamster.py
  - xiami.py
  - ximalaya.py
  - xminus.py
  - xnxx.py
  - xstream.py
  - xtube.py
  - xuite.py
  - xvideos.py
  - xxxymovies.py
  - yahoo.py
  - yandexdisk.py
  - yandexmusic.py
  - yandexvideo.py
  - yapfiles.py
  - yesjapan.py
  - yinyuetai.py
  - ynet.py
  - youjizz.py
  - youku.py
  - younow.py
  - youporn.py
  - yourporn.py
  - yourupload.py
  - youtube.py
  - zapiks.py
  - zattoo.py
  - zdf.py
  - zhihu.py
  - zingmp3.py
  - zoom.py
  - zype.py
- - __init__.py
  - common.py
  - embedthumbnail.py
  - execafterdownload.py
  - ffmpeg.py
  - metadatafromtitle.py
  - xattrpp.py
- __init__.py
- __main__.py
- aes.py
- cache.py
- casefold.py
- compat.py
- jsinterp.py
- options.py
- socks.py
- swfinterp.py
- traversal.py
- update.py
- utils.py
- version.py
- YoutubeDL.py
.gitignore
AUTHORS
ChangeLog
CONTRIBUTING.md
LICENSE
Makefile
MANIFEST.in
README.md
setup.cfg
setup.py
tox.ini
youtube-dl.plugin.zsh

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![빌드 상태](https://github.com/ytdl-org/youtube-dl/workflows/CI/badge.svg)](https://github.com/ytdl-org/youtube-dl/actions?query=workflow%3ACI)

youtube-dl - youtube.com 또는 기타 비디오 플랫폼에서 동영상을 다운로드합니다.

- [설치](#installation)
- [설명](#description)
- [옵션](#options)
- [설정](#configuration)
- [출력 템플릿](#output-template)
- [포맷 선택](#format-selection)
- [비디오 선택](#video-selection)
- [FAQ](#faq)
- [개발자 지침](#developer-instructions)
- [YOUTUBE-DL 임베딩](#embedding-youtube-dl)
- [버그](#bugs)
- [저작권](#copyright)

# 설치

모든 UNIX 사용자(Linux, macOS 등)를 위해 즉시 설치하려면 다음 명령을 입력하세요:

sudo curl -L https://yt-dl.org/downloads/latest/youtube-dl -o /usr/local/bin/youtube-dl
    sudo chmod a+rx /usr/local/bin/youtube-dl

curl이 없는 경우, 대신 최신 wget을 사용할 수 있습니다:

sudo wget https://yt-dl.org/downloads/latest/youtube-dl -O /usr/local/bin/youtube-dl
    sudo chmod a+rx /usr/local/bin/youtube-dl

Windows 사용자는 [.exe 파일을 다운로드](https://yt-dl.org/latest/youtube-dl.exe)하여 `%SYSTEMROOT%\System32`를 제외한 [PATH](https://en.wikipedia.org/wiki/PATH_%28variable%29)상의 아무 위치에나 놓을 수 있습니다(예: `C:\Windows\System32`에는 **넣지 마세요**).

pip를 사용할 수도 있습니다:

sudo -H pip install --upgrade youtube-dl

이 명령은 이미 youtube-dl을 설치한 경우 이를 업데이트합니다. 자세한 내용은 [pypi 페이지](https://pypi.python.org/pypi/youtube_dl)를 참조하세요.

macOS 사용자는 [Homebrew](https://brew.sh/)를 사용하여 youtube-dl을 설치할 수 있습니다:

brew install youtube-dl

또는 [MacPorts](https://www.macports.org/)를 사용할 수 있습니다:

sudo port install youtube-dl

또는 git 저장소를 체크아웃하고 작업하는 방법에 대해서는 [개발자 지침](#developer-instructions)을 참조하세요. PGP 서명을 포함한 추가 옵션은 [youtube-dl 다운로드 페이지](https://ytdl-org.github.io/youtube-dl/download.html)를 참조하세요.

# 설명
**youtube-dl**은 YouTube.com 및 그 외 여러 사이트에서 비디오를 다운로드하기 위한 명령줄 프로그램입니다. Python 인터프리터 버전 2.6, 2.7 또는 3.2+가 필요하며 플랫폼에 종속되지 않습니다. Unix 시스템, Windows 또는 macOS에서 작동합니다. 퍼블릭 도메인으로 배포되므로 수정, 재배포 또는 원하는 대로 사용할 수 있습니다.

youtube-dl [옵션] URL [URL...]

# 옵션
    -h, --help                           이 도움말 텍스트를 출력하고 종료합니다.
    --version                            프로그램 버전을 출력하고 종료합니다.
    -U, --update                         이 프로그램을 최신 버전으로 업데이트합니다.
                                         충분한 권한이 있는지 확인하세요
                                         (필요한 경우 sudo로 실행)
    -i, --ignore-errors                  다운로드 오류 발생 시 계속 진행합니다.
                                         예를 들어 재생 목록에서 사용할 수 없는
                                         비디오를 건너뛸 때 유용합니다.
    --abort-on-error                     오류가 발생할 경우 추가 비디오 다운로드를
                                         중단합니다(재생 목록 또는 명령줄에서).
    --dump-user-agent                    현재 브라우저 식별 정보를 표시합니다.
    --list-extractors                    지원되는 모든 추출기를 나열합니다.
    --extractor-descriptions             지원되는 모든 추출기의 설명을 출력합니다.
    --force-generic-extractor            강제로 일반(generic) 추출기를 사용합니다.
    --default-search PREFIX              적격하지 않은 URL에 이 접두사를 사용합니다.
                                         예를 들어 "gvsearch2:"는 youtube-dl
                                         "large apple"에 대해 google videos에서
                                         두 개의 비디오를 다운로드합니다.
                                         youtube-dl이 추측하도록 하려면 "auto"
                                         값을 사용하세요(추측 시 경고를 출력하려면
                                         "auto_warning" 사용).
                                         "error"는 단순히 오류를 발생시킵니다.
                                         기본값인 "fixup_error"는 손상된 URL을
                                         복구하지만, 검색하는 대신 불가능할
                                         경우 오류를 발생시킵니다.
    --ignore-config                      설정 파일을 읽지 않습니다. 전역 설정 파일
                                         /etc/youtube-dl.conf에 지정된 경우:
                                         ~/.config/youtube-dl/config의 사용자
                                         설정을 읽지 않습니다
                                         (Windows의 경우 %APPDATA%/youtube-dl/config.txt)
    --config-location PATH               설정 파일의 위치; 설정 파일 경로 또는
                                         해당 파일이 포함된 디렉토리입니다.
    --flat-playlist                      재생 목록의 비디오를 추출하지 않고 목록만 표시합니다.
    --mark-watched                       비디오를 시청한 것으로 표시합니다(YouTube 전용).
    --no-mark-watched                    비디오를 시청한 것으로 표시하지 않습니다
                                         (YouTube 전용).
    --no-color                           출력에 색상 코드를 내보내지 않습니다.

## 네트워크 옵션:
    --proxy URL                          지정된 HTTP/HTTPS/SOCKS 프록시를 사용합니다.
                                         SOCKS 프록시를 활성화하려면 올바른 스킴을
                                         지정하세요. 예: socks5://127.0.0.1:1080/.
                                         직접 연결하려면 빈 문자열(--proxy "")을
                                         전달합니다.
    --socket-timeout SECONDS             포기하기 전까지 대기하는 시간(초)입니다.
    --source-address IP                  바인딩할 클라이언트 측 IP 주소입니다.
    -4, --force-ipv4                     모든 연결을 IPv4를 통해 수행합니다.
    -6, --force-ipv6                     모든 연결을 IPv6를 통해 수행합니다.

## 지역 제한:
    --geo-verification-proxy URL         일부 지역 제한 사이트의 IP 주소를 확인하기 위해
                                         이 프록시를 사용합니다. 실제 다운로드에는
                                         --proxy로 지정된 기본 프록시(옵션이 없는 경우 없음)가
                                         사용됩니다.
    --geo-bypass                         X-Forwarded-For HTTP 헤더를 위조하여 지역 제한을 우회합니다.
    --no-geo-bypass                      X-Forwarded-For HTTP 헤더를 위조하여 지역 제한을
                                         우회하지 않습니다.
    --geo-bypass-country CODE            명시적으로 제공된 두 글자의 ISO 3166-2 국가 코드를
                                         사용하여 지역 제한 우회를 강제합니다.
    --geo-bypass-ip-block IP_BLOCK       CIDR 표기법으로 명시적으로 제공된 IP 블록을 사용하여
                                         지역 제한 우회를 강제합니다.

## 비디오 선택:
    --playlist-start NUMBER              시작할 재생 목록 비디오(기본값은 1)
    --playlist-end NUMBER                종료할 재생 목록 비디오(기본값은 마지막)
    --playlist-items ITEM_SPEC           다운로드할 재생 목록 비디오 항목.
                                         재생 목록에서 다운로드하려는 비디오의 인덱스를
                                         쉼표로 구분하여 지정하세요. 예: 재생 목록의
                                         1, 2, 5, 8번 인덱스 비디오를 다운로드하려면
                                         "--playlist-items 1,2,5,8"을 사용합니다.
                                         범위를 지정할 수 있습니다: "--playlist-items 1-3,7,10-13",
                                         이 경우 인덱스 1, 2, 3, 7, 10, 11, 12, 13의 비디오를
                                         다운로드합니다.
    --match-title REGEX                  일치하는 제목만 다운로드합니다(정규 표현식 또는 대소문자 구분 없는 부분 문자열).
    --reject-title REGEX                 일치하는 제목의 다운로드를 건너뜁니다
                                         (정규 표현식 또는 대소문자 구분 없는 부분 문자열).
    --max-downloads NUMBER               NUMBER 개 파일을 다운로드한 후 중단합니다.
    --min-filesize SIZE                  SIZE보다 작은 비디오는 다운로드하지 않습니다
                                         (예: 50k 또는 44.6m).
    --max-filesize SIZE                  SIZE보다 큰 비디오는 다운로드하지 않습니다
                                         (예: 50k 또는 44.6m).
    --date DATE                          이 날짜에 업로드된 비디오만 다운로드합니다.
    --datebefore DATE                    이 날짜 이전에 업로드된 비디오만 다운로드합니다
                                         (해당 날짜 포함).
    --dateafter DATE                     이 날짜 이후에 업로드된 비디오만 다운로드합니다
                                         (해당 날짜 포함).
    --min-views COUNT                    조회수가 COUNT 미만인 비디오는 다운로드하지 않습니다.
    --max-views COUNT                    조회수가 COUNT 초과인 비디오는 다운로드하지 않습니다.
    --match-filter FILTER                일반 비디오 필터. 키가 존재하는지 일치시키려면
                                         키를 지정하고(사용 가능한 키 목록은 "출력 템플릿" 참조),
                                         키가 존재하지 않는지 확인하려면 !키,
                                         숫자 비교를 하려면 key > NUMBER ("comment_count > 12"처럼
                                         >=, <, <=, !=, = 도 작동함), 문자열 리터럴과 비교하려면
                                         key = 'LITERAL' ("uploader = 'Mike Smith'"처럼 != 도 작동함),
                                         여러 일치를 요구하려면 &를 사용합니다.
                                         알 수 없는 값은 연산자 뒤에 물음표(?)를 붙이지 않는 한 제외됩니다.
                                         예를 들어, 좋아요가 100회 초과이고 싫어요가 50회 미만인
                                         (또는 해당 서비스에서 싫어요 기능을 사용할 수 없는) 비디오 중
                                         설명도 있는 비디오만 일치시키려면
                                         --match-filter "like_count > 100 & dislike_count <? 50 & description"을
                                         사용하세요.
    --no-playlist                        URL이 비디오와 재생 목록 모두를 가리키는 경우, 비디오만 다운로드합니다.
    --yes-playlist                       URL이 비디오와 재생 목록 모두를 가리키는 경우, 재생 목록을 다운로드합니다.
    --age-limit YEARS                    지정된 연령에 적합한 비디오만 다운로드합니다.
    --download-archive FILE              아카이브 파일에 나열되지 않은 비디오만 다운로드합니다.
                                         다운로드한 모든 비디오의 ID를 이 파일에 기록합니다.
    --include-ads                        광고도 함께 다운로드합니다(실험적 기능).

## 다운로드 옵션:
    -r, --limit-rate RATE                초당 바이트 단위의 최대 다운로드 속도
                                         (예: 50K 또는 4.2M)
    -R, --retries RETRIES                재시도 횟수(기본값은 10) 또는 "infinite"(무한).
    --fragment-retries RETRIES           조각(fragment) 재시도 횟수(기본값은 10) 또는
                                         "infinite"(DASH, hlsnative 및 ISM)
    --skip-unavailable-fragments         사용할 수 없는 조각을 건너뜁니다(DASH, hlsnative 및 ISM)
    --abort-on-unavailable-fragment      일부 조각을 사용할 수 없을 때 다운로드를 중단합니다.
    --keep-fragments                     다운로드가 완료된 후 다운로드한 조각을 디스크에 유지합니다;
                                         기본적으로 조각은 삭제됩니다.
    --buffer-size SIZE                   다운로드 버퍼의 크기(예: 1024 또는 16K)(기본값은 1024)
    --no-resize-buffer                   버퍼 크기를 자동으로 조정하지 않습니다.
                                         기본적으로 버퍼 크기는 초기 크기인 SIZE에서
                                         자동으로 크기가 조절됩니다.
    --http-chunk-size SIZE               청크 기반 HTTP 다운로드를 위한 청크 크기
                                         (예: 10485760 또는 10M)(기본값은 비활성화).
                                         웹 서버에 의해 부과된 대역폭 제한을 우회하는 데
                                         유용할 수 있습니다(실험적 기능).
    --playlist-reverse                   재생 목록 비디오를 역순으로 다운로드합니다.
    --playlist-random                    재생 목록 비디오를 무작위 순서로 다운로드합니다.
    --xattr-set-filesize                 예상 파일 크기로 파일 xattribute ytdl.filesize를 설정합니다.
    --hls-prefer-native                  ffmpeg 대신 네이티브 HLS 다운로더를 사용합니다.
    --hls-prefer-ffmpeg                  네이티브 HLS 다운로더 대신 ffmpeg을 사용합니다.
    --hls-use-mpegts                     HLS 비디오에 mpegts 컨테이너를 사용하여,
                                         다운로드 중에 비디오를 재생할 수 있도록 합니다
                                         (일부 플레이어는 재생할 수 없을 수 있음).
    --external-downloader COMMAND        지정된 외부 다운로더를 사용합니다.
                                         현재 aria2c, avconv, axel, curl, ffmpeg, httpie, wget을 지원합니다.
    --external-downloader-args ARGS      외부 다운로더에 이러한 인수를 전달합니다.

## 파일 시스템 옵션:
    -a, --batch-file FILE                다운로드할 URL이 포함된 파일(stdin의 경우 '-'),
                                         줄당 하나의 URL. '#', ';', ']'로 시작하는 줄은
                                         주석으로 간주되어 무시됩니다.
    --id                                 파일 이름에 비디오 ID만 사용합니다.
    -o, --output TEMPLATE                출력 파일 이름 템플릿, 모든 정보는 "출력 템플릿"을 참조하세요.
    --output-na-placeholder PLACEHOLDER  출력 파일 이름 템플릿에서 사용할 수 없는 메타 필드의
                                         자리 표시자 값(기본값은 "NA")
    --autonumber-start NUMBER            %(autonumber)s의 시작 값을 지정합니다(기본값은 1).
    --restrict-filenames                 파일 이름을 ASCII 문자만으로 제한하고,
                                         파일 이름에 "&"와 공백이 들어가지 않도록 합니다.
    -w, --no-overwrites                  파일을 덮어쓰지 않습니다.
    -c, --continue                       부분적으로 다운로드한 파일의 재개를 강제합니다.
                                         기본적으로 youtube-dl은 가능하면 다운로드를 재개합니다.
    --no-continue                        부분적으로 다운로드한 파일을 재개하지 않습니다
                                         (처음부터 다시 시작).
    --no-part                            .part 파일을 사용하지 않고 출력 파일에 직접 씁니다.
    --no-mtime                           파일 수정 시간을 설정하는 데 Last-modified 헤더를
                                         사용하지 않습니다.
    --write-description                  비디오 설명을 .description 파일로 저장합니다.
    --write-info-json                    비디오 메타데이터를 .info.json 파일로 저장합니다.
    --write-annotations                  비디오 주석을 .annotations.xml 파일로 저장합니다.
    --load-info-json FILE                비디오 정보가 포함된 JSON 파일
                                         ("--write-info-json" 옵션으로 생성됨)
    --cookies FILE                       쿠키를 읽고 쿠키 저장소를 덤프할 파일입니다.
    --cache-dir DIR                      youtube-dl이 일부 다운로드된 정보를 영구적으로
                                         저장할 수 있는 파일 시스템 내 위치.
                                         기본값은 $XDG_CACHE_HOME/youtube-dl 또는
                                         ~/.cache/youtube-dl입니다. 현재는 YouTube
                                         플레이어 파일(난독화된 서명이 있는 비디오용)만
                                         캐시되지만 변경될 수 있습니다.
    --no-cache-dir                       파일 시스템 캐싱을 비활성화합니다.
    --rm-cache-dir                       모든 파일 시스템 캐시 파일을 삭제합니다.

## 썸네일 옵션:
    --write-thumbnail                    썸네일 이미지를 디스크에 저장합니다.
    --write-all-thumbnails               모든 썸네일 이미지 포맷을 디스크에 저장합니다.
    --list-thumbnails                    시뮬레이션하고 사용 가능한 모든 썸네일 포맷을 나열합니다.

## 상세 정보 출력 / 시뮬레이션 옵션:
    -q, --quiet                          조용한(quiet) 모드를 활성화합니다.
    --no-warnings                        경고를 무시합니다.
    -s, --simulate                       비디오를 다운로드하지 않고 디스크에 아무것도
                                         기록하지 않습니다.
    --skip-download                      비디오를 다운로드하지 않습니다.
    -g, --get-url                        시뮬레이션, 조용히 실행하되 URL을 출력합니다.
    -e, --get-title                      시뮬레이션, 조용히 실행하되 제목을 출력합니다.
    --get-id                             시뮬레이션, 조용히 실행하되 id를 출력합니다.
    --get-thumbnail                      시뮬레이션, 조용히 실행하되 썸네일 URL을 출력합니다.
    --get-description                    시뮬레이션, 조용히 실행하되 비디오 설명을 출력합니다.
    --get-duration                       시뮬레이션, 조용히 실행하되 비디오 길이를 출력합니다.
    --get-filename                       시뮬레이션, 조용히 실행하되 출력 파일 이름을 출력합니다.
    --get-format                         시뮬레이션, 조용히 실행하되 출력 포맷을 출력합니다.
    -j, --dump-json                      시뮬레이션, 조용히 실행하되 JSON 정보를 출력합니다.
                                         사용 가능한 키에 대한 설명은 "출력 템플릿"을 참조하세요.
    -J, --dump-single-json               시뮬레이션, 조용히 실행하되 각 명령줄 인수에 대한
                                         JSON 정보를 출력합니다. URL이 재생 목록을 가리키는 경우,
                                         재생 목록 전체 정보를 한 줄에 덤프합니다.
    --print-json                         조용히 실행하되 비디오 정보를 JSON으로 출력합니다
                                         (비디오는 계속 다운로드됨).
    --newline                            진행률 표시줄을 새 줄로 출력합니다.
    --no-progress                        진행률 표시줄을 출력하지 않습니다.
    --console-title                      콘솔 제목 표시줄에 진행 상황을 표시합니다.
    -v, --verbose                        다양한 디버깅 정보를 출력합니다.
    --dump-pages                         문제를 디버깅하기 위해 base64로 인코딩된 다운로드된 페이지를
                                         출력합니다(매우 상세함).
    --write-pages                        문제를 디버깅하기 위해 다운로드한 중간 페이지를
                                         현재 디렉토리의 파일로 저장합니다.
    --print-traffic                      송수신된 HTTP 트래픽을 표시합니다.
    -C, --call-home                      디버깅을 위해 youtube-dl 서버에 연락합니다.
    --no-call-home                       디버깅을 위해 youtube-dl 서버에 연락하지 **않습니다**.

## 우회 옵션:
    --encoding ENCODING                  지정된 인코딩을 강제합니다(실험적 기능).
    --no-check-certificate               HTTPS 인증서 유효성 검사를 생략합니다.
    --prefer-insecure                    비디오에 대한 정보를 검색할 때 암호화되지 않은
                                         연결을 사용합니다(현재 YouTube에서만 지원됨).
    --user-agent UA                      사용자 지정 user agent를 지정합니다.
    --referer URL                        사용자 지정 referer를 지정합니다. 비디오 액세스가
                                         특정 도메인으로 제한된 경우 사용하세요.
    --add-header FIELD:VALUE             사용자 지정 HTTP 헤더와 그 값을 콜론(':')으로 구분하여
                                         지정합니다. 이 옵션을 여러 번 사용할 수 있습니다.
    --bidi-workaround                    양방향 텍스트 지원이 부족한 터미널을 우회합니다.
                                         PATH에 bidiv 또는 fribidi 실행 파일이 필요합니다.
    --sleep-interval SECONDS             단독으로 사용할 경우 각 다운로드 전에 대기할 초 수,
                                         또는 --max-sleep-interval과 함께 사용할 경우 각 다운로드 전에
                                         무작위 대기 시간 범위의 하한(가능한 최소 대기 초 수)입니다.
    --max-sleep-interval SECONDS         각 다운로드 전에 무작위 대기 시간 범위의 상한
                                         (가능한 최대 대기 초 수). 반드시 --min-sleep-interval과
                                         함께 사용해야 합니다.

## 비디오 포맷 옵션:
    -f, --format FORMAT                  비디오 포맷 코드, 모든 정보는 "포맷 선택"을 참조하세요.
    --all-formats                        사용 가능한 모든 비디오 포맷을 다운로드합니다.
    --prefer-free-formats                특정 포맷이 요청되지 않는 한 무료 비디오 포맷을 선호합니다.
    -F, --list-formats                   요청된 비디오의 사용 가능한 모든 포맷을 나열합니다.
    --youtube-skip-dash-manifest         YouTube 비디오의 DASH 매니페스트 및 관련 데이터를 다운로드하지 않습니다.
    --merge-output-format FORMAT         병합이 필요한 경우(예: bestvideo+bestaudio),
                                         지정된 컨테이너 포맷으로 출력합니다.
                                         mkv, mp4, ogg, webm, flv 중 하나.
                                         병합이 필요하지 않으면 무시됩니다.

## 자막 옵션:
    --write-sub                          자막 파일을 저장합니다.
    --write-auto-sub                     자동 생성된 자막 파일을 저장합니다(YouTube 전용).
    --all-subs                           비디오의 사용 가능한 모든 자막을 다운로드합니다.
    --list-subs                          비디오의 사용 가능한 모든 자막을 나열합니다.
    --sub-format FORMAT                  자막 포맷, 포맷 선호도를 허용합니다.
                                         예: "srt" 또는 "ass/srt/best"
    --sub-lang LANGS                     다운로드할 자막의 언어(선택 사항), 쉼표로 구분하며,
                                         사용 가능한 언어 태그는 --list-subs를 사용하세요.

## 인증 옵션:
    -u, --username USERNAME              이 계정 ID로 로그인합니다.
    -p, --password PASSWORD              계정 비밀번호. 이 옵션을 생략하면 youtube-dl이
                                         대화형으로 묻습니다.
    -2, --twofactor TWOFACTOR            이중 인증(2FA) 코드
    -n, --netrc                          .netrc 인증 데이터를 사용합니다.
    --video-password PASSWORD            비디오 비밀번호(vimeo, youku)

## Adobe Pass 옵션:
    --ap-mso MSO                         Adobe Pass 복수 시스템 사업자(TV 제공업체) 식별자,
                                         사용 가능한 MSO 목록을 보려면 --ap-list-mso를 사용하세요.
    --ap-username USERNAME               복수 시스템 사업자 계정 로그인
    --ap-password PASSWORD               복수 시스템 사업자 계정 비밀번호. 이 옵션을 생략하면
                                         youtube-dl이 대화형으로 묻습니다.
    --ap-list-mso                        지원되는 모든 복수 시스템 사업자를 나열합니다.

## 후처리(Post-processing) 옵션:
    -x, --extract-audio                  비디오 파일을 오디오 전용 파일로 변환합니다
                                         (ffmpeg/avconv 및 ffprobe/avprobe 필요).
    --audio-format FORMAT                오디오 포맷 지정: "best", "aac", "flac", "mp3",
                                         "m4a", "opus", "vorbis", 또는 "wav"; 기본값은 "best";
                                         -x 없이 사용하면 효과가 없습니다.
    --audio-quality QUALITY              ffmpeg/avconv 오디오 품질을 지정합니다.
                                         VBR의 경우 0(더 좋음)에서 9(더 나쁨) 사이의 값을 넣거나,
                                         128K 같은 특정 비트레이트를 지정합니다(기본값 5).
    --recode-video FORMAT                필요한 경우 비디오를 다른 포맷으로 인코딩합니다
                                         (현재 지원됨: mp4|flv|ogg|webm|mkv|avi)
    --postprocessor-args ARGS            후처리기(postprocessor)에 이 인수를 전달합니다.
    -k, --keep-video                     후처리 완료 후 비디오 파일을 디스크에 유지합니다;
                                         기본적으로 비디오는 삭제됩니다.
    --no-post-overwrites                 후처리된 파일을 덮어쓰지 않습니다;
                                         기본적으로 후처리된 파일은 덮어써집니다.
    --embed-subs                         비디오에 자막을 삽입합니다(mp4, webm, mkv 비디오 전용).
    --embed-thumbnail                    오디오에 썸네일을 커버 아트으로 삽입합니다.
    --add-metadata                       비디오 파일에 메타데이터를 기록합니다.
    --metadata-from-title FORMAT         비디오 제목에서 곡 제목 / 아티스트 같은 추가 메타데이터를 파싱합니다.
                                         포맷 구문은 --output과 동일합니다. 명명된 캡처 그룹이 있는
                                         정규 표현식도 사용할 수 있습니다. 파싱된 매개변수는 기존 값을
                                         대체합니다. 예: --metadata-from-title "%(artist)s - %(title)s"는
                                         "Coldplay - Paradise" 같은 제목과 일치합니다.
                                         예 (정규식): --metadata-from-title "(?P<artist>.+?) - (?P<title>.+)"
    --xattrs                             비디오 파일의 xattrs에 메타데이터를 기록합니다
                                         (dublin core 및 xdg 표준 사용).
    --fixup POLICY                       파일의 알려진 결함을 자동으로 수정합니다.
                                         never(아무것도 하지 않음), warn(경고만 출력),
                                         detect_or_warn(기본값; 가능하면 파일 수정, 아니면 경고) 중 하나.
    --prefer-avconv                      후처리기 실행 시 ffmpeg보다 avconv를 선호합니다.
    --prefer-ffmpeg                      후처리기 실행 시 avconv보다 ffmpeg을 선호합니다(기본값).
    --ffmpeg-location PATH               ffmpeg/avconv 바이너리의 위치; 바이너리 경로 또는
                                         해당 파일이 포함된 디렉토리입니다.
    --exec CMD                           다운로드 및 후처리 후 파일에 대해 명령을 실행합니다.
                                         find의 -exec 구문과 유사합니다.
                                         예: --exec 'adb push {} /sdcard/Music/ && rm {}'
    --convert-subs FORMAT                자막을 다른 포맷으로 변환합니다(현재 지원됨: srt|ass|vtt|lrc)

# 설정

지원되는 명령줄 옵션을 설정 파일에 배치하여 youtube-dl을 설정할 수 있습니다. Linux와 macOS의 경우, 시스템 전역 설정 파일은 `/etc/youtube-dl.conf`에 위치하며, 사용자 전역 설정 파일은 `~/.config/youtube-dl/config`에 위치합니다. Windows의 경우 사용자 전역 설정 파일 위치는 `%APPDATA%\youtube-dl\config.txt` 또는 `C:\Users\<user name>\youtube-dl.conf`입니다. 기본적으로 설정 파일이 존재하지 않을 수 있으므로 직접 생성해야 할 수 있습니다.

예를 들어, 다음 설정 파일을 사용하면 youtube-dl은 항상 오디오를 추출하고, mtime을 복사하지 않으며, 프록시를 사용하고, 홈 디렉토리의 `Movies` 디렉토리 아래에 모든 비디오를 저장합니다:
```
# #으로 시작하는 줄은 주석입니다.

# 항상 오디오 추출
-x

# mtime 복사 안 함
--no-mtime

# 이 프록시 사용
--proxy 127.0.0.1:3128

# 홈 디렉토리의 Movies 디렉토리 아래에 모든 비디오 저장
-o ~/Movies/%(title)s.%(ext)s
```

설정 파일의 옵션은 일반 명령줄 호출에서 사용되는 옵션(스위치)과 정확히 동일하므로, `-` 또는 `--` 뒤에 **공백이 있어서는 안 됩니다**. 예를 들어 `-o` 또는 `--proxy`는 올바르지만 `- o` 또는 `-- proxy`는 안 됩니다.

특정 youtube-dl 실행 시 설정 파일을 비활성화하려면 `--ignore-config`를 사용할 수 있습니다.

특정 youtube-dl 실행 시 사용자 지정 설정 파일을 사용하려면 `--config-location`을 사용할 수 있습니다.

### `.netrc` 파일을 이용한 인증

인증을 지원하는 추출기( `--username` 및 `--password`로 로그인과 비밀번호 제공)에 대해, 모든 youtube-dl 실행 시 명령줄 인수로 자격 증명을 전달하지 않고 셸 명령 기록에 평문 비밀번호가 남는 것을 방지하기 위해 자동 자격 증명 저장을 설정하고 싶을 수 있습니다. 추출기별로 [`.netrc 파일`](https://stackoverflow.com/tags/.netrc/info)을 사용하여 이를 달성할 수 있습니다. 이를 위해 `$HOME`에 `.netrc` 파일을 만들고 오직 자신만 읽고/쓸 수 있도록 권한을 제한해야 합니다:
```
touch $HOME/.netrc
chmod a-rwx,u+rw $HOME/.netrc
```
그 후 다음과 같은 형식으로 추출기의 자격 증명을 추가할 수 있습니다. 여기서 *extractor*는 소문자로 된 추출기의 이름입니다:
```
machine <extractor> login <login> password <password>
```
예시:
```
machine youtube login myaccount@gmail.com password my_youtube_password
machine twitch login my_twitch_account_name password my_twitch_password
```
`.netrc` 파일로 인증을 활성화하려면 youtube-dl에 `--netrc`를 전달하거나 [설정 파일](#configuration)에 추가해야 합니다.

Windows에서는 `%HOME%` 환경 변수를 수동으로 설정해야 할 수도 있습니다. 예시:
```
set HOME=%USERPROFILE%
```

# 출력 템플릿

`-o` 옵션을 사용하면 사용자가 출력 파일 이름의 템플릿을 지정할 수 있습니다.

**요약:** [예제로 이동하기](#output-template-examples).

기본 사용법은 단일 파일을 다운로드할 때 `youtube-dl -o funny_video.flv "https://some/video"`처럼 템플릿 인수를 설정하지 않는 것입니다. 그러나 각 비디오를 다운로드할 때 대체될 특수 시퀀스를 포함할 수 있습니다. 특수 시퀀스는 [파이썬 문자열 포맷팅 연산](https://docs.python.org/2/library/stdtypes.html#string-formatting)에 따라 포맷될 수 있습니다. 예를 들어 `%(NAME)s` 또는 `%(NAME)05d`와 같습니다. 명확히 하자면, 이는 퍼센트 기호 뒤에 괄호로 둘러싸인 이름, 그리고 포맷팅 연산이 오는 형태입니다. 허용되는 이름과 시퀀스 유형은 다음과 같습니다:

- `id` (문자열): 비디오 식별자
 - `title` (문자열): 비디오 제목
 - `url` (문자열): 비디오 URL
 - `ext` (문자열): 비디오 파일 이름 확장자
 - `alt_title` (문자열): 비디오의 보조 제목
 - `display_id` (문자열): 비디오의 대체 식별자
 - `uploader` (문자열): 비디오 업로더의 전체 이름
 - `license` (문자열): 비디오가 라이선스된 라이선스 이름
 - `creator` (문자열): 비디오의 창작자
 - `release_date` (문자열): 비디오가 출시된 날짜 (YYYYMMDD)
 - `timestamp` (숫자): 비디오를 시청할 수 있게 된 순간의 UNIX 타임스탬프
 - `upload_date` (문자열): 비디오 업로드 날짜 (YYYYMMDD)
 - `uploader_id` (문자열): 비디오 업로더의 닉네임 또는 id
 - `channel` (문자열): 비디오가 업로드된 채널의 전체 이름
 - `channel_id` (문자열): 채널의 id
 - `location` (문자열): 비디오가 촬영된 물리적 위치
 - `duration` (숫자): 비디오의 길이(초)
 - `view_count` (숫자): 플랫폼에서 비디오를 시청한 사용자 수
 - `like_count` (숫자): 비디오의 긍정적인 평가 수
 - `dislike_count` (숫자): 비디오의 부정적인 평가 수
 - `repost_count` (숫자): 비디오 재게시 수
 - `average_rating` (숫자): 사용자가 부여한 평균 평점, 사용되는 척도는 웹페이지에 따라 다름
 - `comment_count` (숫자): 비디오의 댓글 수
 - `age_limit` (숫자): 비디오의 연령 제한(년)
 - `is_live` (부울): 이 비디오가 라이브 스트림인지 고정 길이 비디오인지 여부
 - `start_time` (숫자): URL에 지정된 대로 재생이 시작되어야 하는 시간(초)
 - `end_time` (숫자): URL에 지정된 대로 재생이 끝나야 하는 시간(초)
 - `format` (문자열): 포맷에 대한 사람이 읽기 쉬운 설명
 - `format_id` (문자열): `--format`으로 지정된 포맷 코드
 - `format_note` (문자열): 포맷에 대한 추가 정보
 - `width` (숫자): 비디오의 너비
 - `height` (숫자): 비디오의 높이
 - `resolution` (문자열): 너비와 높이에 대한 텍스트 설명
 - `tbr` (숫자): KBit/s 단위의 오디오 및 비디오 평균 비트레이트
 - `abr` (숫자): KBit/s 단위의 평균 오디오 비트레이트
 - `acodec` (문자열): 사용 중인 오디오 코덱의 이름
 - `asr` (숫자): 헤르츠 단위의 오디오 샘플링 레이트
 - `vbr` (숫자): KBit/s 단위의 평균 비디오 비트레이트
 - `fps` (숫자): 프레임 레이트
 - `vcodec` (문자열): 사용 중인 비디오 코덱의 이름
 - `container` (문자열): 컨테이너 포맷의 이름
 - `filesize` (숫자): 미리 알려진 경우 바이트 수
 - `filesize_approx` (숫자): 바이트 수의 추정치
 - `protocol` (string): 실제 다운로드에 사용될 프로토콜
 - `extractor` (문자열): 추출기의 이름
 - `extractor_key` (문자열): 추출기의 키 이름
 - `epoch` (숫자): 파일을 생성할 때의 유닉스 에폭
 - `autonumber` (숫자): `--autonumber-start`에서 시작하여 각 다운로드마다 증가하는 숫자
 - `playlist` (문자열): 비디오가 포함된 재생 목록의 이름 또는 id
 - `playlist_index` (숫자): 재생 목록의 총 길이에 따라 선행 0이 채워진 재생 목록 내 비디오의 색인
 - `playlist_id` (문자열): 재생 목록 식별자
 - `playlist_title` (문자열): 재생 목록 제목
 - `playlist_uploader` (문자열): 재생 목록 업로더의 전체 이름
 - `playlist_uploader_id` (문자열): 재생 목록 업로더의 닉네임 또는 id

논리적 챕터나 섹션에 속하는 비디오에 사용 가능:

- `chapter` (문자열): 비디오가 속한 챕터의 이름 또는 제목
 - `chapter_number` (숫자): 비디오가 속한 챕터의 번호
 - `chapter_id` (문자열): 비디오가 속한 챕터의 id

시리즈나 프로그램의 에피소드인 비디오에 사용 가능:

- `series` (문자열): 비디오 에피소드가 속한 시리즈 또는 프로그램의 제목
 - `season` (문자열): 비디오 에피소드가 속한 시즌의 제목
 - `season_number` (숫자): 비디오 에피소드가 속한 시즌의 번호
 - `season_id` (숫자): 비디오 에피소드가 속한 시즌의 id
 - `episode` (문자열): 비디오 에피소드의 제목
 - `episode_number` (숫자): 시즌 내 비디오 에피소드의 번호
 - `episode_id` (문자열): 비디오 에피소드의 id

음악 앨범의 트랙이거나 그 일부인 미디어에 사용 가능:

- `track` (문자열): 트랙의 제목
 - `track_number` (숫자): 앨범 또는 디스크 내 트랙 번호
 - `track_id` (문자열): 트랙의 id
 - `artist` (문자열): 트랙의 아티스트
 - `genre` (문자열): 트랙의 장르
 - `album` (문자열): 트랙이 속한 앨범의 제목
 - `album_type` (문자열): 앨범의 유형
 - `album_artist` (문자열): 앨범에 참여한 모든 아티스트 목록
 - `disc_number` (숫자): 트랙이 속한 디스크 또는 기타 물리적 매체의 번호
 - `release_year` (숫자): 앨범이 출시된 연도 (YYYY)

출력 템플릿에서 참조될 때 위의 각 시퀀스는 시퀀스 이름에 해당하는 실제 값으로 대체됩니다. 일부 시퀀스는 특정 추출기에 의해 획득된 메타데이터에 따라 달라지므로 항상 존재한다고 보장되지는 않습니다. 이러한 시퀀스는 `--output-na-placeholder`로 제공된 자리 표시자 값(기본값은 `NA`)으로 대체됩니다.

예를 들어 `-o %(title)s-%(id)s.%(ext)s`이고 제목이 `youtube-dl test video`이고 id가 `BaW_jenozKcj`인 mp4 비디오의 경우, 현재 디렉토리에 `youtube-dl test video-BaW_jenozKcj.mp4` 파일이 생성됩니다.

숫자 시퀀스의 경우 숫자 관련 포맷팅을 사용할 수 있습니다. 예를 들어 `%(view_count)05d`는 조회수 숫자가 5자리까지 0으로 채워진 문자열(예: `00042`)이 됩니다.

출력 템플릿은 임의의 계층적 경로도 포함할 수 있습니다. 예를 들어 `-o '%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s'`는 이 경로 템플릿에 해당하는 디렉토리에 각 비디오를 다운로드하게 됩니다. 누락된 디렉토리는 자동으로 생성됩니다.

출력 템플릿에서 퍼센트 리터럴을 사용하려면 `%%`를 사용하세요. 표준 출력(stdout)으로 출력하려면 `-o -`를 사용하세요.

현재 기본 템플릿은 `%(title)s-%(id)s.%(ext)s`입니다.

다운로드한 파일 이름을 Windows 시스템으로 전송하거나 8비트 안전하지 않은 채널을 통해 전송할 때처럼, 경우에 따라 中, 공백 또는 &와 같은 특수 문자를 원하지 않을 수 있습니다. 이러한 경우 `--restrict-filenames` 플래그를 추가하여 더 짧은 제목을 얻으세요.

#### 출력 템플릿 및 Windows 배치 파일

Windows 배치 파일 내에서 출력 템플릿을 사용하는 경우 일반 퍼센트 문자(`%`)를 두 번 써서 이스케이프해야 합니다. 따라서 `-o "%(title)s-%(id)s.%(ext)s"`는 `-o "%%(title)s-%%(id)s.%%(ext)s"`가 되어야 합니다. 단, 일반 문자가 아닌 `%`는 건드리지 않아야 합니다. 예를 들어 확장용 환경 변수는 그대로 유지되어야 합니다: `-o "C:\%HOMEPATH%\Desktop\%%(title)s.%%(ext)s"`.

#### 출력 템플릿 예시

Windows에서는 작은따옴표 대신 큰따옴표를 사용해야 할 수 있습니다.

```bash
$ youtube-dl --get-filename -o '%(title)s.%(ext)s' BaW_jenozKc
youtube-dl test video ''_ä↭𝕐.mp4    # 각종 온갖 기괴한 문자들

$ youtube-dl --get-filename -o '%(title)s.%(ext)s' BaW_jenozKc --restrict-filenames
youtube-dl_test_video_.mp4          # 간단한 파일 이름

# YouTube 재생 목록 비디오를 재생 목록 내 비디오 순서로 인덱싱된 별도의 디렉토리에 다운로드
$ youtube-dl -o '%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re

# 각 재생 목록을 별도의 디렉토리에 유지하면서 YouTube 채널/사용자의 모든 재생 목록 다운로드:
$ youtube-dl -o '%(uploader)s/%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' https://www.youtube.com/user/TheLinuxFoundation/playlists

# 홈 디렉토리의 MyVideos 디렉토리 아래에 각 챕터를 별도의 디렉토리에 유지하며 Udemy 강좌 다운로드
$ youtube-dl -u user -p password -o '~/MyVideos/%(playlist)s/%(chapter_number)s - %(chapter)s/%(title)s.%(ext)s' https://www.www.udemy.com/java-tutorial/

# C:/MyVideos 아래에 각 시리즈와 각 시즌을 별도의 디렉토리에 유지하며 전체 시리즈 시즌 다운로드
$ youtube-dl -o "C:/MyVideos/%(series)s/%(season_number)s - %(season)s/%(episode_number)s - %(episode)s.%(ext)s" https://videomore.ru/kino_v_detalayah/5_sezon/367617

# 다운로드 중인 비디오를 stdout으로 스트리밍
$ youtube-dl -o - BaW_jenozKc
```

# 포맷 선택

기본적으로 youtube-dl은 사용 가능한 가장 좋은 품질을 다운로드하려고 시도합니다. 즉, 최고의 품질을 원한다면 특별한 옵션을 전달할 **필요가 없으며**, youtube-dl이 **기본적으로** 알아서 추측합니다.

하지만 연결 상태가 느리거나 불안정할 때 등 다른 포맷으로 다운로드하고 싶을 때가 있습니다. 이를 달성하기 위한 핵심 메커니즘은 이른바 *포맷 선택(format selection)*으로, 이를 바탕으로 원하는 포맷을 명시적으로 지정하고, 특정 기준에 따라 포맷을 선택하고, 우선순위를 설정하는 등의 작업을 할 수 있습니다.

포맷 선택을 위한 일반적인 구문은 `--format FORMAT` 또는 줄여서 `-f FORMAT`이며, 여기서 `FORMAT`은 *선택자 표현식(selector expression)*, 즉 다운로드하려는 포맷을 설명하는 표현식입니다.

**요약:** [예제로 이동하기](#format-selection-examples).

가장 간단한 경우는 특정 포맷을 요청하는 것입니다. 예를 들어 `-f 22`를 사용하면 포맷 코드가 22인 포맷을 다운로드할 수 있습니다. `--list-formats` 또는 `-F`를 사용하여 특정 비디오에 대해 사용 가능한 포맷 코드 목록을 얻을 수 있습니다. 이러한 포맷 코드는 추출기별로 다릅니다.

파일 확장자(현재 `3gp`, `aac`, `flv`, `m4a`, `mp3`, `mp4`, `ogg`, `wav`, `webm` 지원)를 사용하여 단일 파일로 제공되는 특정 파일 확장자의 최고 품질 포맷을 다운로드할 수도 있습니다. 예를 들어 `-f webm`은 단일 파일로 제공되는 `webm` 확장자의 최고 품질 포맷을 다운로드합니다.

특수 이름을 사용하여 특정 예외 케이스 포맷을 선택할 수도 있습니다:

- `best`: 비디오와 오디오가 포함된 단일 파일로 표현되는 최고 품질 포맷을 선택합니다.
 - `worst`: 비디오와 오디오가 포함된 단일 파일로 표현되는 최저 품질 포맷을 선택합니다.
 - `bestvideo`: 최고 품질의 비디오 전용 포맷을 선택합니다(예: DASH 비디오). 사용하지 못할 수도 있습니다.
 - `worstvideo`: 최저 품질의 비디오 전용 포맷을 선택합니다. 사용하지 못할 수도 있습니다.
 - `bestaudio`: 최고 품질의 오디오 전용 포맷을 선택합니다. 사용하지 못할 수도 있습니다.
 - `worstaudio`: 최저 품질의 오디오 전용 포맷을 선택합니다. 사용하지 못할 수도 있습니다.

예를 들어, 최저 품질의 비디오 전용 포맷을 다운로드하려면 `-f worstvideo`를 사용할 수 있습니다.

여러 비디오를 다운로드하려는데 동일한 포맷을 사용할 수 없는 경우 슬래시를 사용하여 선호도 순서를 지정할 수 있습니다. 슬래시는 좌결합성(left-associative)입니다. 즉, 왼쪽에 있는 포맷이선호됩니다. 예를 들어 `-f 22/17/18`은 포맷 22를 사용할 수 있는 경우 이를 다운로드하고, 그렇지 않은 경우 포맷 17을 사용할 수 있으면 다운로드하고, 그것도 안 되면 포맷 18을 다운로드하며, 이마저도 없으면 다운로드할 수 있는 적합한 포맷이 없다고 불평합니다.

동일한 비디오의 여러 포맷을 다운로드하려면 쉼표를 구분 기호로 사용하세요. 예를 들어 `-f 22,17,18`은 사용 가능한 경우 이 세 가지 포맷 모두를 다운로드합니다. 또는 우선순위 기능과 결합된 더 복잡한 예시: `-f 136/137/mp4/bestvideo,140/m4a/bestaudio`.

`-f "best[height=720]"`(또는 `-f "[filesize>10M]"`)에서처럼 괄호 안에 조건을 넣어 비디오 포맷을 필터링할 수도 있습니다.

다음 숫자 메타 필드는 `<`, `<=`, `>`, `>=`, `=` (같음), `!=` (같지 않음) 비교와 함께 사용할 수 있습니다:

- `filesize`: 미리 알려진 경우 바이트 수
 - `width`: 알려진 경우 비디오의 너비
 - `height`: 알려진 경우 비디오의 높이
 - `tbr`: KBit/s 단위의 오디오 및 비디오 평균 비트레이트
 - `abr`: KBit/s 단위의 평균 오디오 비트레이트
 - `vbr`: KBit/s 단위의 평균 비디오 비트레이트
 - `asr`: 헤르츠 단위의 오디오 샘플링 레이트
 - `fps`: 프레임 레이트

또한 비교 연산자 `=` (같음), `^=` (시작 문자), `$=` (끝 문자), `*=` (포함) 및 다음 문자열 메타 필드에 대해서도 필터링이 작동합니다:

- `ext`: 파일 확장자
 - `acodec`: 사용 중인 오디오 코덱의 이름
 - `vcodec`: 사용 중인 비디오 코덱의 이름
 - `container`: 컨테이너 포맷의 이름
 - `protocol`: 소문자로 된 실제 다운로드에 사용될 프로토콜 (`http`, `https`, `rtsp`, `rtmp`, `rtmpe`, `mms`, `f4m`, `ism`, `http_dash_segments`, `m3u8`, 또는 `m3u8_native`)
 - `format_id`: 포맷에 대한 간략한 설명
 - `language`: 언어 코드

반대 비교를 생성하기 위해 모든 문자열 비교 앞에 부정 `!`을 붙일 수 있습니다(예: `!*=`(포함하지 않음)).

앞서 언급한 메타 필드 중 어느 것도 특정 추출기에 의해 획득된 메타데이터, 즉 비디오 호스팅 업체가 제공하는 메타데이터에 전적으로 의존하므로 존재가 보장되지 않습니다.

연산자 뒤에 물음표(`?`)를 붙이지 않는 한 값을 알 수 없는 포맷은 제외됩니다. 포맷 필터를 결합할 수 있으므로 `-f "[height <=? 720][tbr>500]"`은 최대 720p 비디오(또는 높이를 알 수 없는 비디오) 중 비트레이트가 500 KBit/s 이상인 것을 선택합니다.

`-f <video-format>+<audio-format>`을 사용하여 두 포맷의 비디오와 오디오를 단일 파일로 병합할 수 있습니다(ffmpeg 또는 avconv 설치 필요). 예를 들어 `-f bestvideo+bestaudio`는 가장 좋은 비디오 전용 포맷과 가장 좋은 오디오 전용 포맷을 다운로드한 후 ffmpeg/avconv로 함께  mux합니다.

포맷 선택자는 괄호를 사용하여 그룹화할 수도 있습니다. 예를 들어 높이가 480 미만인 최상의 mp4 및 webm 포맷을 다운로드하려면 `-f '(mp4,webm)[height<480]'`을 사용할 수 있습니다.

2015년 4월 말 버전 2015.04.26부터 youtube-dl은 기본 포맷 선택으로 `-f bestvideo+bestaudio/best`를 사용합니다([#5447](https://github.com/ytdl-org/youtube-dl/issues/5447), [#5456](https://github.com/ytdl-org/youtube-dl/issues/5456) 참조). ffmpeg 또는 avconv가 설치된 경우 이는 `bestvideo`와 `bestaudio`를 따로 다운로드하여 단일 파일로 mux하여 사용 가능한 최고의 전반적인 품질을 제공합니다. 그렇지 않은 경우 `best`로 대체되어 단일 파일로 제공되는 최고의 가용 품질을 다운로드합니다. `best`는 오디오와 비디오를 두 개의 다른 파일로 제공하지 않는 YouTube 외의 비디오에도 필요합니다. 일부 DASH 포맷만 다운로드하려는 경우(예: 1080p보다 높은 해상도의 비디오에 관심이 없는 경우) 설정 파일에 `-f bestvideo[height<=?1080]+bestaudio/best`를 추가할 수 있습니다. youtube-dl을 사용하여 `stdout`으로 스트리밍하는 경우(그리고 대개 미디어 플레이어로 파이핑하는 경우), 즉 출력 템플릿을 `-o -`로 명시적으로 지정한 경우, youtube-dl은 `bestvideo`와 `bestaudio`가 다운로드되고 mux될 때까지 기다리지 않고 플레이어로 콘텐츠 전달을 즉시 시작하기 위해 여전히 `-f best` 포맷 선택을 사용합니다.

이전 포맷 선택 동작(youtube-dl 2015.04.26 이전)을 유지하려면, 즉 단일 파일로 제공되는 최고의 가용 품질 미디어를 다운로드하려면 `-f best`로 선택 사항을 명시적으로 지정해야 합니다. youtube-dl을 실행할 때마다 입력하지 않도록 [설정 파일](#configuration)에 추가하는 것이 좋습니다.

#### 포맷 선택 예시

Windows에서는 작은따옴표 대신 큰따옴표를 사용해야 할 수 있습니다.

```bash
# 사용 가능한 가장 좋은 mp4 포맷 다운로드, mp4가 없는 경우 다른 최고 포맷 다운로드
$ youtube-dl -f 'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best'

# 사용 가능한 가장 좋은 포맷을 다운로드하되 480p를 초과하지 않음
$ youtube-dl -f 'bestvideo[height<=480]+bestaudio/best[height<=480]'

# 50 MB를 넘지 않는 최고 품질의 비디오 전용 포맷 다운로드
$ youtube-dl -f 'best[filesize<50M]'

# HTTP/HTTPS 프로토콜을 통한 직접 링크로 사용 가능한 가장 좋은 포맷 다운로드
$ youtube-dl -f '(bestvideo+bestaudio/best)[protocol^=http]'

# 병합하지 않고 최고 비디오 포맷과 최고 오디오 포맷 다운로드
$ youtube-dl -f 'bestvideo,bestaudio' -o '%(title)s.f%(format_id)s.%(ext)s'
```
마지막 예시에서 bestvideo와 bestaudio의 파일 이름이 같을 수 있으므로 출력 템플릿을 사용하는 것이 좋습니다.

# 비디오 선택

옵션 `--date`, `--datebefore`, `--dateafter`를 사용하여 업로드 날짜별로 비디오를 필터링할 수 있습니다. 두 가지 포맷의 날짜를 허용합니다:

- 절대 날짜: `YYYYMMDD` 포맷의 날짜.
 - 상대 날짜: `(now|today)[+-][0-9](day|week|month|year)(s)?` 포맷의 날짜.

예시:

```bash
# 지난 6개월 동안 업로드된 비디오만 다운로드
$ youtube-dl --dateafter now-6months

# 1970년 1월 1일에 업로드된 비디오만 다운로드
$ youtube-dl --date 19700101

$ # 2000년대에 업로드된 비디오만 다운로드
$ youtube-dl --dateafter 20000101 --datebefore 20091231
```

# FAQ

### youtube-dl을 어떻게 업데이트하나요?

[수동 설치 지침](https://ytdl-org.github.io/youtube-dl/download.html)을 따랐다면 단순히 `youtube-dl -U`(Linux의 경우 `sudo youtube-dl -U`)를 실행하면 됩니다.

pip를 사용한 경우 간단히 `sudo pip install -U youtube-dl`로 업데이트할 수 있습니다.

*apt-get*이나 *yum* 같은 패키지 매니저를 사용하여 youtube-dl을 설치했다면 표준 시스템 업데이트 메커니즘을 사용하여 업데이트하세요. 배포판 패키지는 종종 구버전인 경우가 많습니다. 경험상 youtube-dl은 한 달에 한 번 이상, 종종 매주 또는 매일 릴리스됩니다. 현재 버전을 확인하려면 단순히 https://yt-dl.org를 방문하세요. 안타깝게도 배포판에서 매우 오래된 버전을 제공하는 경우 저희 youtube-dl 개발자들이 할 수 있는 일은 없습니다. 해당 배포판의 버그 트래커나 지원 포럼에 불만을 제기할 수 있습니다(그리고 제기해야 합니다).

최후의 수단으로, 패키지 매니저로 설치한 버전을 제거하고 수동 설치 지침을 따를 수도 있습니다. 이를 위해 다음과 같은 명령으로 배포판 패키지를 제거하세요.

sudo apt-get remove -y youtube-dl

그 후 단순히 [수동 설치 지침](https://ytdl-org.github.io/youtube-dl/download.html)을 따르세요:

```
sudo wget https://yt-dl.org/downloads/latest/youtube-dl -O /usr/local/bin/youtube-dl
sudo chmod a+rx /usr/local/bin/youtube-dl
hash -r
```

마찬가지로 그 이후부터는 `sudo youtube-dl -U`로 업데이트할 수 있습니다.

### Windows에서 youtube-dl이 시작되는 데 매우 오랜 시간이 걸립니다.

Windows Defender 설정에서 `youtube-dl.exe`에 대한 파일 예외를 추가하세요.

### YouTube 재생 목록에서 `Unable to extract OpenGraph title` 오류가 발생합니다.

YouTube가 2014년 3월 이후 재생 목록 포맷을 변경했으므로, 모든 YouTube 비디오를 다운로드하려면 최소한 youtube-dl 2014.07.25 버전이 필요합니다.

패키지 매니저, pip, setup.py 또는 tarball로 youtube-dl을 설치했다면 그것을 사용하여 업데이트하세요. Ubuntu 패키지는 더 이상 업데이트되지 않는 것으로 보입니다. 저희는 Ubuntu와 제휴하지 않았으므로 저희가 할 수 있는 일이 거의 없습니다. [Ubuntu 패키징 담당자](mailto:ubuntu-motu@lists.ubuntu.com?subject=outdated%20version%20of%20youtube-dl)에게 [버그를 신고](https://bugs.launchpad.net/ubuntu/+source/youtube-dl/+filebug)해 주세요. 그들이 해야 할 일은 패키지를 최신 버전으로 업데이트하는 것뿐입니다. 업데이트하는 방법은 위를 참조하세요.

### 출력 템플릿을 사용하려고 할 때 `error: using output template conflicts with using title, video ID or auto number` 오류가 발생합니다.

명령줄이나 설정 파일에 `-t`, `--title`, `--id`, `-A` 또는 `--auto-number` 옵션이 설정된 상태로 `-o`를 사용하고 있지 않은지 확인하세요. 설정되어 있다면 후자를 제거하세요.

### 항상 `-citw`를 전달해야 하나요?

기본적으로 youtube-dl은 가장 좋은 옵션을 가지도록 의도되었습니다(우연히도 이것들이 달라야 한다는 설득력 있는 근거가 있다면 [설명하는 이슈를 제기해 주세요](https://yt-dl.org/bug)). 따라서 웹페이지에서 긴 옵션 문자열을 복사하는 것은 불필요하며 때로는 해로울 수 있습니다. 특히 `-citw` 중 정기적으로 유용한 유일한 옵션은 `-i`입니다.

### `-b` 옵션을 다시 돌려주실 수 있나요?

이 질문을 하는 대부분의사람들은 youtube-dl이 이제 YouTube에서 보고한 최고 가용 품질을 기본적으로 다운로드한다는 사실을 모르고 있습니다. 어떤 경우에는 1080p 또는 720p가 되므로 더 이상 `-b` 옵션이 필요하지 않습니다. 특정 비디오의 경우 YouTube에서 관심 있는 특정 고품질 포맷으로 제공된다고 보고하지 않을 수 있습니다. 이 경우 `-f` 옵션으로 간단히 요청하면 youtube-dl이 다운로드를 시도합니다.

### 비디오를 다운로드하려고 할 때 HTTP 오류 402가 발생합니다. 이게 무엇인가요?

분명히 YouTube는 너무 많이 다운로드하면 CAPTCHA 테스트를 통과할 것을 요구합니다. 저희는 [CAPTCHA를 풀 수 있는 방법을 제공하는 것을 고려하고 있지만](https://github.com/ytdl-org/youtube-dl/issues/154), 현재로서는 가장 좋은 대책은 웹 브라우저로 유튜브 URL에 접속하여 CAPTCHA를 풀고 youtube-dl을 다시 시작하는 것입니다.

### 다른 프로그램이 필요한가요?

youtube-dl은 대부분의 사이트에서 그 자체로 잘 작동합니다. 하지만 비디오/오디오를 변환하려면 [avconv](https://libav.org/) 또는 [ffmpeg](https://www.ffmpeg.org/)가 필요합니다. 일부 사이트(가장 대표적으로 YouTube)에서는 소리 없이 더 높은 품질의 포맷으로 비디오를 가져올 수 있습니다. youtube-dl은 avconv/ffmpeg의 존재 여부를 감지하고 자동으로 가장 좋은 옵션을 선택합니다.

RTMP 프로토콜을 통해 스트리밍되는 비디오 또는 비디오 포맷은 [rtmpdump](https://rtmpdump.mplayerhq.hu/)가 설치되어 있는 경우에만 다운로드할 수 있습니다. MMS 및 RTSP 비디오를 다운로드하려면 [mplayer](https://mplayerhq.hu/) 또는 [mpv](https://mpv.io/) 중 하나가 설치되어 있어야 합니다.

### 비디오를 다운로드했는데 어떻게 재생하나요?

비디오가 완전히 다운로드되면 [mpv](https://mpv.io/), [vlc](https://www.videolan.org/) 또는 [mplayer](https://www.mplayerhq.hu/) 같은 미디어 플레이어를 사용하세요.

### `-g`로 비디오 URL을 추출했는데 다른 머신 / 웹 브라우저에서 재생되지 않습니다.

서비스에 따라 크게 다릅니다. 많은 경우, 비디오 요청(다운로드/재생용)은 동일한 IP 주소에서 동일한 쿠키 및/또는 HTTP 헤더와 함께 와야 합니다. `--cookies` 옵션을 사용하여 필요한 쿠키를 파일에 기록하고, 다운로더가 해당 파일에서 쿠키를 읽도록 안내하세요. 일부 사이트에서는 공통된 user agent를 사용할 것을 요구하기도 합니다. youtube-dl에서 사용 중인 것을 보려면 `--dump-user-agent`를 사용하세요. `--dump-json`으로 얻은 JSON 출력에서 필요한 쿠키와 HTTP 헤더를 얻을 수도 있습니다.

IPv6를 사용하는 것이 유리할 수 있습니다. 어떤 경우에는 제한이 IPv4에만 적용되기 때문입니다. 일부 서비스(때로는 비디오의 일부 하위 집합에 대해서만)는 IP 주소, 쿠키 또는 user-agent로 비디오 URL을 제한하지 않지만, 이것들은 예외에 해당합니다.

RTMP를 포함하여 일부 URL 프로토콜은 브라우저에서 기본적으로 지원되지 **않음**을 명심하세요. `-g`를 사용하는 경우 사용자 자신의 다운로더도 이를 지원해야 합니다.

youtube-dl을 실행하지 않는 머신에서 비디오를 재생하려면 youtube-dl을 실행하는 머신에서 비디오 콘텐츠를 릴레이할 수 있습니다. `-o -`를 사용하여 youtube-dl이 stdout으로 비디오를 스트리밍하도록 하거나, 플레이어가 youtube-dl이 기록한 파일을 차례대로 다운로드하도록 허용할 수 있습니다.

### ERROR: no fmt_url_map or conn information found in video info

YouTube는 2011년 7월에 이전 버전의 youtube-dl에서 지원하지 않는 새로운 비디오 정보 포맷으로 전환했습니다. youtube-dl을 업데이트하는 방법은 [위](#how-do-i-update-youtube-dl)를 참조하세요.

### ERROR: unable to download video

YouTube는 2012년 9월 이후 이전 버전의 youtube-dl에서 지원하지 않는 추가 서명을 요구합니다. youtube-dl을 업데이트하는 방법은 [위](#how-do-i-update-youtube-dl)를 참조하세요.

### 비디오 URL에 앰퍼샌드(&)가 포함되어 있고 `[1] 2839` 또는 `'v'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.` 같은 이상한 출력이 표시됩니다.

실제로 셸의 출력입니다. 앰퍼샌드는 특수 셸 문자 중 하나이므로 셸에 의해 해석되어 전체 URL이 youtube-dl에 전달되는 것을 방해합니다. 셸이 앰퍼샌드(또는 기타 특수 문자)를 해석하지 못하게 하려면 전체 URL을 따옴표로 감싸거나 백슬래시로 이스케이프해야 합니다(어떤 방식이 작동할지는 셸에 따라 다릅니다).

예를 들어 URL이 https://www.youtube.com/watch?t=4&v=BaW_jenozKc인 경우 다음 명령으로 끝나야 합니다:

```youtube-dl 'https://www.youtube.com/watch?t=4&v=BaW_jenozKc'```

또는

```youtube-dl https://www.youtube.com/watch?t=4\&v=BaW_jenozKc```

Windows의 경우 큰따옴표를 사용해야 합니다:

```youtube-dl "https://www.youtube.com/watch?t=4&v=BaW_jenozKc"```

### ExtractorError: Could not find JS function u'OF'

2015년 2월, 새로운 YouTube 플레이어에는 이전 버전의 youtube-dl에 의해 잘못 해석된 문자열 내 문자 시퀀스가 포함되어 있었습니다. youtube-dl을 업데이트하는 방법은 [위](#how-do-i-update-youtube-dl)를 참조하세요.

### HTTP Error 429: Too Many Requests 또는 402: Payment Required

이 두 오류 코드는 과도한 사용으로 인해 서비스가 사용자의 IP 주소를 차단하고 있음을 나타냅니다. 일반적으로 이것은 소프트 블록으로, CAPTCHA를 해결한 후 다시 액세스 권한을 얻을 수 있음을 의미합니다. 브라우저를 열고 서비스에서 제안하는 CAPTCHA를 해결한 후 youtube-dl에 [쿠키를 전달](#how-do-i-pass-cookies-to-youtube-dl)하세요. 머신에 여러 개의 외부 IP가 있는 경우 [`--source-address`](#network-options)를 사용하여 CAPTCHA를 해결하는 데 사용한 것과 정확히 동일한 IP를 전달해야 합니다. 또한 [`--user-agent`](#workarounds)를 사용하여 브라우저의 `User-Agent` HTTP 헤더를 전달해야 할 수도 있습니다.

그렇지 않은 경우(서비스에서 해결할 CAPTCHA를 제안하지 않음) 서비스에 연락하여 IP 주소 차단 해제를 요청하거나, 이미 화이트리스트에 등록된 IP 주소를 획득한 경우 [`--proxy` 또는 `--source-address` 옵션](#network-options)을 사용하여 다른 IP 주소를 선택할 수 있습니다.

### SyntaxError: Non-ASCII character

오류

File "youtube-dl", line 2
    SyntaxError: Non-ASCII character '\x93' ...

는 구버전 Python을 사용하고 있음을 의미합니다. Python 2.6 또는 2.7로 업데이트해 주세요.

### 이 바이너리 파일은 무엇인가요? 코드는 어디로 갔나요?

2012년 6월([#342](https://github.com/ytdl-org/youtube-dl/issues/342))부터 youtube-dl은 실행 가능한 zip 파일로 패키징되어 있습니다. 단순히 압축을 풀거나(일부 시스템에서는 먼저 이름을 `youtube-dl.zip`으로 변경해야 할 수 있음), 위에 설명된 대로 git 저장소를 복제하세요. 코드를 수정한 경우 `__main__.py` 파일을 실행하여 실행할 수 있습니다. 실행 파일을 재컴파일하려면 `make youtube-dl`을 실행하세요.

### exe가 누락된 `MSVCR100.dll`로 인해 오류를 발생시킵니다.

exe를 실행하려면 먼저 [Microsoft Visual C++ 2010 Service Pack 1 재배포 가능 패키지(x86)](https://download.microsoft.com/download/1/6/5/165255E7-1014-4D0A-B094-B6A430A6BFFC/vcredist_x86.exe)를 설치해야 합니다.

### Windows에서 ffmpeg와 youtube-dl을 어떻게 설정해야 하나요? exe 파일은 어디에 넣어야 하나요?

youtube-dl과 ffmpeg를 명령을 실행하는 동일한 디렉토리에 넣으면 작동하지만, 이는 다소 번거롭습니다.

ffmpeg, youtube-dl 또는 둘 다를 위해 다른 디렉토리가 작동하도록 하려면, 단순히 디렉토리를 만들고(예: `C:\bin` 또는 `C:\Users\<User name>\bin`), 모든 실행 파일을 그곳에 직접 넣은 다음, 해당 디렉토리를 포함하도록 [PATH 환경 변수를 설정](https://www.java.com/en/download/help/path.xml)하세요.

그 시점부터 셸을 다시 시작한 후에는 어떤 디렉토리에 있든 단순히 `youtube-dl` 또는 `ffmpeg`를 입력하여 둘 다에 액세스할 수 있습니다(그리고 youtube-dl이 ffmpeg를 찾을 수 있게 됩니다).

### 다운로드를 특정 폴더에 넣으려면 어떻게 해야 하나요?

`-o`를 사용하여 [출력 템플릿](#output-template)을 지정하세요. 예를 들어 `-o "/home/user/videos/%(title)s-%(id)s.%(ext)s"`를 사용합니다. 모든 다운로드에 대해 이렇게 하려면 [설정 파일](#configuration)에 옵션을 넣으세요.

### `-`로 시작하는 비디오를 다운로드하려면 어떻게 해야 하나요?

`https://www.youtube.com/watch?v=`를 앞에 붙이거나 `--`로 옵션과 ID를 구분하세요:

youtube-dl -- -wNyEUrxzFU
    youtube-dl "https://www.youtube.com/watch?v=-wNyEUrxzFU"

### youtube-dl에 쿠키를 어떻게 전달하나요?

`--cookies` 옵션을 사용하세요. 예를 들어 `--cookies /path/to/cookies/file.txt`를 사용합니다.

브라우저에서 쿠키를 추출하려면 쿠키 내보내기를 지원하는 호환 브라우저 확장 프로그램을 사용하세요. 예를 들어 [Get cookies.txt LOCALLY](https://chrome.google.com/webstore/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)(Chrome용) 또는 [cookies.txt](https://addons.mozilla.org/en-US/firefox/addon/cookies-txt/)(Firefox용)를 사용합니다.

쿠키 파일은 반드시 Mozilla/Netscape 포맷이어야 하며, 쿠키 파일의 첫 번째 줄은 `# HTTP Cookie File` 또는 `# Netscape HTTP Cookie File`이어야 합니다. 쿠키 파일에 올바른 [줄바꿈 포맷](https://en.wikipedia.org/wiki/Newline)이 있는지 확인하고, 필요에 따라 운영체제에 맞게 줄바꿈을 변환하세요. Windows의 경우 `CRLF`(`\r\n`), Unix 및 Unix 계열 시스템(Linux, macOS 등)의 경우 `LF`(`\n`)입니다. `--cookies`를 사용할 때 발생하는 `HTTP Error 400: Bad Request`는 잘못된 줄바꿈 포맷의 좋은 신호입니다.

youtube-dl에 쿠키를 전달하는 것은 특정 추출기가 로그인을 명시적으로 구현하지 않은 경우 로그인을 우회하는 좋은 방법입니다. 또 다른 유용한 사례는 액세스 권한을 얻기 위해 특정 경우에 일부 웹사이트(예: YouTube, CloudFlare)가 해결하도록 요구하는 [CAPTCHA](https://en.wikipedia.org/wiki/CAPTCHA)를 우회하는 것입니다.

### 미디어 플레이어로 직접 스트리밍하려면 어떻게 해야 하나요?

먼저 `-o -`로 youtube-dl이 미디어를 stdout으로 스트리밍하도록 지시해야 하며, 미디어 플레이어에게도 stdin에서 읽도록 지시한 후(스트리밍을 위해 이 기능이 가능해야 함) 전자를 후자로 파이핑해야 합니다. 예를 들어 [vlc](https://www.videolan.org/)로 스트리밍하는 것은 다음으로 달성할 수 있습니다:

youtube-dl -o - "https://www.youtube.com/watch?v=BaW_jenozKcj" | vlc -

### 재생 목록에서 새 비디오만 다운로드하려면 어떻게 해야 하나요?

download-archive 기능을 사용하세요. 이 기능을 사용하면 처음에 `--download-archive /path/to/download/archive/file.txt`로 전체 재생 목록을 다운로드해야 하며, 이는 특수 파일에 모든 비디오의 식별자를 기록합니다. 동일한 `--download-archive`로 후속 실행할 때마다 새 비디오만 다운로드하고 이전에 다운로드한 모든 비디오는 건너뜁니다. 성공적으로 다운로드된 항목만 파일에 기록됩니다.

예를 들어 처음에,

youtube-dl --download-archive archive.txt "https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re"

는 전체 `PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re` 재생 목록을 다운로드하고 `archive.txt` 파일을 생성합니다. 이후에 실행할 때마다 있는 경우 새 비디오만 다운로드합니다:

youtube-dl --download-archive archive.txt "https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re"

### 설정에 `--hls-prefer-native`를 추가해야 하나요?

youtube-dl이 HLS 비디오를 감지하면 내장 다운로더 또는 ffmpeg를 사용하여 다운로드할 수 있습니다. 많은 HLS 스트림이 약간 잘못되었고 ffmpeg/youtube-dl 각각 일부 잘못된 경우를 다른 쪽보다 더 잘 처리하기 때문에 필요에 따라 다운로더를 전환하는 옵션이 있습니다.

youtube-dl이 특정 다운로더가 주어진 웹사이트에서 더 잘 작동한다는 것을 아는 경우, 해당 다운로더가 선택됩니다. 그렇지 않은 경우 youtube-dl은 일반적인 호환성을 위해 가장 좋은 다운로더를 선택하며, 현재는 ffmpeg가 됩니다. 이 선택은 내장 다운로더 및/또는 ffmpeg의 개선에 따라 youtube-dl의 향후 버전에서 변경될 수 있습니다.

특히 일반(generic) 추출기(웹사이트가 [youtube-dl 지원 사이트 목록](https://ytdl-org.github.io/youtube-dl/supportedsites.html)에 없는 경우 사용됨)는 하나의 특정 다운로더를 강제할 수 없습니다.

설정에 `--hls-prefer-native` 또는 `--hls-prefer-ffmpeg` 중 하나를 넣으면 다른 하위 집합의 비디오가 올바르게 다운로드되지 않습니다. 대신, 네이티브 또는 ffmpeg HLS 다운로더가 사용 사례에 더 나은 선택인 이유를 자세히 설명하는 [이슈를 제기](https://yt-dl.org/bug)하거나 풀 리퀘스트를 제출하는 것이 훨씬 좋습니다.

### 이 애니메이션 비디오 사이트 또는 최신 영화를 무료로 보여주는 사이트에 대한 지원을 추가해 주실 수 있나요?

정책상(그리고 법적 측면에서도) youtube-dl은 저작권 침해를 전문으로 하는 서비스에 대한 지원을 포함하지 않습니다. 경험상, 서비스가 유통하는 것이 명백히 허용된 비디오(즉, 제작자, 제작자의 배포자에 의해 업로드되었거나 무료 라이선스로 게시된 비디오)를 쉽게 찾을 수 없는 경우, 해당 서비스는 youtube-dl에 포함하기에 부적합할 가능성이 높습니다.

해당 서비스가 침해 콘텐츠를 호스팅하지 않고 단지 링크만 제공한다는 언급은 해당 서비스가 youtube-dl에 포함되어서는 **안 된다**는 증거입니다. 서비스의 첫 페이지 전체가 배포가 허용되지 않는 비디오로 가득 차 있는 경우 모든 DMCA 공지에 대해서도 마찬가지입니다. 서비스가 저작권 보호 비디오를 허가 없이 전체적으로 보여주는 경우 "공정한 이용(fair use)" 언급도 마찬가지로 설득력이 없습니다.

콘텐츠 유통 권한을 실제로 구매하는 서비스에 대한 지원 요청은 완벽하게 괜찮습니다. 확실하지 않은 경우 콘텐츠의 합법적인 구매를 언급하는 출처를 간단히 포함할 수 있습니다.

### 내 이슈에 대한 작업을 어떻게 가속화할 수 있나요?

(다음으로도 알려짐: 도와주세요, 중요한 이슈가 해결되지 않고 있어요!) youtube-dl 핵심 개발자 팀은 매우 작습니다. 가능한 많은 이슈를 해결하기 위해 최선을 다하고 있지만 때로는 꽤 오랜 시간이 걸릴 수 있습니다. 이슈를 가속화하기 위해 할 수 있는 일은 다음과 같습니다:

무엇보다도 [저희 이슈 트래커에 이슈를 신고](https://yt-dl.org/bugs)해 주세요. 이를 통해 사용자와 개발자의 모든 노력을 조율할 수 있으며 통합된 지점 역할을 합니다. 안타깝게도 youtube-dl 프로젝트가 너무 커져서 개인 이메일을 효과적인 커뮤니케이션 채널로 사용할 수 없게 되었습니다.

아래의 [버그 신고 지침](#bugs)을 읽어주세요. 많은 버그에 필요한 모든 정보가 부족합니다. 가능하다면 youtube-dl 개발자에게 프록시, VPN 또는 셸 액세스 권한을 제공하세요. 가능하다면 지역 검열이나 잘못된 설정 문제를 배제하기 위해 여러 국가의 여러 컴퓨터에서 이슈를 테스트해 보세요.

아무도 이슈를 해결하는 데 관심이 없다면 직접 나서서 풀 리퀘스트를 제출(또는 다른 사람에게 그렇게 하도록 강요/비용 지불)해도 환영합니다.

작은 댓글을 작성하여 때때로 이슈를 갱신해도 좋습니다("프랑스에서는 youtube-dl 버전 ...에서 이슈가 여전히 발생하지만 벨기에에서는 수정되었습니다"), 단 한 달에 한 번을 넘지 않도록 해주세요. 이슈를 `important` 또는 `urgent`로 선언하지 마세요.

### 주어진 URL이 youtube-dl에서 지원되는지 어떻게 감지할 수 있나요?

우선 [지원되는 사이트 목록](docs/supportedsites.md)을 살펴보세요. 사이트가 URL 체계를 변경하고(예: https://example.com/video/1234567에서 https://example.com/v/1234567로) youtube-dl이 해당 목록에 있는 서비스의 URL을 지원되지 않는 것으로 보고하는 경우가 간혹 발생할 수 있습니다. 이 경우 단순히 버그를 신고하세요.

URL이 지원되는지 여부를 감지하는 것은 *불가능*합니다. youtube-dl에는 **모든** URL과 일치하는 일반(generic) 추출기가 포함되어 있기 때문입니다. 일반 추출기를 비활성화, 제외 또는 제거하고 싶을 수 있지만, 일반 추출기는 사용자가 다른 서비스의 비디오를 임베드하는 많은 웹사이트에서 비디오를 추출할 수 있게 할 뿐만 아니라 자체 호스팅하는 서비스에서 비디오를 추출하는 데에도 사용될 수 있습니다. 따라서 당사는 일반 추출기의 비활성화, 제외 또는 제거를 권장하지도 지원하지도 않습니다.

주어진 URL이 지원되는지 알아보려면 단순히 youtube-dl을 해당 URL과 함께 호출하세요. 비디오가 반환되지 않으면 URL이 비디오를 가리키지 않거나 지원되지 않을 가능성이 높습니다. 출력(콘솔에서 youtube-dl을 실행하는 경우)을 검사하거나 Python 프로그램에서 실행하는 경우 `UnsupportedError` 예외를 잡아서 확인할 수 있습니다.

# 버그를 신고할 때 왜 그렇게 많은 번거로운 절차를 거쳐야 하나요?

이슈 템플릿이 있기 전에는 당사의 광범위한 [버그 신고 지침](#bugs)에도 불구하고, 접수된 이슈 신고의 약 80%가 쓸모없었습니다. 예를 들어 사용자들이 수백 개의 릴리스가 지난 고대 버전을 사용했기 때문에, 단순한 구문 오류(youtube-dl에서의 오류가 아니라 일반적인 셸 사용법) 때문에, 문제가 이미 여러 번 신고되었기 때문에, 사용자들이 "ffmpeg를 설치해주세요"라는 오류 메시지가 있음에도 불구하고 실제로 읽지 않았기 때문에, 다운로드하려는 URL을 언급하지 않았기 때문에, 그리고 youtube-dl과 전혀 관련 없는 수많은 간단하고 피하기 쉬운 문제들 때문이었습니다.

youtube-dl은 너무 적은 자원봉사자가 운영하는 오픈 소스 프로젝트이므로, 그러한 간단한 문제 중 어느 것도 적용되지 않으며 신고자에게 거듭해서 요청하지 않고도 재현할 수 있다고 합리적으로 확신할 수 있는 버그를 수정하는 데 시간을 쓰고 싶습니다. 따라서 `youtube-dl -v YOUR_URL_HERE`의 출력은 이슈를 신고하는 데 필요한 전부입니다. 또한 이슈 템플릿은 youtube-dl 버전이 최신인지 확인하는 것과 같이 수행할 수 있는 몇 가지 기본 단계를 안내합니다.

# 개발자 지침

대부분의 사용자는 youtube-dl을 빌드할 필요가 없으며 [빌드를 다운로드](https://ytdl-org.github.io/youtube-dl/download.html)하거나 배포판에서 가져올 수 있습니다.

개발자로서 youtube-dl을 실행하기 위해 어떤 것도 빌드할 필요가 없습니다. 단순히 다음을 실행하세요:

python -m youtube_dl

테스트를 실행하려면 좋아하는 테스트 러너를 호출하거나 테스트 파일을 직접 실행하세요. 다음 중 하나가 작동합니다:

python -m unittest discover
    python test/test_download.py
    nosetests

Python 3.6 이상 버전의 경우 [pynose](https://pypi.org/project/pynose/)를 사용하여 `nosetests`를 구현할 수 있습니다. 원본 [nose](https://pypi.org/project/nose/)는 3.10 이상 버전용으로 업그레이드되지 않았습니다.

추출기별 테스트 케이스를 실행하는 방법은 [새 추출기 튜토리얼](#adding-support-for-a-new-site)의 6번 항목을 참조하세요.

youtube-dl 빌드를 직접 생성하려면 다음이 필요합니다:

* python
* make (GNU make만 지원됨)
* pandoc
* zip
* nosetests

### 새 사이트 지원 추가

새 사이트에 대한 지원을 추가하려면 먼저 이 사이트가 **[저작권 침해(README.md#can-you-add-support-for-this-anime-video-site-or-site-which-shows-current-movies-for-free)](README.md#can-you-add-support-for-this-anime-video-site-or-site-which-shows-current-movies-for-free)에 전용되지 않았는지 확인**하세요. youtube-dl은 이러한 사이트를 **지원하지 않으며** 따라서 이에 대한 지원을 추가하는 풀 리퀘스트는 **거부됩니다**.

이 사이트가 콘텐츠를 합법적으로 배포하고 있음을 확인한 후, 다음 간단한 목록을 따를 수 있습니다(서비스 이름이 `yourextractor`라고 가정):

1. [이 저장소 포크하기](https://github.com/ytdl-org/youtube-dl/fork)
2. 다음 명령으로 소스 코드 체크아웃:

git clone git@github.com:YOUR_GITHUB_USERNAME/youtube-dl.git

3. 다음 명령으로 새 git 분기(branch) 시작

cd youtube-dl
        git checkout -b yourextractor

4. 이 간단한 템플릿으로 시작하여 `youtube_dl/extractor/yourextractor.py`에 저장:

```python
    # coding: utf-8
    from __future__ import unicode_literals

from .common import InfoExtractor

class YourExtractorIE(InfoExtractor):
        _VALID_URL = r'https?://(?:www\.)?yourextractor\.com/watch/(?P<id>[0-9]+)'
        _TEST = {
            'url': 'https://yourextractor.com/watch/42',
            'md5': 'TODO: md5 sum of the first 10241 bytes of the video file (use --test)',
            'info_dict': {
                'id': '42',
                'ext': 'mp4',
                'title': 'Video title goes here',
                'thumbnail': r're:^https?://.*\.jpg$',
                # TODO more properties, either as:
                # * A value
                # * MD5 checksum; start the string with md5:
                # * A regular expression; start the string with re:
                # * Any Python type (for example int or float)
            }
        }

def _real_extract(self, url):
            video_id = self._match_id(url)
            webpage = self._download_webpage(url, video_id)

# TODO more code goes here, for example ...
            title = self._html_search_regex(r'<h1>(.+?)</h1>', webpage, 'title')

return {
                'id': video_id,
                'title': title,
                'description': self._og_search_description(webpage),
                'uploader': self._search_regex(r'<div[^>]+id="uploader"[^>]*>([^<]+)<', webpage, 'uploader', fatal=False),
                # TODO more properties (see youtube_dl/extractor/common.py)
            }
    ```
5. [`youtube_dl/extractor/extractors.py`](https://github.com/ytdl-org/youtube-dl/blob/master/youtube_dl/extractor/extractors.py)에 import 추가.
6. `python test/test_download.py TestDownload.test_YourExtractor` 실행. 처음에는 *실패해야 하지만*, 완료될 때까지 계속해서 다시 실행할 수 있습니다. 둘 이상의 테스트(실제로는 테스트 케이스)를 추가하기로 결정한 경우 ``_TEST``를 ``_TESTS``로 이름을 바꾸고 딕셔너리 목록으로 만드세요. 그러면 테스트 이름은 `TestDownload.test_YourExtractor`, `TestDownload.test_YourExtractor_1`, `TestDownload.test_YourExtractor_2` 등이 됩니다. 참고:
    * 테스트 이름은 **끝에 붙는 `IE`를 제외한** 추출기 클래스 이름을 사용합니다.
    * 테스트 딕셔너리에 `only_matching` 키가 있는 테스트는 카운트되지 않습니다.
8. 가능한 도우미 메서드와 [추출기가 반환해야 하고 반환할 수 있는 것에 대한 자세한 설명](https://github.com/ytdl-org/youtube-dl/blob/7f41a598b3fba1bcab2817de64a08941200aa3c8/youtube_dl/extractor/common.py#L94-L303)은 [`youtube_dl/extractor/common.py`](https://github.com/ytdl-org/youtube-dl/blob/master/youtube_dl/extractor/common.py)를 참조하세요. 원하는 만큼 테스트와 코드를 추가하세요.
9. 코드가 [youtube-dl 코딩 규칙](#youtube-dl-coding-conventions)을 따르는지 확인하고 [flake8](https://flake8.pycqa.org/en/latest/index.html#quickstart)으로 코드를 검사하세요:

$ flake8 youtube_dl/extractor/yourextractor.py

9. 코드가 youtube-dl이 지원한다고 주장하는 모든 [Python](https://www.python.org/) 버전(즉, 2.6, 2.7 및 3.2+)에서 작동하는지 확인하세요.
10. 테스트가 통과되면 새 파일을 [추가](https://git-scm.com/docs/git-add)하고 [커밋](https://git-scm.com/docs/git-commit)한 후 다음과 같이 [푸시](https://git-scm.com/docs/git-push)하세요:

$ git add youtube_dl/extractor/extractors.py
        $ git add youtube_dl/extractor/yourextractor.py
        $ git commit -m '[yourextractor] Add new extractor'
        $ git push origin yourextractor

11. 마지막으로 [풀 리퀘스트를 생성](https://help.github.com/articles/creating-a-pull-request)하세요. 저희가 검토하고 병합하겠습니다.

어쨌든 기여해 주셔서 대단히 감사합니다!

## youtube-dl 코딩 규칙

이 섹션에서는 관용적이고 견고하며 미래에 대비할 수 있는 추출기 코드를 작성하기 위한 지침을 소개합니다.

추출기는 통제할 수 없는 제3자 미디어 호스팅 업체가 제공하는 소스 데이터의 레이아웃에 의존하기 때문에 본질적으로 매우 취약하며 이 레이아웃은 변경되는 경향이 있습니다. 추출기 구현자로서 여러분의 임무는 미디어 링크와 메타데이터를 올바르게 추출하는 코드를 작성하는 것뿐만 아니라 소스 레이아웃에 대한 종속성을 최소화하고 코드가 잠재적인 미래의 변경 사항을 예측하고 이에 대비하도록 하는 것입니다. 이는 추출기가 사소한 레이아웃 변경으로 인해 깨지지 않도록 하여 이전 youtube-dl 버전이 계속 작동하도록 유지하므로 중요합니다. 이 깨짐 문제는 수정 사항이 포함된 새 버전의 youtube-dl을 배포하여 쉽게 해결할 수 있지만, 당사로부터 업데이트를 가져오는 것이 빠르지 않을 수 있는 모든 이전 버전은 모든 리포지토리 및 배포판 패키지에서 깨진 상태로 남게 됩니다. 말할 것도 없이, 롤링 릴리스가 아닌 일부 배포판은 업데이트를 전혀 받지 못할 수도 있습니다.

### 필수 및 선택적 메타 필드

추출이 작동하기 위해 youtube-dl은 추출기가 추출하여 [정보 딕셔너리(information dictionary)](https://github.com/ytdl-org/youtube-dl/blob/7f41a598b3fba1bcab2817de64a08941200aa3c8/youtube_dl/extractor/common.py#L94-L303)(또는 간단히 *info dict*)로 표현하여 youtube-dl에 제공하는 메타데이터에 의존합니다. youtube-dl의 성공적인 추출 프로세스를 위해 *info dict*에서 다음 메타 필드만 필수로 간주됩니다:

- `id` (미디어 식별자)
 - `title` (미디어 제목)
 - `url` (미디어 다운로드 URL) 또는 `formats`

실제로 기술적으로 필수는 마지막 옵션뿐입니다(즉, 미디어의 다운로드 위치를 알아낼 수 없는 경우 추출은 아무런 의미가 없습니다). 하지만 관례에 따라 youtube-dl은 `id`와 `title`도 필수로 취급합니다. 따라서 앞서 언급한 메타 필드는 추출에 없어서는 안 될 핵심 데이터이며, 이들 중 어느 하나라도 추출에 실패하면 추출기는 완전히 손상된 것으로 간주됩니다.

앞서 언급한 필드를 제외한 [모든 필드](https://github.com/ytdl-org/youtube-dl/blob/7f41a598b3fba1bcab2817de64a08941200aa3c8/youtube_dl/extractor/common.py#L188-L303)는 **선택적(optional)**으로 간주됩니다. 이는 이러한 필드의 소스가 잠재적으로 사용할 수 없는 상황(현재는 항상 사용할 수 있더라도)에 대해 추출기가 **관대(tolerant)**해야 하며, 범용 필수 필드의 추출이 깨지지 않도록 **미래에 대비(future-proof)**해야 함을 의미합니다.

#### 예시

HTTP 요청을 통해 JSON으로 가져온 일부 소스 딕셔너리 `meta`가 있고 `summary` 키가 있다고 가정해 보겠습니다:

```python
meta = self._download_json(url, video_id)
```

이 시점에서 `meta`의 레이아웃이 다음과 같다고 가정합니다:

```python
{
    ...
    "summary": "some fancy summary text",
    ...
}
```

`summary`를 추출하여 결과 info dict에 `description`으로 넣고 싶다고 가정해 보겠습니다. `description`은 선택적 메타 필드이므로 이 키가 `meta` 딕셔너리에 없을 수 있음을 염두에 두어야 합니다. 따라서 다음과 같이 추출해야 합니다:

```python
description = meta.get('summary')  # 올바름
```

다음과 같이 하면 안 됩니다:

```python
description = meta['summary']  # 올바르지 않음
```

후자는 나중에 `meta`에서 `summary`가 사라질 경우 `KeyError`와 함께 추출 프로세스를 중단시키지만, 전자의 접근 방식을 사용하면 `description`이 `None`으로 설정된 채로 추출이 계속 진행됩니다. 이는 완전히 괜찮습니다(`None`은 데이터의 부재와 동일하다는 것을 기억하세요).

마찬가지로 `_search_regex`, `_html_search_regex` 또는 유사한 메서드를 사용하여 웹페이지에서 선택적 데이터를 추출할 때는 `fatal=False`를 전달해야 합니다. 예를 들면 다음과 같습니다:

```python
description = self._search_regex(
    r'<span[^>]+id="title"[^>]*>([^<]+)<',
    webpage, 'description', fatal=False)
```

`fatal`이 `False`로 설정되면 `_search_regex`가 `description` 추출에 실패할 경우 경고를 출력하고 추출을 계속합니다.

`default=<일부 폴백 값>`을 전달할 수도 있습니다. 예를 들면 다음과 같습니다:

```python
description = self._search_regex(
    r'<span[^>]+id="title"[^>]*>([^<]+)<',
    webpage, 'description', default=None)
```

실패 시 이 코드는 `description`을 `None`으로 설정한 채 조용히 추출을 계속합니다. 이는 존재할 수도 있고 그렇지 않을 수도 있는 메타 필드에 유용합니다.

### 폴백 제공

메타데이터를 추출할 때 여러 소스에서 추출하도록 시도하세요. 예를 들어 `title`이 여러 곳에 존재하는 경우, 그중 일부에서라도 추출을 시도하세요. 이렇게 하면 일부 소스를 사용할 수 없게 되는 경우에 대비하여 더욱 미래에 대비할 수 있습니다.

#### 예시

이전 예시의 `meta`에 `title`이 있고 이를 추출하려고 한다고 가정해 보겠습니다. `title`은 필수 메타 필드이므로 다음과 같은 코드로 끝날 것입니다:

```python
title = meta['title']
```

호스팅 업체 측의 일부 변경으로 인해 향후 `title`이 `meta`에서 사라지면 `title`이 필수이므로 추출이 실패합니다. 이는 예상된 결과입니다.

`title`을 추출할 수 있는 다른 소스(예: `webpage`의 `og:title` HTML 메타)가 있다고 가정해 보겠습니다. 이 경우 폴백 시나리오를 제공할 수 있습니다:

```python
title = meta.get('title') or self._og_search_title(webpage)
```

이 코드는 먼저 `meta`에서 추출을 시도하고 실패하면 `webpage`에서 `og:title` 추출을 시도합니다.

### 정규 표현식

#### 사용하지 않는 그룹을 캡처하지 마세요

캡처 그룹은 코드 어디선가 사용된다는 표시여야 합니다. 사용되지 않는 모든 그룹은 비캡처(non capturing)여야 합니다.

##### 예시

어차피 아무데에도 사용할 수 없으므로 여기서는 id 속성 이름을 캡처하지 마세요.

올바름:

```python
r'(?:id|ID)=(?P<id>\d+)'
```

올바르지 않음:
```python
r'(id|ID)=(?P<id>\d+)'
```

#### 정규 표현식을 느슨하고 유연하게 만드세요

정규 표현식을 사용할 때는 퍼지고, 느슨하고, 유연하게 작성하려고 노력하세요. 변경될 가능성이 높은 중요하지 않은 부분을 건너뛰고, 따옴표로 감싸진 값에 대해 작은따옴표와 큰따옴표를 모두 허용하는 등의 방식을 사용합니다.

##### 예시

다음 HTML 코드에서 `title`을 추출해야 한다고 가정해 보겠습니다:

```html
<span style="position: absolute; left: 910px; width: 90px; float: right; z-index: 9999;" class="title">some fancy title</span>
```

해당 작업에 대한 코드는 다음과 유사해야 합니다:

```python
title = self._search_regex(
    r'<span[^>]+class="title"[^>]*>([^<]+)', webpage, 'title')
```

또는 훨씬 더 나은 방법:

```python
title = self._search_regex(
    r'<span[^>]+class=(["\'])title\1[^>]*>(?P<title>[^<]+)',
    webpage, 'title', group='title')
```

`style` 속성 값의 잠재적 변경 사항이나 `class` 속성에 큰따옴표 대신 작은따옴표를 사용하는 것을 어떻게 허용하는지 주목하세요:

코드는 절대로 다음과 같아서는 안 됩니다:

```python
title = self._search_regex(
    r'<span style="position: absolute; left: 910px; width: 90px; float: right; z-index: 9999;" class="title">(.*?)</span>',
    webpage, 'title', group='title')
```

### 긴 줄 정책

코드 한 줄을 80자 미만으로 유지하는 소프트 제한이 있습니다. 즉, 가능하고 가독성과 코드 유지보수가 나빠지지 않는다면 이를 준수해야 합니다.

예를 들어, 이 제한에 맞추기 위해 URL이나 자주 복사되는 기타 엔터티와 같은 긴 문자열 리터럴을 여러 줄에 걸쳐 분할해서는 **절대 안 됩니다**:

올바름:

```python
'https://www.youtube.com/watch?v=FqZTN594JQw&list=PLMYEtVRpaqY00V9W81Cwmzp6N6vZqfUKD4'
```

올바르지 않음:

```python
'https://www.youtube.com/watch?v=FqZTN594JQw&list='
'PLMYEtVRpaqY00V9W81Cwmzp6N6vZqfUKD4'
```

### 인라인 값

변수 추출은 코드 중복을 줄이고 복잡한 표현식의 가독성을 높이는 데 허용됩니다. 그러나 한 번만 사용되는 변수를 추출하여 추출기 파일의 반대편으로 이동시키는 것은 선형 흐름을 읽기 어렵게 만들므로 피해야 합니다.

#### 예시

올바름:

```python
title = self._html_search_regex(r'<title>([^<]+)</title>', webpage, 'title')
```

올바르지 않음:

```python
TITLE_RE = r'<title>([^<]+)</title>'
# ...일부 코드 줄...
title = self._html_search_regex(TITLE_RE, webpage, 'title')
```

### 폴백 축소

여러 폴백 값은 금방 다루기 힘들어질 수 있습니다. 여러 폴백 값을 패턴 목록을 통해 단일 표현식으로 축소하세요.

#### 예시

좋음:

```python
description = self._html_search_meta(
    ['og:description', 'description', 'twitter:description'],
    webpage, 'description', default=None)
```

다루기 힘듦:

```python
description = (
    self._og_search_description(webpage, default=None)
    or self._html_search_meta('description', webpage, default=None)
    or self._html_search_meta('twitter:description', webpage, default=None))
```

패턴 목록을 지원하는 메서드는 다음과 같습니다: `_search_regex`, `_html_search_regex`, `_og_search_property`, `_html_search_meta`.

### 후행 괄호

후행 괄호는 항상 마지막 인수 뒤로 이동시키세요.

#### 예시

올바름:

```python
    lambda x: x['ResultSet']['Result'][0]['VideoUrlSet']['VideoUrl'],
    list)
```

올바르지 않음:

```python
    lambda x: x['ResultSet']['Result'][0]['VideoUrlSet']['VideoUrl'],
    list,
)
```

### 편리한 변환 및 파싱 함수 사용

추출된 모든 숫자 데이터를 [`youtube_dl/utils.py`](https://github.com/ytdl-org/youtube-dl/blob/master/youtube_dl/utils.py)의 안전한 함수(`int_or_none`, `float_or_none`)로 감싸세요. 문자열을 숫자로 변환할 때도 이를 사용하세요.

안전한 URL 처리를 위해 `url_or_none`을 사용하세요.

파싱된 JSON에서 안전한 메타데이터를 추출하려면 `traverse_obj`를 사용하세요.

균일한 `upload_date` 또는 모든 `YYYYMMDD` 메타 필드 추출에는 `unified_strdate`를, 균일한 `timestamp` 추출에는 `unified_timestamp`를, `filesize` 추출에는 `parse_filesize`를, 카운트 메타 필드 추출에는 `parse_count`를, `duration` 추출에는 `parse_resolution`, `parse_duration`을, `age_limit` 추출에는 `parse_age_limit`을 사용하세요.

더 많은 유용한 편리한 함수를 보려면 [`youtube_dl/utils.py`](https://github.com/ytdl-org/youtube-dl/blob/master/youtube_dl/utils.py)를 살펴보세요.

#### 추가 예시

##### 파싱된 JSON에서 선택적 설명 안전하게 추출

사이트 API 요청에서 반환되거나 "hydration"을 위해 웹페이지에 숨겨져 있는 복잡한 JSON을 처리할 때, `traverse_obj()` 유틸리티 함수를 사용하여 여러 폴백 값을 처리하고 메타데이터 항목의 예상 타입을 보장할 수 있습니다. 이 함수의 독스링(docstring)은 함수 작동 방식을 정의합니다. 더 많은 예시를 보려면 코드베이스의 사용법도 검토하세요.

이 예시에서는 파싱된 JSON `response`의 `.result.video[0].summary` 멤버에서 텍스트 `description` 또는 `None`을 가져옵니다(가능한 경우).

```python
description = traverse_obj(response, ('result', 'video', 0, 'summary', T(compat_str)))
```
`T(...)`는 집합 리터럴(set literal)의 단축 표현입니다. 여전히 Python 2.6을 실행하는 사람들을 싫어한다면, `T(type_or_transformation)`은 집합 리터럴 `{type_or_transformation}`으로 작성할 수 있습니다.

일부 추출기는 동일한 방식으로 더 오래되고 기능이 떨어지는 `try_get()` 함수를 사용합니다.

```python
description = try_get(response, lambda x: x['result']['video'][0]['summary'], compat_str)
```

##### 추가 선택적 메타데이터 안전하게 추출

이 예시에서는 파싱된 JSON `response`의 `.result.video[0]` 멤버에서 다양한 선택적 메타데이터 값을 추출합니다. 이 멤버는 JS 객체일 것으로 예상되며 `dict`로 파싱됩니다. 그렇지 않거나 대상 값이 누락되거나 유효하지 않은 경우에도 충돌이 발생하지 않습니다.

```python
video = traverse_obj(response, ('result', 'video', 0, T(dict))) or {}
# 이전 방식:
# video = try_get(response, lambda x: x['result']['video'][0], dict) or {}
description = video.get('summary')
duration = float_or_none(video.get('durationMs'), scale=1000)
view_count = int_or_none(video.get('views'))
```

#### 중첩된 목록 안전하게 추출

`InfoExtractor`의 `_download_json()` 또는 `_parse_json()` 메서드 등을 사용하여 다음과 같은 JSON을 `media_json`이라는 Python 데이터 구조로 추출했다고 가정해 보겠습니다:
```json
{
    "title": "Example video",
    "comment": "try extracting this",
    "media": [{
        "type": "bad",
        "size": 320,
        "url": "https://some.cdn.site/bad.mp4"
    }, {
        "type": "streaming",
        "url": "https://some.cdn.site/hls.m3u8"
    }, {
        "type": "super",
        "size": 1280,
        "url": "https://some.cdn.site/good.webm"
    }],
    "moreStuff": "more values",
    ...
}
```

그러면 다음과 같은 추출기 코드가 JSON의 다양한 필드를 수집할 수 있습니다:
```python
...
from ..utils import (
    determine_ext,
    int_or_none,
    T,
    traverse_obj,
    txt_or_none,
    url_or_none,
)
...
        ...
        info_dict = {}
        # 유효하고 비어 있지 않은 경우 제목과 설명 추출
        info_dict.update(traverse_obj(media_json, {
            'title': ('title', T(txt_or_none)),
            'description': ('comment', T(txt_or_none)),
        }))

# 인식할 수 있는 모든 미디어 포맷 추출
        fmts = []
        # "media" 목록을 탐색하여 원하는 키를 가진 `dict`를 추출합니다.
        for fmt in traverse_obj(media_json, ('media', Ellipsis, {
                'format_id': ('type', T(txt_or_none)),
                'url': ('url', T(url_or_none)),
                'width': ('size', T(int_or_none)), })):
            # 잘못된 `fmt` 값은 `None`이었으며 제거되었습니다.
            if 'url' not in fmt:
                continue
            fmt_url = fmt['url']  # 유효한 URL인 것으로 알려짐
            ext = determine_ext(fmt_url)
            if ext == 'm3u8':
                fmts.extend(self._extract_m3u8_formats(fmt_url, video_id, 'mp4', fatal=False))
            else:
                fmt['ext'] = ext
                fmts.append(fmt)

# 정렬, 포맷이 없는 경우 예외 발생
        self._sort_formats(fmts)

info_dict['formats'] = fmts
        ...
```
이 추출기는 포맷을 찾지 못하도록 JSON 구조가 변경되는 경우 무작위 충돌 대신 예외를 발생시킵니다.

# YOUTUBE-DL 임베딩

youtube-dl은 훌륭한 명령줄 프로그램이 되기 위해 최선을 다하며, 따라서 모든 프로그래밍 언어에서 호출할 수 있어야 합니다. 그 출력을 파싱하는 데 문제가 발생하는 경우 언제든지 [이슈를 생성해 주세요](https://github.com/ytdl-org/youtube-dl/issues/new).

Python 프로그램에서 다음과 같이 youtube-dl을 더 강력한 방식으로 임베딩할 수 있습니다:

```python
from __future__ import unicode_literals
import youtube_dl

ydl_opts = {}
with youtube_dl.YoutubeDL(ydl_opts) as ydl:
    ydl.download(['https://www.youtube.com/watch?v=BaW_jenozKc'])
```

대부분의 경우 다양한 옵션을 사용하고 싶을 것입니다. 사용 가능한 옵션 목록을 보려면 [`youtube_dl/YoutubeDL.py`](https://github.com/ytdl-org/youtube-dl/blob/3e4cedf9e8cd3157df2457df7274d0c842421945/youtube_dl/YoutubeDL.py#L137-L312)를 살펴보세요. 시작하려면 youtube-dl의 출력을 가로채기 위해 `logger` 객체를 설정하세요.

다음은 오류(및 다운로드 완료 후 짧은 메시지)만 출력하고 비디오를 mp3 파일로 다운로드/변환하는 프로그램의 더 완성된 예시입니다:

```python
from __future__ import unicode_literals
import youtube_dl

class MyLogger(object):
    def debug(self, msg):
        pass

def warning(self, msg):
        pass

def error(self, msg):
        print(msg)

def my_hook(d):
    if d['status'] == 'finished':
        print('Done downloading, now converting ...')

ydl_opts = {
    'format': 'bestaudio/best',
    'postprocessors': [{
        'key': 'FFmpegExtractAudio',
        'preferredcodec': 'mp3',
        'preferredquality': '192',
    }],
    'logger': MyLogger(),
    'progress_hooks': [my_hook],
}
with youtube_dl.YoutubeDL(ydl_opts) as ydl:
    ydl.download(['https://www.youtube.com/watch?v=BaW_jenozKc'])
```

# 버그

버그 및 제안 사항은 이슈 트래커에 신고해야 합니다: <https://github.com/ytdl-org/youtube-dl/issues> (<https://yt-dl.org/bug>는 이에 대한 별칭입니다). 요청받지 않았거나 다른 적절한 이유(예: GitHub가 버그 신고를 수락하지 않음)가 있는 경우가 아니라면 개인 이메일을 통해 버그 신고를 보내지 마세요. 토론을 원하시면 freenode의 IRC 채널 [#youtube-dl](irc://chat.freenode.net/#youtube-dl)에 참여하세요([웹채팅](https://webchat.freenode.net/?randomnick=1&channels=youtube-dl)).

## 버그 신고 또는 제안 열기

**아래** 및 **이슈 트래커**에 제공된 지침을 반드시 따르세요. 해당되는 이슈 템플릿을 완전히 작성하세요. 문제가 기존 이슈에 포함되는지 고려하세요. 그렇다면 해당 주의 토론을 따르세요. 기존 중복 이슈에 댓글을 단다고 해서 이슈 토론에 도움이 되지 않으며 스팸으로 취급될 수 있으므로 피하세요.

**`-v`와 함께 실행했을 때의 youtube-dl 전체 출력을 포함해 주세요**. 즉, **명령줄에** `-v` 플래그를 **추가**하고, **전체** 출력을 복사하여 더 나은 포맷팅을 위해 이슈 본문에 \`\`\`로 감싸서 게시하세요. 다음과 유사해야 합니다:
```
$ youtube-dl -v <your command line>
[debug] System config: []
[debug] User config: []
[debug] Command-line args: [u'-v', u'https://www.youtube.com/watch?v=BaW_jenozKcj']
[debug] Encodings: locale cp1251, fs mbcs, out cp866, pref cp1251
[debug] youtube-dl version 2015.12.06
[debug] Git HEAD: 135392e
[debug] Python version 2.6.6 - Windows-2003Server-5.2.3790-SP2
[debug] exe versions: ffmpeg N-75573-g1d0487f, ffprobe N-75573-g1d0487f, rtmpdump 2.4
[debug] Proxy map: {}
...
```
**상세 로그의 스크린샷을 게시하지 마세요. 일반 텍스트만 허용됩니다.**

출력(첫 줄 포함)에는 중요한 디버깅 정보가 포함되어 있습니다. 전체 출력이 없는 이슈는 종종 재현할 수 없으며 따라서 단기간에, 혹은 전혀 해결되지 않습니다.

마지막으로 아래에 나열된 다양한 흔한 실수를 피하기 위해 이슈를 검토하세요(이를 체크리스트로 사용할 수 있으며 사용해야 합니다).

### 이슈 자체의 설명이 충분한가요?

이해하기 어려운 이슈 신고가 자주 접수됩니다. 후속 명확화를 피하고 영어가 모국어가 아닌 참여자들을 돕기 위해, 어떤 기능을 요청하는지 또는 어떤 버그를 수정하고 싶은지 자세히 설명해 주세요.

다음 사항이 명확한지 확인하세요:

- 문제가 무엇인지
- 어떻게 수정될 수 있는지
- 제안된 솔루션이 어떻게 생겼을지

신고 내용이 두 줄보다 짧다면 이러한 내용 중 일부가 누락되었을 가능성이 거의 확실하며, 이로 인해 저희가 대응하기 어려워집니다. 저희는 너무 정중해서 이슈를 단호하게 닫지 못하는 경우가 많지만, 누락된 정보로 인해 오해의 소지가 커집니다. 저 자신도 커미터로서 이러한 이슈들로 인해 좌절감을 느끼는 경우가 많습니다. 왜냐하면 이슈를 진전시킬 수 있는 유일한 방법이 계속해서 명확화를 요청하는 것뿐이기 때문입니다.

버그 신고의 경우, 이는 신고에 `-v` 플래그와 함께 호출했을 때의 youtube-dl *전체* 출력이 포함되어야 함을 의미합니다. (대부분의) 버그에 대해 얻는 오류 메시지조차 그렇게 하라고 말하지만, 저희 버그 신고 중 얼마나 많은 것들에 이 정보가 포함되어 있지 않은지 알면 믿지 못하실 것입니다.

서버에 여러 IP가 있거나 검열이 의심되는 경우, 더 많은 진단 정보를 얻기 위해 `--call-home`을 추가하는 것이 좋은 생각일 수 있습니다. 오류가 `ERROR: Unable to extract ...`이고 여러 국가에서 재현할 수 없는 경우, `--dump-pages`를 추가하고(경고: 이는 다소 큰 출력을 생성하므로 명령줄에 `>log.txt 2>&1`을 추가하여 `log.txt` 파일로 리디렉션하세요) `--write-pages`를 추가할 때 얻는 `.dump` 파일을 [어딘가에](https://gist.github.com/) 업로드하세요.

**사이트 지원 요청에는 예시 URL이 포함되어야 합니다**. 예시 URL은 `https://www.youtube.com/watch?v=BaW_jenozKc`처럼 다운로드하고 싶을 수 있는 URL입니다. 명백한 비디오가 존재해야 합니다. 아주 특별한 경우를 제외하고는 비디오 서비스의 메인 페이지(예: `https://www.youtube.com/`)는 예시 URL이 *아닙니다*.

### 이슈가 이미 문서화되어 있나요?

누군가 이미 열려고 하는 이슈를 열지 않았는지 확인하세요. 창 상단에서 검색하거나 이 저장소의 [GitHub Issues](https://github.com/ytdl-org/youtube-dl/search?type=Issues)를 찾아보세요. 적어도 처음에는 활성 이슈에 집중하기 위해 `-label:duplicate` 검색어를 사용하세요. 이슈가 있는 경우 "이것은 저에게도 영향을 미칩니다, 버전 2015.01.01. 이슈에 대한 추가 정보는 다음과 같습니다: ..." 같은 내용을 자유롭게 작성해 주세요. 일부 이슈는 오래되었을 수 있지만, 거기에 새 글을 게시하면 종종 빠른 활동이 촉발됩니다.

### 최신 버전을 사용하고 계신가요?

어떤 이슈를 신고하든 `youtube-dl -U`를 입력하세요. 그러면 최신 상태임을 보고해야 합니다. 저희가 받는 신고의 약 20%는 이미 수정되었지만 사람들이 구버전을 사용하고 있는 경우입니다. 이는 기능 요청에도 해당됩니다.

### 기존 옵션이 충분하지 않은 이유는 무엇인가요?

새 기능을 요청하기 전에 [지원되는 옵션 목록](https://github.com/ytdl-org/youtube-dl/blob/master/README.md#options)을 간단히 살펴보세요. 많은 기능 요청은 실제로 이미 존재하는 기능에 대한 것입니다! 제발, 이슈 신고에서 여러분의 작업을 과시하고 기존의 유사한 옵션이 왜 여러분의 문제를 해결하지 *못하는지* 자세히 설명해 주세요.

### 버그 신고에 충분한 맥락이 포함되어 있나요?

사람들은 문제를 해결하고 싶어 하며, 종종 더 큰 문제(예: 이미 다운로드한 파일 건너뛰기)를 특정 요청(예: 정보 페이지를 다운로드하기 전에 파일이 존재하는지 확인해 달라고 요청)으로 쪼개서 우리에게 호의를 베푼다고 생각합니다. 하지만 흔히 일어나는 일은 문제를 두 단계로 쪼개는 것입니다. 하나는 쉽고, 다른 하나는 불가능한(또는 극도로 복잡한) 단계입니다.

그러면 원래 문제를 훨씬 더 쉽게(예: 다운로드한 비디오 ID를 별도의 파일에 기록하여) 해결할 수 있었음에도 불구하고 매우 복잡한 요청을 받게 됩니다. 이를 방지하려면 명백하지 않은 경우 더 큰 맥락을 포함해야 합니다. 특히 새로운 사이트에 대한 지원 추가로 구성되지 않은 모든 기능 요청에는 누락된 기능이 어떤 상황에서 유용할지 설명하는 사용 사례 시나리오가 포함되어야 합니다.

### 이슈가 하나의 문제, 오직 하나의 문제만 포함하고 있나요?

일부 사용자들은 자신들이 열 수 있거나 열어야 하는 이슈에 제한이 있다고 생각하는 것 같습니다. 열 수 있거나 열어야 하는 이슈에는 제한이 없습니다. 모든 이슈를 하나의 티켓에 쏟아부을 수 있는 것이 매력적으로 보일 수 있지만, 이는 여러분의 이슈 중 하나를 해결한 사람이 그 이슈를 닫힘으로 표시할 수 없음을 의미합니다. 일반적으로 여러 이슈를 한꺼번에 신고하면 그 거대 괴수를 처리하려는 사람이 없기 때문에 티켓이 계속 남아 있게 되며, 누군가 자비롭게 이슈를 여러 개로 쪼갤 때까지 지속됩니다.

특히 모든 사이트 지원 요청 이슈는 하나의 사이트에 있는 서비스(일반적으로 공통 도메인 아래에 있지만 항상 동일한 백엔드 기술을 사용함)에만 관련되어야 합니다. 같은 이슈에서 vimeo 사용자 비디오, 백악관 팟캐스트, Google 플러스 페이지에 대한 지원을 요청하지 마세요. 또한 버그 신고를 기능 요청과 함께 게시하지 않도록 하세요. 경험상 기능 요청에는 현재 다루고 있는 기능과 즉시 관련되지 않은 youtube-dl의 출력이 포함되지 않습니다. 네트워크 오류 신고를 새 비디오 서비스 요청과 함께 게시하지 마세요.

### 이 기능이 누군가에게 필요할까요?

여러분(또는 직접 대화할 수 있는 무력화된 친구)에게 필요한 기능만 게시하세요. 좋은 아이디어인 것 같다는 이유로 기능을 게시하지 마세요. 정말 유용하다면 그것이 필요한 사람이 요청할 것입니다.

### 질문이 youtube-dl에 관한 것인가요?

이상하게 들릴 수 있겠지만, 저희가 받는 일부 버그 신고는 youtube-dl과 전혀 관련이 없으며 다른 응용 프로그램이나 신고자 자신의 응용 프로그램과 관련이 있습니다. 실제로 youtube-dl을 사용하고 있는지 확인하세요. youtube-dl용 UI를 사용하고 있는 경우, UI를 제공하는 실제 응용 프로그램의 유지 관리자에게 버그를 신고하세요. 반면에 youtube-dl용 UI가 youtube-dl과 관련이 있다고 믿는 어떤 방식으로든 실패하는 경우, 망설이지 말고 버그를 신고하세요.

# 저작권

이 README 파일은 원래 [Daniel Bolton](https://github.com/dbbolton)이 작성했으며 마찬가지로 퍼블릭 도메인으로 배포되었습니다.

youtube-dl

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

youtube-dl

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README