Skip to content

Koei32/keyholder

Repository files navigation

Keyholder

Keyholder is a fully local, terminal-based password storage and management tool written in Python.

Keyholder makes use of the cryptography package for encryption and uses rich to render beautiful tables and formatted text.

Features

I wrote this tool mostly for my personal use so its not the most feature loaded, but it is something. It supports securely adding, removing and viewing your stored passwords. The passwords are encrypted and then stored.
The tool uses a master password system to authenticate the user. If you forget the master password, you lose ALL your stored passwords.

Getting Started

You can find a build of Keyholder in the latest release. To run it just double click keyholder.exe.


To run Keyholder from source, follow these steps:

  1. Clone the repo

    git clone https://github.com/Koei32/keyholder
    cd keyholder
    
  2. Make a virtual environment and activate it

    python.exe -m venv venv
    venv\Scripts\activate
    
  3. Install the required modules

    pip install -r requirements.txt
    
  4. Run Keyholder

    keyholder.py
    

Commands

Here are some basic commands to get you started (you can type help to get the full list of commands):

new - Store a new password Running `new` asks you the title to give to the password, the password itself and optional notes.
list - Show a list of stored passwords Shows a list of the passwords stored in a table. This does not actually show the password in plaintext.
view - View a password in plaintext Running view ID displays the password with id ID in plaintext for a few seconds.

End

This project was made for submission to Hack Club's Summer of Making 2025 (link). Thanks for viewing! \o

About

A basic local password storage/management tool. (WIP)

Topics

Resources

Stars

Watchers

Forks

Contributors