Skip to main content

A universal password manager interface, powered by Rofi

Project description

This project was heavily inspired by and builds on top of the ideas in bitwarden-rofi. Be sure to check it out!

Jimpass (alpha) - The unified password management interface

Build Status PyPI version

Jimsort, but for passwords.

demo



A backend-agnostic credential launcher/manager. Powered by Rofi.


There is no doubt password managers make security online better and easier, yet their use involves a lot of moving, searching and clicking. This is tedious at best, and depending on the context, they'll require additional software just to do some good old copy/pasting. In my experience it's really hard to convince someone to switch from their universal 8 year old muscle-memory-typed password, over to installing 2 apps and a browser extension which require a different search and click choreography to get similar results.

The people behind bitwarden-rofi nailed it by bridging this UX gap for Bitwarden users. But, what if I don't use Bitwarden, or even worse, what if I need to use multiple managers? That's where Jim comes into play.

Features

  • Auto-type: For those too busy to paste the selected password, fill-in username/passwords automatically.

    :warning: Introducing Danger mode: end by typing in <Return> automatically :warning:

  • TOTP support: Copy the TOTP of the selected entry to your clipboard

  • Sync: Force the local databases to sync up with the remote backend

  • Custom keybindings: Define your own keybindings for different actions supported at runtime

  • Custom item display: Choose how and what is displayed in Rofi for each password manager using {}. Eg. "Work(lastpass): {name} -- {username} ({email})"

  • Lock timeout(bitwarden only): Set a timer before having to re-enter your Master Password. Can be disabled.

  • Clipboard timeout: Set a timeout after which the keyboard is cleared

Supported Managers

The architecture allows anyone to extend Jim to use their password manager, provided there's a CLI for it. See the currently implemented ones

Dependencies

Jim communicates with each password manager through specific CLIs. Only install and configure those you use.

Installation

Using pip:

pip install Jimpass

Locally:

git clone https://github.com/remyrd/jimpass
cd jimpass
pip install .
# or
python setup.py install

Usage

In order to use Jimpass efficiently, bind the jp or jimpass command to a key combination of your choice. The command comes with these options, which will override their counterpart in the configuration

Usage: <jp|jimpass> [OPTIONS]

  CLI Entrypoint

Options:
  -c, --config FILENAME           Path to the config file. Defaults to
                                  $HOME/.jimpass.yaml or
                                  $XDG_CONFIG_HOME/jimpass/config.yaml
  --auto-lock                     Incompatible with --no-auto-lock
  --no-auto-lock                  Incompatible with --auto-lock
  --lock-timer INTEGER RANGE      Lock the database after RANGE seconds,
                                  ignored if --no-auto-lock
  --clipboard-timeout INTEGER RANGE
                                  RANGE seconds before clearing up the
                                  clipboard after copying
  --copy-command [xclip|xset|wayland]
                                  Utility to use when copying
  --danger-mode                   Automatically press Return after auto-type
  --help                          Show this message and exit.

Configuration

Jimpass requires at least a minimal configuration. This is due to the fact it wishes to load only the backend modules it needs. Configuration files can be specified through the CLI, or by placing them under $HOME/.jimpass.yaml or $XDG_CONFIG_HOME/jimpass/config.yaml

Minimal for Bitwarden users

managers:
  - bitwarden
bitwarden:
  template_str: 'bw: {name}: user {username}'

Minimal for Lastpass users

managers:
  - lastpass
lastpass:
  username: 'example@mail.box'
  template_str: 'lp: {name}: {username} at {url}'

Complete with defaults

managers: # REQUIRED. List all password managers to be loaded
  - bitwarden
  - lastpass
auto_lock: True
lock_timer: 500 # Ignored if auto_lock: False
clipboard_timeout: 5
copy_command: xclip # Command to use when copying [xclip|xsel|wayland]
danger_mode: False # After auto-typing a password, immediately presses Return
keybindings:
  # pressing Return copies the password under the selected entry.
  type_all: 'alt+1'
  type_user: 'alt+2'
  type_pass: 'alt+3'
  copy_totp: 'alt+t'
  sync: 'alt+r'
bitwarden:
  template_str: 'bw: {name}: user {username}'
  # available templated params include:
  # - id
  # - name
  # - username
lastpass:
  username: 'example@mail.box'
  template_str: 'lp: {name}: {username} at {url}'
  # available templated params include:
  # - id
  # - fullname
  # - name
  # - username
  # - url
  # - group
  # - note
  # - last_modified
  # - last_touch

Roadmap

  • Customizable keybindings --- For actions such as copy_username, type_password, etc
  • Templated item display --- Choose how Rofi displays items. Eg "Bitwarden: {name} {username}"
  • Better testing and CI
  • Context based management --- Manage more credential aspects.
  • Encrypted in-memory storage -- Will allow to add other features such as caching of frequently and last used for even faster launches.

Extending

Instructions on how to integrate your own password manager coming soon... In the meantime you can get inspired by the current implementations

License

Released under the GNU General Public License, version 3. See LICENSE file.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Jimpass-0.0.4.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

Jimpass-0.0.4-py2.py3-none-any.whl (26.2 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file Jimpass-0.0.4.tar.gz.

File metadata

  • Download URL: Jimpass-0.0.4.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.7.1

File hashes

Hashes for Jimpass-0.0.4.tar.gz
Algorithm Hash digest
SHA256 6f71257f961a60528d4697df828767281f8896e967712b90b0bbb50fbdff39f9
MD5 4e1d9d7cd5ff74c23be13ed06fe76723
BLAKE2b-256 26dcd6688fb85c4d4ed0ceddea4fc5181a541443b08e342d137af15a3c38cc87

See more details on using hashes here.

File details

Details for the file Jimpass-0.0.4-py2.py3-none-any.whl.

File metadata

  • Download URL: Jimpass-0.0.4-py2.py3-none-any.whl
  • Upload date:
  • Size: 26.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.6.7

File hashes

Hashes for Jimpass-0.0.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 cc6cf989074aa036b3206aa7f9fceac0bba989ac39801ec24f1742b27fea66af
MD5 22fc7c98558a5faa7ba23e4c16ba0d67
BLAKE2b-256 14cd1f3a17dbb113e06cec6c069ba8239c88ad60a6561ae5a8a6396be677e66d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page