Skip to content
/ Keasy Public

GUIなのにCLIなパスワードマネージャー

License

MIT license
1 star 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

v2okimochi/Keasy

BranchesTags

Repository files navigation

Keasy - Password Manager

Keasy is open source GUI password manager. You can use it only by command which CLI-like. This is Beta version.

Adding support for OS X (Mac) at Keasy 2.0!
However, it's incomplete that it run on console only and cannot work correctly hiding/showing app into task tray.

What is convenience of Keasy?

Keasy can realize CLI-like operation speed on GUI application.

Even if you are using Windows, you don't have to use mouse when operate password manager.

For example, if you want to login to website, first focused at your password manager by mouse, then copied our username and password from your password manager, then focused website by mouse, finally pasted these on website.

But Keasy can operated by only keyboard.

First you hide Keasy into task tray by Ctrl+Ctrl, and open website. Then open Keasy by Ctrl+Ctrl and find account. hide Keasy to focus website, finally paste username and password by Shift+Shift.

You only use mouse when open website or focus input-form.

Structure

GUI: PyQt5
Database: SQLite3

Keasy uses 6 data at Database. For example case of GitHub account...

  • service-name: GitHub
  • search-word: microsoft
  • login-url: https://github.com
  • user-name: sh141
  • password: my-password
  • remarks: this is GitHub account.

Keasy encrypts DB file(keasy.db) of SQLite3 to "encrypted.keasy" with AES password.

Keasy use DB after decrypt "encrypted.keasy" and save to same file.
And Keasy delete "keasy.db" before quit itself.

"encrypted.keasy" is only open by your master password.

Run / Download

Use with Python3

You should run Keasy.py to use Keasy on Python3.
For example if you use python3.6...

# python3.6 Keasy.py

You have to install libraries used by Keasy into your python3.

And, you should choose script on WindowController.py whether you are using Windows or OS X (Mac).

For example, if you are using Windows, please choose script at upper on following. If you are using OS X, please choose script at under.

def controlWindow(gui):
    # =================================
    # Windowsの場合
    # =================================
    from WinWindow import ControlWindowForWindows
    windowController = ControlWindowForWindows(gui)
    # =================================
    # Macの場合
    # =================================
    # from MacWindow import ControlWindowForMac
    # windowController = ControlWindowForMac(gui)
    return windowController

Download application

You can download latest exe file from following link.
I checked the operation only on Windows10 x86-64.

Keasy version2.1 ( 26MB )

Keasy version2.0 ( 36MB ) <= Limited support for Mac with Python3 console only

Keasy version1.13 ( 37MB ) <= Windows only

Build Keasy yourself for Windows

You can build Keasy to .exe file yourself with PyInstaller. Keasy.exe of Above link is also built by PyInstaller.

If you will build it at your working directory "Keasy", you should use PyInstaller with spec file.

For example, if you are using Windows, please run following command by your PowerShell:

> pyinstaller .\Keasy.spec

This is spec file example (on Windows). Please change path according to your working directory.

# -*- mode: python -*-

block_cipher = None


a = Analysis(['Keasy.py'],
             pathex=['C:\\Windows\\WinSxS\\amd64_avg.vc140.crt_f92d94485545da78_14.0.24210.0_none_69fa0197d9b096ae\\', '[absolute path to your working directory]\\Keasy'],
             binaries=[],
             datas=[],
             hiddenimports=['comtypes.gen._944DE083_8FB8_45CF_BCB7_C477ACB2F897_0_1_0', 'comtypes.gen.UIAutomationClient'],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher)
a.datas += [('icon.png', '[absolute path to your working directory]\Keasy\icon.png', 'DATA')]
pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)
exe = EXE(pyz,
          a.scripts,
          a.binaries,
          a.zipfiles,
          a.datas,
          name='Keasy',
          debug=False,
          strip=False,
          upx=True,
          runtime_tmpdir=None,
          console=False , icon='icon.ico')

If you are using Keasy1.13, you should change path to use icon.

- a.datas += [('icon.png', '[absolute path to your working directory]\Keasy\icon.png', 'DATA')]
+ a.datas += [('icon.ico', '[absolute path to your working directory]\Keasy\icon.ico', 'DATA')]

Usage

Demo -> Qiita - sh141:"GUIなのにCLIなパスワードマネージャを作った"

Console-commands

exit

Quit Keasy.

find [input-text]

Search service-name by input-text and display their.

If you have registered search-word, and it includes input-text, Keasy bring service-name which has this search-word.

