Skip to content

mateusreis/bookmark-notes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📝 Bookmark Notes - Chrome Extension

Uma extensão simples para salvar notas sobre sites que você visita. Funciona como um bloco de notas de bookmarks.

✨ Funcionalidades

  • Captura automática: Obtém título e URL do site atual
  • Notas personalizadas: Adicione descrições em texto sobre cada site
  • Menu de contexto: Clique com botão direito para salvar rapidamente
  • Armazenamento local: Todos os dados ficam salvos no seu navegador
  • Exportação: Baixe sua lista de sites como arquivo .txt
  • Interface limpa: UI moderna com ícones Font Awesome

🚀 Como Instalar

  1. Abra o Chrome e acesse chrome://extensions/

  2. Ative o Modo do desenvvedor (chave no canto superior direito)

  3. Clique em "Carregar sem compactação" (ou "Load unpacked")

  4. Selecione a pasta onde está a extensão:

    /var/www/html/<bookmark-notes>/
    
  5. O ícone 📝 aparecerá na barra de extensões do Chrome

📖 Como Usar

Método 1: Pelo Ícone da Extensão

  1. Navegue até qualquer site
  2. Clique no ícone 📝 Bookmark Notes na barra do Chrome
  3. O título e URL do site atual serão exibidos automaticamente
  4. Digite sua nota no campo de texto
  5. Clique em "Save Note"

Método 2: Menu de Contexto (Botão Direito)

  1. Em qualquer site, clique com o botão direito do mouse
  2. Selecione "Add to Bookmark Notes"
  3. O popup abrirá automaticamente
  4. Digite sua nota e clique em "Save Note"

Dica: Se você selecionar texto antes de clicar com botão direito, o texto selecionado será salvo como nota automaticamente!

Gerenciar Sites Salvos

No popup da extensão, você verá:

  • Lista de sites salvos com título, URL e notas
  • 🔗 Botão Visitar: Abre o site em uma nova aba
  • ❌ Botão Delete: Remove um site da lista
  • 📥 Export: Baixa todos os sites como arquivo .txt
  • 🗑️ Clear All: Limpa toda a lista de sites

📁 Estrutura de Arquivos

chrome-notes/
├── manifest.json      # Configuração da extensão
├── popup.html         # Interface do popup
├── popup.css          # Estilização
├── popup.js           # Lógica do popup
├── background.js      # Service worker (menu de contexto)
├── icons/             # Ícones da extensão
│   ├── icon16.svg
│   ├── icon48.svg
│   └── icon128.svg
└── README.md          # Este arquivo

🔧 Permissões

A extensão usa as seguintes permissões:

Permissão Finalidade
activeTab Ler título e URL da aba ativa
storage Salvar sites e notas localmente
contextMenus Criar opção no menu de contexto
notifications Mostrar notificações de confirmação

📤 Exportação

Ao clicar em Export, um arquivo .txt será baixado com:

=======================================================
           BOOKMARK NOTES - EXPORTED LIST
=======================================================

Exported: 3/28/2026, 11:00 PM
Total Sites: 2

-------------------------------------------------------

[1] Google
URL: https://www.google.com
NOTE: Meu mecanismo de busca favorito

-------------------------------------------------------

[2] GitHub
URL: https://github.com
NOTE: Repositório de código

-------------------------------------------------------

🛠️ Desenvolvimento

Recarregar a Extensão

Após fazer alterações no código:

  1. Vá para chrome://extensions/
  2. Clique no ícone de recarregar 🔄 na extensão

Debug

  • Abra o popup e pressione F12 para abrir o DevTools
  • Veja logs no Console do background.js em chrome://extensions/ → "Service Worker"

📝 Licença

Uso livre para fins pessoais e comerciais.

🐛 Problemas Comuns

O ícone não aparece?

  • Clique no ícone de quebra-cabeça 🧩 na barra do Chrome
  • Clique em "Site Notes" para fixar

O menu de contexto não aparece?

  • Recarregue a extensão em chrome://extensions/
  • Reinicie o Chrome se necessário

As notas não salvam?

  • Verifique se o armazenamento local não está cheio
  • Limpe o cache da extensão e tente novamente

Feito com ❤️ para organizar seus bookmarks!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors