https://github.com/anonymbyte-404/pass-shield

PassShield is a secure password manager that allows users to store, retrieve, and manage passwords locally. It features AES-256 encryption for data protection, password generation, and a command-line interface for easy access. Built with Ruby, PassShield is stable and ready for use.
https://github.com/anonymbyte-404/pass-shield

aes-256-encryption command-line-interface data-protection encryption local-storage open-source password-generation password-management ruby security

Last synced: over 1 year ago
JSON representation

PassShield is a secure password manager that allows users to store, retrieve, and manage passwords locally. It features AES-256 encryption for data protection, password generation, and a command-line interface for easy access. Built with Ruby, PassShield is stable and ready for use.

• Host: GitHub
• URL: https://github.com/anonymbyte-404/pass-shield
• Owner: anonymByte-404
• License: mit
• Created: 2025-03-22T22:07:06.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-23T03:44:18.000Z (over 1 year ago)
• Last Synced: 2025-03-23T04:26:18.992Z (over 1 year ago)
• Topics: aes-256-encryption, command-line-interface, data-protection, encryption, local-storage, open-source, password-generation, password-management, ruby, security
• Language: Ruby
• Homepage:
• Size: 8.79 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
PassShield


PassShield is a secure password manager that allows you to store, retrieve, and manage your passwords safely on your local machine. It uses strong encryption methods to protect your sensitive data.


Features



    


Secure Password Storage: Encrypts passwords using AES-256 encryption.

    


Master Password Protection: Uses a master password to secure access to your stored passwords.

    


Local Storage: All data is stored locally in a secure directory, ensuring that only you have access to your passwords.

    


Add, Retrieve, and Remove Passwords: Easily manage your passwords with simple commands.



Requirements



    
Ruby 3.1 or higher

    
Required gems:

        


            
bcrypt

            
openssl

            
thor

        

    



Installation



    


Clone the Repository:

        
git clone https://github.com/anonymByte-404/pass-shield.git

cd pass-shield

    

    


Install Required Gems:

        
You can install the required gems using either of the following methods:

        
Option 1: Install Using Bundler

        
First, ensure you have Bundler installed:

        
gem install bundler

        
Then, run:

        
bundle install

        
Option 2: Install Individually

        
Alternatively, you can install the required gems individually:

        
gem install bcrypt openssl thor

    

    


Setup Local Storage:

        
The application will create a local directory for storing your passwords when it runs for the first time:

        
ruby ./bin/pass_shield

    



Usage


Adding a Password

To add a new password, use the following command:

./bin/pass_shield add <service> <username>

You will be prompted to enter your master password and the password you want to store.


Retrieving a Password

To retrieve a stored password, use the command:

./bin/pass_shield get <service>

You will need to enter your master password to access the password.


Removing a Password

To remove a stored password, use the command:

./bin/pass_shield remove <service>

You will be prompted to enter your master password for confirmation.


Security

All passwords are encrypted using AES-256 encryption, ensuring that your data is protected. The master password is required to access your stored passwords, and it should be kept confidential.


Contribution

Contributions are welcome! If you have suggestions for improvements or new features, feel free to create a pull request or open an issue.


License

This project is licensed under the MIT License. See the LICENSE file for details.