nympass: A Shell repository from naingyeminn

#NYMPASS

NYMPASS is a shell script that allows you to save your passwords in encrypted file and get the password back to clipboard. Clipboard will be clear after defined interval.

##Features

Password will be encrypted using the MAC address (Network Card's Hardware Address) of your System.
Encrypted password will be stored in encrypted File using a Passphrase.
When user decrypted the password, it will be set into the clipboard.
Clipboard will keep the password for only 5 seconds (Default).
Encrypted password files cannot be decrypted on other Systems without the right MAC address.
Macbook users can use Thunderbolt Ethernet Adapter as a Key to decrypt password files.

##Purposes

User needs to remember only one password (Master) for certain encrypted password files.
User can simply paste the passwords without typing long and complex passwords whenever login to specific account.
Password file will be decrypted only on script run.

##Installation

Download NYMPASS zip file.

$ wget https://github.com/naingyeminn/nympass/archive/master.zip -O nympass.zip

Extract nympass.zip file.

$ unzip nympass.zip

Change into the extracted directory in Terminal.

$ cd nympass-master

Open nympass file with Text Editor.
Set passpath value in Line 5 if you want to save the password files in specific location. e.g. passpath='/home/username/passdir/'
Replace passkey value in Line 10 with your Ethernet Interface Name such as eth0 or eth1 or en0 or en1.

Recommend to use the Interface Name of Thunderbolt Ethernet Adapter for a Macbook User.

Set timeout duration in Line 12. (Default is 5 Seconds)
Run "make" command as root:

$ sudo make

Mac OS X user should download the zip file directly from Browser if wget is not installed.

##Uninstall

Change into nympass directory in Terminal.
Run Following Command.

$ sudo make uninstall

##Usage ###Create Password File

$ nympass create
Name Pass : facebook [Password File Name]
Account ID : facebook_user@gmail.com [Account ID or Email]
Enter Passphrase : [Account Password]
enter aes-256-cbc encryption password: [Master Password]
Verifying - enter aes-256-cbc encryption password: [Master Password]

Password file will be created in current directory. User can define Default file path in Script's Line number 5.

####Create in Default Directory

User can use -d option to create password file in Default directory.

$ nympass create -d

####Create in Default Directory with auto generated Password

User can use auto option to create password file in Default directory with auto generated password.

$ nympass create auto

Create in Specific Directory

User can specify password file path directly in command.

$ nympass create /home/user/Documents/MyPasswords

###Get Password

$ nympass get facebook
enter aes-256-cbc decryption password: [Master Password]
Account ID : facebook_user@gmail.com

$ nympass get /home/user/Documents/facebook

Password will be set in clipboard and cleaned up after 5 seconds. Timeout duration can be defined in Line 12.

###Change Master Password

$ nympass change
Enter Current Master Password : [Master Password]
Enter New Master Password : [New Password]
Verify New Master Password : [New Password Again]

Password files in Default file path will be changed the Master Password.

####Change Single Password File

User can change Master Password of a password file.

$ nympass change /home/user/Documents/MyPasswords/facebook

####Change Multiple Password Files in a Directory

User need to specify Directory Name of Password files.

$ nympass change /home/user/Documents/MyPasswords/

###List Password Files from Default Password Directory

$ nympass list

##License

	DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
		   Version 2, December 2004

Copyright (C) 2015 Naing Ye` Minn <naingyeminn@gmail.com>

Everyone is permitted to copy and distribute verbatim or modified 
copies of this license document, and changing it is allowed 
as long as the name is changed.

	DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

0. You just DO WHAT THE FUCK YOU WANT TO.