====== yt-dlp ======

===== Nível Básico =====

=== 1. Download de Vídeos com `yt-dlp` ===
  * **yt-dlp [URL]** - Baixa um vídeo a partir da URL especificada.
    - Exemplo de uso: <code bash>yt-dlp https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Baixa o vídeo do YouTube localizado no link especificado. O arquivo será salvo no diretório atual com o nome padrão.

=== 2. Escolha do Nome de Saída com `-o` ===
  * **yt-dlp -o** - Define o nome e o local de salvamento do arquivo de vídeo.
    - Exemplo de uso: <code bash>yt-dlp -o "/home/usuario/Vídeos/meuvideo.%(ext)s" https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Baixa o vídeo e o salva em ''/home/usuario/Vídeos/'' com o nome ''meuvideo'' e a extensão do arquivo baixado, como .mp4 ou .webm.

=== 3. Baixar Apenas o Áudio com `-x` ===
  * **yt-dlp -x** - Extrai e baixa somente o áudio do vídeo.
    - Exemplo de uso: <code bash>yt-dlp -x https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Baixa o áudio do vídeo e o salva em formato padrão, como .m4a ou .mp3.

===== Nível Intermediário =====

=== 1. Escolha do Formato de Vídeo com `-f` ===
  * **yt-dlp -f** - Define o formato de vídeo a ser baixado.
    - Exemplo de uso: <code bash>yt-dlp -f 22 https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Baixa o vídeo usando um formato específico (neste caso, formato 22, que geralmente é 720p no YouTube). Para ver os formatos disponíveis, use o comando ''yt-dlp -F [URL]''.

=== 2. Definir Qualidade do Áudio com `-f` ===
  * **yt-dlp -f "bestaudio"** - Escolhe o melhor formato de áudio disponível.
    - Exemplo de uso: <code bash>yt-dlp -f bestaudio -x https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Baixa o áudio do vídeo com a melhor qualidade disponível no site, salvando-o no formato original.

=== 3. Download de Listas de Reprodução com `--yes-playlist` ===
  * **yt-dlp --yes-playlist** - Baixa todos os vídeos de uma lista de reprodução.
    - Exemplo de uso: <code bash>yt-dlp --yes-playlist https://www.youtube.com/playlist?list=IDdaPlaylist</code>
    - Descrição: Baixa todos os vídeos de uma playlist especificada no link. Este comando evita a confirmação manual para baixar listas completas.

===== Nível Avançado =====

=== 1. Download com Limite de Velocidade usando `--limit-rate` ===
  * **yt-dlp --limit-rate** - Limita a velocidade de download.
    - Exemplo de uso: <code bash>yt-dlp --limit-rate 500K https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Limita a velocidade de download a 500 KB/s, útil para economizar largura de banda ou manter outras atividades de rede sem interrupções.

=== 2. Uso de Proxy com `--proxy` ===
  * **yt-dlp --proxy** - Baixa vídeos através de um proxy.
    - Exemplo de uso: <code bash>yt-dlp --proxy socks5://127.0.0.1:1080 https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Baixa o vídeo usando um servidor proxy do tipo SOCKS5, redirecionando o tráfego para o endereço IP e porta especificados.

=== 3. Definir Qualidade Máxima de Download com `-S` ===
  * **yt-dlp -S** - Ordena os downloads com base na qualidade.
    - Exemplo de uso: <code bash>yt-dlp -S "res:1080,ext:mp4" https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Baixa o vídeo na resolução máxima de 1080p, priorizando o formato mp4 se disponível. O comando permite escolher a melhor qualidade disponível com base nos critérios definidos.

=== 4. Mesclar Vídeo e Áudio com `--merge-output-format` ===
  * **yt-dlp --merge-output-format** - Mescla vídeo e áudio em um único arquivo.
    - Exemplo de uso: <code bash>yt-dlp -f bestvideo+bestaudio --merge-output-format mp4 https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Baixa a melhor qualidade de vídeo e áudio disponíveis e mescla ambos em um arquivo final no formato mp4, útil para vídeos que possuem áudio e vídeo em streams separados.

===== Nível Especializado =====

=== 1. Customização Avançada de Nomes com `-o` e Variáveis ===
  * **yt-dlp -o** - Usa variáveis para nomear arquivos de forma personalizada.
    - Exemplo de uso: <code bash>yt-dlp -o "/home/usuario/Vídeos/%(title)s_%(id)s.%(ext)s" https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Salva o vídeo com o título e ID do vídeo concatenados no nome do arquivo, facilitando a organização e identificação dos downloads.

=== 2. Baixar Comentários com `--write-comments` ===
  * **yt-dlp --write-comments** - Baixa os comentários de um vídeo.
    - Exemplo de uso: <code bash>yt-dlp --write-comments https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Extrai e salva os comentários do vídeo em um arquivo de texto separado, permitindo a análise dos comentários sem acessar o site.

=== 3. Uso de Autenticação com `--username` e `--password` ===
  * **yt-dlp --username** e **--password** - Baixa conteúdo restrito com login.
    - Exemplo de uso: <code bash>yt-dlp --username meuusuario --password minhasenha https://www.youtube.com/watch?v=exemplo</code>
    - Descrição: Usa as credenciais fornecidas para acessar e baixar conteúdo restrito ou privado. Essas informações são usadas apenas para autenticar o download.

=== 4. Uso de Arquivo de Configuração Padrão com `yt-dlp.conf` ===
  * **yt-dlp.conf** - Armazena configurações permanentes para o yt-dlp.
    - Exemplo de uso:
    <code bash>
    # Crie ou edite o arquivo de configuração em ~/.config/yt-dlp/yt-dlp.conf
    --format best
    --limit-rate 1M
    --output "/home/usuario/Vídeos/%(title)s.%(ext)s"
    </code>
    - Descrição: Cria um arquivo de configuração padrão onde comandos são executados automaticamente a cada download. Isso economiza tempo ao configurar opções permanentes para o **yt-dlp**.