At this time, If Keasy brought up only one service-name, Keasy show you account(user-ID/Mail, password, remarks) service-name has. For example...

$ find git

memorize [service-name] [user-ID/Mail]

Choose one account, then remember user-name and password temporary.
You can paste remembered datas by Shift -> Shift. Keasy do that "paste user-name"->"press tab key"->"paste password".

show

Keasy shows raw passwords which displayed.

hide

Keasy hides passwords which displayed. Passwords are changed to "*".

add

Add account.
You should enter "service-name", "search-word", "login-url", "user-name", "password", "remarks". But search-word, login-url and remarks are optional.

For example...
service-name: GitHub
search-word:
login-url: https://github.com
user-name: sh141
password: my-password
remarks:

edit [service-name] [user-ID/Mail] [choose-infomation]

Edit account information.
You can select "choose-information" from the following:

ServiceName
SearchWord
LoginURL
ID_or_Mail
PassWord
Remarks

For example...

$ edit GitHub sh141 PassWord

delete [service-name] (user-ID/Mail)

Delete service or account.
If you delete service, Keasy delete also accounts which this service has.
If you delete account which service-name has only one, Keasy delete also this service.
For 2 example...

$ delete GitHub
$ delete GitHub sh141

master

Change master-password.

Keyboard shortcuts

tab

Complement your command if input which like exist command on Keasy.

If database has some service-name or user-ID/Mail like your input, Keasy also complement these.

Keasy does not complement "exit" and "master" so you should input these fully.

shift + tab

Rollback state at current mode.
You can use it at add mode and edit mode.

ctrl -> ctrl

Hide Keasy into task tray, or open Keasy from task tray. You can always call Keasy because Keasy is monitoring your keyboard.

If you call Keasy when you are looking website, Keasy is getting URL of current webpage to search for user-name and password, then memorize these automatically(auto-memorize).

The auto-memorize works at Mozilla Firefox and Google Chrome now.

shift -> shift

Input user-name and password to website automatically.

Actually, Keasy do "ctrl+l (focus to address bar)"->"ctrl+c (copy URL)" using your keyboard.

ctrl + ( shift -> shift )

Input user-name or password to website automatically.
The difference from "shift -> shift" is that only input one data.

To switch data, you should use "ctrl+space".

ctrl + space

Switch data for input.

At first you can input user-name automatically.
If you want to input password, press "ctrl+(shift->shift)" then switch data for input from user-name to password.

It switches data to user-name or password every time press this hotkey.

You can distinguish visually which data can input because Keasy's icon in task tray is changing.

Can input UserID/Mail:

Can input Password:

Contribution

Pull requests and issues are very welcome.

I would like to make Keasy a convenience GUI password manager which able to run on multi platform with command line base.

Release note

version 2.x

  • 2.1
    Added feature that output DB data as CSV.

  • 2.0
    Added support for OS X. (limited that it can be run on console only)

version 1.x

  • 1.13
    Add new icon to distinguish UserID/Mail or Password which can input now at Single-auto-complete mode.

  • 1.12
    Fixed to reject editing userID/Mail when the new one will be same of exist userID/Mail in DB.

  • 1.11
    Fixed a fatal error that cannot input symbols at auto-input.

  • 1.10
    Fixed to auto-memorize username & password even if these are figure only.
    Fixed to show service-name when it was successed to auto-memorize.

  • 1.9
    Fixed fatal bug that it freezes when coming out from tray because it has resized after coming out.

  • 1.8
    Added function to create random password by tab key at edit-mode.

  • 1.7
    Added explanation for command "master".

  • 1.6
    Fixed that it still show mode "auth" after finish auth-mode.
    Fixed to clear console and show command-history at "show" and "hide".

  • 1.5
    Added version name on Title.
    Fixed to hide command-history( inputting master-password ) at auth-mode.
    At delete-mode and edit-mode, fixed to run Tab-complement also by only figure.
    At find-mode, fixed to show service-name, search-word, loginURL and command-history also by only figure.
    And fixed to clear displayed if not found accounts.

  • 1.4
    Added balloon messages for switching target of Auto-input-single.
    Fixed to keep window size before Keasy is hidden.

  • 1.3
    Fixed a looping that it is working during keep press ctrl/shift.

  • 1.2
    Fixed the fatal bug that looping auto-input.
    It because that press Shift key automatically in order to input uppercase.

  • 1.1
    Fixed Auto-Memorize by adding delay time.

  • 1.0
    Original.

About

GUIなのにCLIなパスワードマネージャー

Resources

Readme

License

MIT license
Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages