git-cli-yt 1.1.9 → 2.0.0

package/PRIVACY_POLICY.md

@@ -0,0 +1,10 @@
+# Política de Privacidade — CLI YT Music Player
+
+O aplicativo utiliza a API do YouTube e o `yt-dlp` para buscar e reproduzir músicas solicitadas pelo usuário. Ele não possui servidor próprio e não vende nem compartilha dados com terceiros além dos serviços necessários ao funcionamento.
+
+1. **Dados enviados ao YouTube:** consultas de busca de músicas, solicitações de metadados e reprodução das músicas selecionadas.
+2. **Escopo do conteúdo:** somente itens da categoria Música (`categoryId=10`) são exibidos na busca, nas curtidas e na Mix.
+3. **Autenticação:** o token OAuth é armazenado localmente em `~/.config/meu-player-tui/token.json`. Ele não é enviado para servidores do projeto.
+4. **Permissões OAuth:** o escopo `youtube.readonly` permite consultar dados somente leitura da conta. O aplicativo usa essa autorização para listar vídeos curtidos e obter o nome do canal.
+5. **Chave de API:** uma `YOUTUBE_API_KEY` configurada no ambiente pode ser usada para buscas públicas quando não há login.
+6. **Retenção e compartilhamento:** o aplicativo não mantém telemetria própria e não compartilha credenciais ou histórico com servidores do projeto.

package/README.md

@@ -1 +1,49 @@
-# CLI-YT
+# CLI-YT
+
+Player de músicas do YouTube para terminal, feito com Textual. A busca e as curtidas são filtradas pela categoria Música do YouTube.
+
+## Requisitos
+
+- Python 3.9 ou superior
+- Node.js para usar o launcher `bin/cli.js`
+
+## Configuração
+
+Crie um arquivo `.env` na pasta desde onde o aplicativo será iniciado:
+
+```env
+YOUTUBE_CLIENT_ID=seu_client_id
+YOUTUBE_CLIENT_SECRET=seu_client_secret
+YOUTUBE_API_KEY=sua_api_key_opcional
+```
+
+- `YOUTUBE_API_KEY` permite busca pública mesmo sem login.
+- OAuth é obrigatório para carregar **Curtidas**.
+- O token OAuth é salvo em `~/.config/meu-player-tui/token.json`.
+- Quando a API está sem cota, Busca e Mix usam `yt-dlp` automaticamente; Curtidas continuam usando OAuth.
+- A opção **Playlists** abre um painel lateral com **Curtidas** primeiro e as playlists públicas do canal autenticado.
+- `YTDLP_COOKIES_FILE` pode apontar para um arquivo Netscape de cookies ao abrir uma URL de playlist privada.
+
+## Executar
+
+Via Node, com ambiente Python isolado e dependências cacheadas:
+
+```bash
+node bin/cli.js
+```
+
+Diretamente com Python:
+
+```bash
+python -m pip install -r requirements.txt
+python main.py
+```
+
+## Controles
+
+- `Enter`: enviar a busca
+- `Espaço`: tocar/pausar
+- `↑` / `↓`: volume
+- `N` / `P`: próxima/anterior
+- `F` / `B`: avançar/retroceder 10 segundos
+- `Q`: sair