Klip

Gerenciador de senhas minimalista baseado em terminal.

Recursos · Instalação · Uso · Segurança

Recursos

• Operação totalmente offline.
• Criptografia segura usando Argon2id para derivação de chave e criptografia autenticada com libsodium.
• Gerador de senhas seguro.
• TUI personalizada construída sem bibliotecas externas.

Instalação

AppImage

Baixe o AppImage dos lançamentos e execute:

chmod +x klip-x86_64.appimage 
./klip-x86_64.appimage

Compilar a partir do código-fonte

Dependências:

• libsodium

Instalar:

git clone https://github.com/vid4l-07/Klip.git
cd klip
mkdir build
cd build
cmake ..
make
sudo make install

Uso

Global

Barra de Abas

Banco de Dados

Copiar para a área de transferência

Quando uma credencial é selecionada:

• Enter em Usuário copia o nome de usuário.
• Enter em Senha copia a senha.

Abrir arquivo

Quando você escolhe Abrir, um popup de texto aparece. Dentro do popup, você pode pressionar Tab para navegar pelos bancos de dados abertos recentemente.

Você pode inserir o caminho absoluto ou o caminho relativo para o banco de dados. Se o arquivo não existir, ele será criado se o caminho especificado for válido.

Os caminhos de arquivos recentes são armazenados em $HOME/.config/klip/recents.

Segurança

Toda a lógica de criptografia está localizada em src/Security.cpp

Derivação de chave

• Ao criar um banco de dados, uma senha mestre é solicitada.
• Uma chave criptográfica é derivada da senha e de um salt aleatório único usando crypto_pwhash da libsodium, baseada no Argon2id no modo INTERACTIVE (parâmetros de custo ajustáveis contra ataques de força bruta).

Criptografia

• O banco de dados é criptografado usando crypto_secretbox_easy com a chave derivada e um nonce aleatório.
• Este algoritmo fornece detecção de adulteração através de um MAC.

Formato de armazenamento

• O arquivo criptografado é armazenado em binário com o seguinte formato:

[salt][nonce][ciphertext]

Processo de descriptografia

• A chave é derivada usando a senha fornecida pelo usuário e o salt armazenado.
• Os dados são descriptografados usando crypto_secretbox_open_easy.
• Se a senha estiver incorreta ou o arquivo tiver sido modificado, a verificação do MAC falha e a operação é rejeitada.

Contribuições

Contribuições são sempre bem-vindas. Se você encontrar um bug ou quiser ajudar com novas funcionalidades, você pode:

• Abrir uma issue no repositório.
• Abrir um pull request.
• Enviar um e-mail para [email protected]

Ideia de contribuição

Preciso de ajuda com a detecção das teclas de seta:

No momento, as teclas normais são detectadas corretamente, mas as teclas de seta são sempre interpretadas como um único pressionamento da tecla ESC em vez da sequência de escape completa.

Se você tem experiência com entrada de terminal (termios, sequências de escape ANSI, etc.), eu realmente apreciaria sua ajuda.

A lógica para ler pressionamentos de tecla está localizada em src/term/term.cpp, especialmente na função read_char e é usada pela classe App na função start localizada em src/ui/app/app.cpp.

Se você gostaria de contribuir, por favor, tente manter as alterações limitadas à função read_char ou à classe Terminal, para que o restante do projeto não precise ser modificado.