# VOCAL NOTE ONE — Guia de utilização

Olá! Recebeu um ficheiro chamado `VocalNoteOne.html`. É uma aplicação que lhe permite ditar notas em voz alta e guardá-las no seu computador. Não precisa de instalar nada, é muito simples!

---

## 1. Como abrir a aplicação

1. Localize o ficheiro `VocalNoteOne.html` no seu computador.
2. Clique com o botão direito em cima dele.
3. Clique em « Abrir com » e escolha **Google Chrome**.
4. A aplicação abre directamente no seu navegador.

> **Navegadores compatíveis**
>
> * **Google Chrome — recomendado.** É com o Chrome que o ditado é mais fiável, no Windows, Mac e Linux.
> * **Microsoft Edge — funciona, com duas ressalvas.** O ditado é por vezes menos regular em sessões longas. E se o seu computador for gerido por um departamento de informática, este pode ter desactivado o reconhecimento de voz do Edge: nesse caso a aplicação abre normalmente, mas não aparece qualquer texto. Se isso acontecer, abra o ficheiro com o Chrome.
> * **Firefox e Safari não são compatíveis.** O ditado não vai funcionar.

---

## 2. Como ditar uma nota

1. Clique no botão azul « Gravar as minhas notas ».
2. Abre-se uma pequena janela no topo do ecrã. Clique em **« Permitir ao visitar o site »**.
3. O botão fica vermelho e mostra « Parar a gravação »: já pode falar!
4. Fale normalmente, o seu texto é escrito automaticamente na área de texto grande.
5. É normal haver um pequeno atraso entre o momento em que fala e o momento em que o texto aparece: é o tempo de processamento do reconhecimento de voz.
6. Se vir um erro, clique directamente no texto e corrija-o pelo teclado. As suas correcções são mantidas, mesmo que continue a ditar depois.
7. Quando terminar, clique no botão vermelho « Parar a gravação ».
8. A sua nota é guardada automaticamente.

---

## 3. A retoma após um silêncio — **leia com atenção**

Este é o ponto mais importante deste guia.

**O que acontece.** Se ficar cerca de **20 segundos sem falar**, o Google Chrome interrompe o ditado e volta a pedir-lhe autorização para usar o microfone. A pequena janela reaparece.

**Há dois sítios que o informam**, e não dizem a mesma coisa.

### No topo — onde está

| O que vê | O que significa |
| :--- | :--- |
| **Transcrição**, sem ponto colorido | Nenhum ditado em curso. |
| **A gravar…**, ponto vermelho a piscar | O ditado está activo. |

### Em baixo, logo por cima dos botões — o que fazer

Esta linha fica vazia enquanto está tudo bem. Quando lhe é pedida alguma acção, ela aparece aqui, sobre fundo amarelo:

> ⬤ Clique em « Permitir ao visitar o site » para retomar

É a mensagem do silêncio prolongado. Clique no botão indicado na pequena janela do Chrome: a linha desaparece sozinha assim que pronunciar uma palavra, e o ditado recomeça.

**Porquê em baixo e não no topo?** A janela de autorização do Chrome abre sempre no topo da página. Numa janela estreita, tapa a parte de cima da aplicação. A parte de baixo do ecrã fica visível em todas as circunstâncias: uma mensagem que explica em que botão clicar não pode ficar escondida pela janela de que está a falar.

**Não se perde nada.** O texto já ditado permanece no ecrã. Retoma exactamente onde ficou, na mesma nota.

**Porque é que isto acontece.** Quando abre um ficheiro directamente a partir do seu disco, o navegador não tem uma identidade estável à qual associar a sua autorização. É por isso obrigado a voltar a pedi-la. É uma regra de segurança do Chrome, não um defeito da aplicação, e nenhuma configuração da aplicação a pode contornar.

**As duas primeiras opções da janela dão no mesmo.** « Permitir ao visitar o site » e « Permitir desta vez » comportam-se de forma idêntica aqui: a janela vai voltar depois de cada silêncio prolongado nos dois casos. Não vale a pena procurar qual escolher — escolha a primeira. Nunca clique em « Nunca permitir », que bloquearia o microfone de forma duradoura.

### Se a ligação à Internet falhar

A mesma linha de baixo serve para o avisar, em cinzento desta vez:

> ⬤ Sem ligação à Internet. O ditado precisa de Internet para transcrever a sua voz.

* Se clicar em « Gravar as minhas notas » sem ligação, o ditado não arranca e aparece esta mensagem. Não fica a falar para o vazio.
* Se a ligação cair enquanto está a ditar, a mensagem aparece mas **o ditado não é interrompido** e o seu texto permanece no ecrã.
* Assim que a ligação regressa, a transcrição recomeça sozinha. **Não se reabre qualquer janela de autorização** e não tem de clicar em nada.

---

## 4. Como ler e gerir as suas notas

1. Clique no botão azul « Ver as minhas notas ».
2. Abre-se uma janela com todas as suas notas guardadas, a mais recente no topo.
3. Cada nota mostra o seu texto, a data e a hora, e três botões: **Copiar**, **Editar**, **Eliminar**.
4. Feche esta janela com o botão « Fechar » ou a tecla **Esc**.

---

## 5. Como copiar uma nota

1. Clique em « Ver as minhas notas ».
2. Clique no botão **Copiar** da nota pretendida.
3. O texto fica copiado. Cole-o (`Ctrl+V`) num e-mail, num documento, numa aplicação de mensagens…

---

## 6. Como exportar todas as suas notas

1. Clique em « Ver as minhas notas ».
2. Na parte de baixo da janela, clique em « Exportar todas as minhas notas (.txt) ».
3. É transferido para o seu computador um ficheiro de texto com todas as suas notas e respectivas datas.
4. É também a melhor forma de fazer uma cópia de segurança.

---

## 7. Como editar uma nota já guardada

1. Clique em « Ver as minhas notas ».
2. **Clique directamente no texto da nota** que quer corrigir. O botão **Editar** faz o mesmo.
3. O texto fica editável. Faça as suas correcções.
4. Clique em **Guardar** para confirmar, ou em **Cancelar** para desistir.

**Atalhos durante a edição**

* `Ctrl + Enter`: guardar sem tirar as mãos do teclado.
* `Esc`: cancelar a edição. A janela das notas permanece aberta.

Se começou a editar uma nota e tentar fechar a janela, é-lhe pedida uma confirmação: as suas correcções não podem desaparecer sem que o tenha querido.

---

## 8. Como eliminar uma nota

1. Clique em « Ver as minhas notas ».
2. Clique no botão vermelho **Eliminar** da nota em questão.
3. É-lhe pedida uma confirmação antes de qualquer eliminação.

---

## 9. Modo escuro

1. Localize o botão redondo no canto superior direito do ecrã.
2. Clique nele para passar ao modo escuro.
3. Clique novamente para voltar ao modo claro.
4. A sua preferência fica memorizada: a aplicação vai abrir logo no tema certo, sem piscar.

---

## 10. Navegação pelo teclado

A aplicação pode ser utilizada inteiramente pelo teclado.

* **Tab**: passar de um botão ao seguinte. O botão activo fica rodeado por um contorno azul bem visível.
* **Enter** ou **Espaço**: accionar o botão seleccionado.
* **Ctrl + Enter**: guardar uma nota em edição.
* **Esc**: cancelar uma edição em curso, ou fechar a janela das notas.

As mudanças de estado — início do ditado, espera de autorização, nota guardada, número de notas — são anunciadas aos leitores de ecrã.

---

## 11. Sugestões práticas

