Perguntas frequentes
Respostas claras sobre o NotesQR: partilha P2P WebRTC gratuita, sem registo e sem guardar ficheiros nos nossos discos.
As respostas estão no HTML da página e em dados estruturados (FAQPage), para motores e sistemas de IA as lerem mesmo com secções fechadas.
Perguntas gerais
O NotesQR é gratuito?
Sim. O produto em notesqr.com é gratuito para partilha P2P. Doações opcionais ajudam a manter o signaling e o TURN.
Preciso de uma conta?
Não. Pode enviar e receber sem se registar.
Os meus ficheiros são carregados para os servidores do NotesQR?
O conteúdo dos ficheiros não é guardado no NotesQR para download posterior. Os peers trocam dados via WebRTC. O NotesQR só faz signaling e TURN quando não há caminho direto. Ambos os lados devem permanecer online até terminar.
Há limite de tamanho?
O NotesQR não impõe uma quota de produto. Os limites práticos são os seus dispositivos, a memória do browser e a rede. Não há um “teto MB do plano gratuito” como em muitos serviços de upload-and-store.
O que acontece se o remetente fechar a página ou a CLI?
O caminho P2P em direto termina. Quem não tiver acabado não consegue concluir essa transferência. Mantenha o remetente online até os downloads terminarem.
Posso proteger uma sala com palavra-passe?
Sim. O anfitrião pode definir uma palavra-passe opcional antes dos convidados entrarem. Trate links sem palavra-passe como segredos.
O que é “Fechar após transferir” / CLI --once?
Quando ativo, a sala fecha depois de cada ficheiro partilhado ter sido transferido pelo menos uma vez (incluindo cada ficheiro dentro de pastas). A mesma ideia do flag --once da CLI.
Posso partilhar uma pasta inteira?
Sim. Na web, desktop e extensões: largue uma pasta ou use Procurar → Pasta. Os peers só veem caminhos relativos à partilha. A CLI aceita diretórios no send e recria a árvore no recv.
Funciona no telemóvel?
Sim. Abra o URL da sala ou leia o QR. O remetente (muitas vezes desktop ou CLI) deve permanecer online.
Posso usar o NotesQR na linha de comandos ou com um agente de IA?
Sim. Use o cliente aberto notesqr-share (CLI send/recv e ferramentas MCP). Ambos os peers devem permanecer online. Prefira --once em envios de agentes se o host deve sair após a entrega.
Quão privada é a transferência? E o TURN?
As transferências usam WebRTC entre peers. O NotesQR não mantém uma cópia alojada dos bytes após um handoff bem-sucedido. Se o caminho direto falhar, o tráfego pode passar por TURN durante a sessão: sem arquivo descarregável no NotesQR.
Onde está o NotesQR no GitHub?
Overview do produto: github.com/NotesQR/NotesQR. Cliente CLI/MCP aberto: github.com/NotesQR/notesqr-share.
Terminologia
Definições curtas de palavras que verá na documentação do NotesQR, na CLI e na UI da room.
O que é WebRTC?
Web Real-Time Communication: APIs de browser e nativas para áudio, vídeo ou dados diretos entre peers. O NotesQR usa data channels WebRTC para mover os bytes dos ficheiros.
O que significa P2P?
Peer-to-peer: os dispositivos trocam os bytes do ficheiro entre si. O NotesQR não é um drive de upload-and-store que guarda uma cópia alojada para download anónimo posterior.
O que é o signaling?
As pequenas mensagens que ajudam os peers a encontrarem-se e a montar WebRTC (offers, answers, candidatos ICE). O NotesQR faz signaling; o conteúdo dos ficheiros não fica como arquivo descarregável nos nossos discos.
O que são STUN e TURN?
STUN ajuda a descobrir o seu endereço de rede público. TURN é um relay só quando falha o caminho direto (NAT/firewall estrito). Os bytes podem passar por TURN durante a sessão; não ficam como alojamento de ficheiros no NotesQR.
O que é ICE?
Interactive Connectivity Establishment: o processo de testar caminhos de rede candidatos (direto, STUN, TURN) até os peers ligarem ou falharem.
O que é uma room?
Uma sessão de partilha de curta duração identificada por um URL como https://notesqr.com/abc-defg-hij. Os convidados entram enquanto o host permanece online.
O que é um DataChannel?
O canal WebRTC que transporta os chunks binários do ficheiro entre peers depois da ligação estar pronta.
O que é a CLI?
Interface de linha de comandos: ferramentas notesqr-share (send / recv) para alojar ou descarregar num terminal sem a UI completa do browser.
O que é MCP?
Model Context Protocol: forma de agentes de IA e IDEs chamarem ferramentas. O NotesQR expõe notesqr_p2p_send e notesqr_p2p_recv via notesqr-mcp.
Para que serve o código QR aqui?
Codifica de forma scannable o URL da room para um telemóvel entrar depressa na mesma room P2P.
O que é Fechar após transferir / --once?
Modo em que a room fecha depois de cada ficheiro partilhado ter sido transferido pelo menos uma vez (incluindo cada ficheiro dentro de pastas). A mesma ideia do CLI --once.
O que é um caminho relativo à partilha?
O caminho que os peers veem na room (ex. projeto/src/app.ts), nunca o caminho absoluto do disco (ex. /home/voce/...).
Quem é o host / remetente?
O peer que cria a room e oferece ficheiros. Deve permanecer online até os downloads terminarem.
Quem é o guest / destinatário?
Quem abre o URL da room ou corre notesqr recv e descarrega enquanto o host ainda está online.
Ver também
Páginas profundas para pesquisa e agentes. Fora do menu principal de propósito para manter a UI do produto limpa.
