From c31d54f733eb6075e69fea67289f66eceb5635a7 Mon Sep 17 00:00:00 2001 From: Malfurious Date: Mon, 13 Jul 2020 02:35:20 -0400 Subject: Update README File is reformatted for readability and slightly tweaked for accuracy. The installation section is rewritten to describe the new process via CMake. --- README.md | 30 +++++++++++++++++++----------- 1 file changed, 19 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index b56dc13..d061251 100644 --- a/README.md +++ b/README.md @@ -1,19 +1,27 @@ # ComPASS ## A command-line password manager -Compass is a cross-platform command-line utility for performing secure, offline password management. Compass stores all of your logins for websites, remote systems, other apps, etc. in a local file which is encrypted with AES256-bit cypher-blockchaining encryption algorithm. Keychains are base64 encoded and are, therefore, an ASCII file, making it easier to move this file around if need be. - -Compass will generate long, random passwords for you to keep your accounts safer! If you encounter services imposing harmful password rules, such as: 'small' maximum password length, disallowed special chars, etc, you can set options for Compass to customize how random strings are generated. - -If you like to routinely change your passwords, you can mark credentials in your keychain for reset, reminding you to go and update them on the respective website or whatever. This flag is cleared for you when Compass alters the saved password. +Compass is a cross-platform command-line utility for performing private, offline +password management. Compass stores all of your logins for websites, remote +systems, other apps, etc. in a local file which is encrypted with AES256-bit +cypher-blockchaining encryption algorithm. Keychains are base64 encoded and are, +therefore, an ASCII file, making it easier to move this file around if need be. + +Compass will generate long, random passwords for you to keep your accounts safer! +If you encounter services imposing harmful password rules, such as: 'small' +maximum password length, disallowed special chars, etc, you can set options for +Compass to customize how random strings are generated. + +If you like to routinely change your passwords, you can mark credentials in your +keychain for reset, reminding you to go and update them on the respective +website or whatever. This flag is cleared for you when Compass alters the saved +password. For more help, type `compass help` after installation. -Please note, Compass is still early in development (still in ALPHA)! - ## Installation -Build Compass with `g++ *.cpp cryptopp562/*.cpp -o compass -lpthread`. Then move the binary to somewhere in your $PATH. - -If building on Windows, you might want to name the binary 'compass.exe' and link winsocks instead of pthreads. A good place to install the binary to is C:\windows\system32 +Build Compass with CMake. If using a makefile, `make install` will do what you +expect. Otherwise, use the appropriate tool associated with your generator. -If building on Linux, I recommend you install xclip as a dependancy. This program helps with sending passwords to your clipboard. +If building on Linux, I recommend you install xclip as a dependancy. This +program helps with sending passwords to your clipboard. -- cgit v1.2.3