https://github.com/binbash23/p
p - The password manager by Jens Heine <binbash@gmx.net>
https://github.com/binbash23/p
cloud cryptography dropbox encryption manager password password-manager password-store pbkdf2 python secure
Last synced: 7 months ago
JSON representation
p - The password manager by Jens Heine <binbash@gmx.net>
- Host: GitHub
- URL: https://github.com/binbash23/p
- Owner: binbash23
- License: mit
- Created: 2022-12-26T20:14:09.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-01-23T21:04:07.000Z (9 months ago)
- Last Synced: 2025-01-23T22:19:04.273Z (9 months ago)
- Topics: cloud, cryptography, dropbox, encryption, manager, password, password-manager, password-store, pbkdf2, python, secure
- Language: Python
- Homepage:
- Size: 582 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# [p]
# The Password database
__2022 written by Jens Heine __
If you are paranoid when it comes to passwords and privacy you may want
to have a password safe for your accounts. Then you do not trust all the
password safes that exist and you write the password safe by yourself.
This is what I do here. The code is short, simple and I did NOT invent
a new proprietary encryption function. I use open source cryptography
which has been tested and which is hopefully bugfree :)
For the people who want to know, I use then PBKDF2HMAC algorithm for the symetric encryption.
Beware: This tool is close to the system and therefore a kind of a hackerz choice. I consciously wrote the program so that you have full control over the database and the system (i.e. the "sql" command).
Keep coding,
Jens
### Use the wiki
Use the [wiki](https://github.com/binbash23/p/wiki) for more help. The wiki contains some best practices and HOWTO's for using the password tool. The [help command documentation](https://github.com/binbash23/p/wiki/Full-help-documentation) is very useful.
### Binaries/executeable program:
You can use the [python code](https://github.com/binbash23/p/tree/master/source) or the binaries. For some more infos howto install, you can have a look here: [Install p on linux](https://github.com/binbash23/p/wiki/Install-p-on-a-linux-system-(best-practice)) and here: [Install p on windows](https://github.com/binbash23/p/wiki/Install-p-on-windows)
For Linux (x86), use the 'p' executeable:
[p/dist/linux/p](https://github.com/binbash23/p/raw/master/dist/linux/p)
For Raspberry Pi's (arm), use the 'p' executeable:
[p/dist/arm64/p](https://github.com/binbash23/p/raw/master/dist/arm64/p)
and for Windows (x86), use the 'p.exe' executeable:
[p/dist/windows/p.exe](https://github.com/binbash23/p/raw/master/dist/windows/p.exe)
### How do I start?
Start the windows binary (p.exe) and a cmd window will appear. Enter the password for your new [password database](https://github.com/binbash23/p/blob/master/docs/20240316_p_database_file.png) and thats all. You are ready to add new accounts into your encrypted database.
```
Using Database: p.db
Database does not exist.
Enter password for new database :
Confirm password for new database :
Creating new p database: "p.db" ...
Creating new UUID for database: 6ed88bba-a210-4150-8e10-76f57b347770
Shell mode enabled. Use 'quit' or strg-c to quit or help for more infos.
DB: p.db> add
Add account
UUID : 8d3a4c15-4780-459c-a3f5-ba1586c043df
Name : New Account
URL : www.new.de
Loginname : horst
Password : meinpw
Type : Webaccount
Correct ([y]/n) :
New account added.
DB: p.db> list
Searching for ** in 1 accounts:
ID : 8d3a4c15-4780-459c-a3f5-ba1586c043df
Name : New Account
URL : www.new.de
Loginname : horst
Password : meinpw
Type : Webaccount
Found 1 result(s).
DB: p.db>
```
You should also take a look at the [wiki](https://github.com/binbash23/p/wiki)
### Cloud integration
Who wants to have a master database copy in the cloud can also do this by using my dropbox feature. First you have to enable your dropbox for an API connection. Then you can alway upload/sync your database with the copy in your personal dropbox account.
The procedure to enable dropbox is f&%$%&ing stupid complicated. So I wrote a help text for this [here](https://github.com/binbash23/p/blob/master/docs/howto_dropbox_configuration.txt).
By the way: [your master password for the p database NEVER leaves your computer nor will it be typed in a web form or something like that](https://github.com/binbash23/p/blob/master/docs/20221230_p_architecture.png). The "cloud integration" that I implemented is simply moving the full encrypted p database into your dropbox account. Dropbox will never see your p master password.
Anyway I coded more targets to merge to. You can also use a WEBDAV or SSH target. Simply add an account with the credentials into the database and then you can use it as a merge target.
### Merging different password databases
Usually you have different copies of your p database. One on your desktop computer, another on the laptop... To synchronize them, there is a merge feature to do this for you. By now it is possible to merge to different targets like Dropbox, WEBDAV and SSH and for sure to an ordinary file on the same host that you are working on.
### SQLite database
I use the sqlite database to store the accounts (after I encrypt them). This is nice because you can use any [sqlite browser](https://sqlitebrowser.org/dl/) to open the database and do whatever you want: use sql, import export stuff, do bulk changes...
Just decrypt all accounts before opening the database with the sqlite browser by setting an empty password and you then have a cleartext password database to browse through.
Just make sure to encrypt the account after this by changing the password again to a non empty string.
### Copy&Paste with Ubuntu
To use the copy function in p (to copy passwords to the clipboard) you need to install python3-pyperclip and xclip.
```
sudo apt-get install python3-pyperclip xclip
```
### Help
For help just type [help](https://github.com/binbash23/p/wiki/Full-help-documentation#help) in the pshell or start p.exe like
```
p.exe -h
```