> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Extensão Youka

> Desbloqueie recursos do desktop no seu navegador: crie a partir de URLs de vídeo, pesquise letras e exporte localmente

A Extensão Youka traz recursos avançados do desktop para o seu navegador, permitindo criar karaokê a partir de URLs de vídeo, pesquisar letras automaticamente e exportar vídeos localmente. Exportações locais são gratuitas; exportações na nuvem ainda usam créditos.

## O que você recebe

Com a Extensão Youka instalada, você desbloqueia três recursos principais:

* **Criar a partir de URLs de Vídeo** — Baixe e crie karaokê diretamente a partir de links de vídeo
* **Pesquisar Letras Online** — Encontre e importe letras automaticamente da internet
* **Exportações Locais Gratuitas** — Renderize vídeos localmente no seu computador sem usar créditos da nuvem

## Instalação

### Baixar a Extensão

1. Acesse a [página de download da extensão](/extension)
2. Clique no botão de download para o seu sistema operacional (Windows, macOS, ou Linux)
3. Execute o instalador e siga as instruções de configuração
4. A extensão é executada na bandeja do sistema (você verá um pequeno ícone)

### Conectar ao seu Navegador

Depois de instalada, a extensão se conecta automaticamente quando você visita o Youka Online:

1. Abra [online.youka.io](https://online.youka.io) no seu navegador
2. Procure o indicador da extensão no canto superior direito (deve mostrar "Connected")
3. Você já pode usar todos os recursos da extensão!

## Criando Karaokê a partir de URLs de Vídeo

Em vez de enviar arquivos, agora você pode criar karaokê diretamente a partir de links de vídeo:

1. Clique em **Create Karaoke** na página inicial
2. Selecione a aba **From URL**
3. Cole uma URL de vídeo da sua plataforma de streaming preferida
4. Clique em **Download**
5. A extensão baixa o vídeo e extrai o áudio
6. Continue com as letras normalmente

**Observação**: Certifique-se de que a extensão está em execução e conectada antes de usar este recurso.

## Pesquisando Letras Automaticamente

Ao adicionar letras ao seu karaokê, a extensão pode pesquisar na internet para você:

1. Na área de entrada de letras, você verá um botão **Search** (visível apenas quando a extensão estiver conectada)
2. Clique em **Search** para encontrar automaticamente a letra com base no título da sua música
3. Se forem encontradas letras, elas serão importadas para a área de texto
4. Edite ou ajuste conforme necessário

Isso evita que você precise procurar manualmente e copiar letras de outros sites.

## Exportações Locais Gratuitas

Exporte seus vídeos de karaokê localmente sem usar créditos da nuvem. Exportações na nuvem ainda usam créditos:

1. Abra seu projeto no editor Studio
2. Clique em **Export** para abrir a janela de exportação
3. Você verá duas opções de exportação:
   * **Cloud Export** — Usa créditos, renderiza na nuvem
   * **Local Export** — Gratuito, renderiza no seu computador (requer a extensão)
4. Selecione **Local Export**
5. Escolha suas configurações de exportação (resolution, quality, FPS, transparency)
6. Clique em **Start Export**
7. A extensão renderiza o vídeo localmente e o salva no seu computador

**Benefícios da exportação local:**

* Totalmente gratuito — não requer créditos
* Exportações ilimitadas
* Seus arquivos permanecem no seu computador
* Controle total sobre o local de saída

## Solução de problemas

### Extensão não conectando

Se a extensão não se conectar automaticamente:

1. Verifique se a extensão está em execução (confira a bandeja do sistema)
2. Reinicie o aplicativo da extensão
3. Atualize a página do navegador
4. Verifique se você está usando um navegador compatível (Chrome, Edge, Firefox)

### Falha no download

Se o download do vídeo falhar:

1. Verifique se a URL é um link de vídeo válido
2. Confirme se o vídeo está disponível publicamente (não é privado/com restrição de idade)
3. Tente um vídeo diferente para testar
4. Atualize a extensão para a versão mais recente

### Exportação demorando muito

As exportações locais são renderizadas no seu computador, então a velocidade depende de:

* Desempenho da sua CPU/GPU
* Duração e resolução do vídeo
* Configurações de qualidade da exportação

Para exportações mais rápidas, tente reduzir a resolução ou as configurações de qualidade.

## Requisitos do sistema

* **Sistema Operacional**: Windows 10+, macOS 10.15+, ou Linux (Ubuntu 20.04+)
* **Memória**: 4GB RAM mínimo, 8GB+ recomendado
* **Armazenamento**: 500MB para a extensão, mais espaço para arquivos de vídeo
* **Internet**: Necessária para baixar vídeos e pesquisar letras

## Privacidade & Segurança

A Extensão Youka:

* Roda localmente no seu computador
* Só se conecta ao Youka Online quando você está usando o app web
* Não coleta nem envia dados pessoais
* Os downloads são processados na sua máquina
* As exportações ficam no seu computador (nunca são enviadas)

## Atualizações

A extensão verifica automaticamente por atualizações quando inicia. Para atualizar manualmente:

1. Baixe a versão mais recente na [página de download da extensão](/extension)
2. Execute o novo instalador (ele atualizará sua instalação existente)
3. Reinicie a extensão

## Como obter ajuda

Se você tiver problemas:

* Consulte a [seção de solução de problemas](#troubleshooting) acima
* Envie um email para [support@youka.io](mailto:support@youka.io)