* Pode guardar quantas notas quiser, vão-se acumulando umas a seguir às outras.
* O contador no topo indica-lhe quantas notas tem.
* Se o texto estiver demasiado pequeno ou demasiado grande, use `Ctrl` + roda do rato para ampliar.
* As suas notas são guardadas automaticamente no seu computador, mesmo que feche e volte a abrir o ficheiro.
* O seu texto em curso é guardado como rascunho enquanto dita ou escreve: em caso de fecho acidental, recupera-o ao voltar a abrir.
* Se utilizar várias versões em idiomas diferentes, cada uma guarda as suas próprias notas, separadamente das outras.
* **Utiliza um assistente de IA (um LLM, como o ChatGPT ou o Claude)?** No telemóvel, o ditado por voz está integrado no teclado; no computador, essa função geralmente não existe. O VocalNoteOne preenche essa lacuna: dite a sua pergunta ou a sua instrução, copie o texto, cole-o na conversa. É bastante mais rápido do que escrever, e foi uma das utilizações que motivou a criação desta aplicação.

---

## 12. Em caso de problema

| Problema | Solução |
| :--- | :--- |
| **O microfone não funciona** | Verifique se está a utilizar o Google Chrome ou o Microsoft Edge, e se clicou em « Permitir ao visitar o site ». |
| **A janela de autorização reaparece** | Normal ao fim de cerca de 20 segundos de silêncio. Clique em « Permitir ao visitar o site »: o ditado retoma e não se perde nada. Veja a secção 3. |
| **Aparece uma frase amarela em baixo** | O ditado está à espera da sua autorização. Clique no botão indicado na mensagem, dentro da pequena janela do Chrome. Veja a secção 3. |
| **O texto aparece com um ligeiro atraso** | Normal: a latência faz parte do funcionamento do reconhecimento de voz. |
| **O texto não é escrito de todo** | Fale mais alto e com mais clareza, e verifique a sua ligação à Internet. Se estiver no Microsoft Edge e mesmo assim não aparecer nada, abra o ficheiro com o Google Chrome. |
| **Aparece uma frase cinzenta em baixo** | Está sem ligação à Internet. O ditado precisa dela: é o serviço do navegador que transcreve a sua voz, não o seu computador. Restabeleça a ligação e o ditado recomeça sozinho. As notas já guardadas continuam acessíveis sem ligação. |
| **Uma mensagem diz que o ditado foi interrompido** | A ligação caiu várias vezes seguidas. Clique em « Gravar as minhas notas » para recomeçar; o seu texto está intacto. |
| **Não vê as suas notas antigas** | Abra sempre o mesmo ficheiro `VocalNoteOne.html`, no mesmo navegador, e na mesma versão de idioma. |
| **Aparece a mensagem « Armazenamento cheio »** | A sua nota permanece no ecrã, não se perdeu. Exporte as suas notas em `.txt`, apague as mais antigas, e volte a clicar em « Parar a gravação ». |

O seu problema não consta desta tabela? Escreva para **contact.vocalnoteone@gmail.com** descrevendo o que se passa e o navegador que utiliza. As mensagens são lidas.

---

## 13. Apoiar o projeto

O VocalNoteOne é gratuito e continuará a sê-lo. Não há versão paga, não há funcionalidades reservadas, não há publicidade: o que tem à sua frente é a aplicação completa.

Se lhe for útil e quiser ajudar o seu desenvolvimento, pode fazer um donativo em criptomoeda. É totalmente facultativo e não desbloqueia nada de adicional.

Os endereços encontram-se na parte inferior do ecrã, por baixo dos dois botões, de um lado e do outro do logótipo. São aceites quatro redes: Bitcoin, Solana, Ethereum e Arbitrum. O endereço apresentado está abreviado para caber na janela; clique nele e o endereço completo é copiado, basta colá-lo na sua carteira.

---

**Boa utilização!**
**VocalNote One — Ditar. Guardar. Partilhar.**
*Guia de utilização — Versão 1.7, 2026*
