Skip to main content

CLI integration for KeepassXC GUI.

Project description

keepassxc-cli-integration

CLI and Python integration for KeepassXC GUI.


CLI


  • kpx
    • base_settings:
      • --debug (Debug mode)
      • --env {{env}} (Env in format KEY=value. Can multiple entries. Supports KPX queries.)
    • commands:
      • get
        • login
          • {{url}} (Get login for the specified URL from open databases.)
        • password
          • {{url}} (Get password for the specified URL from open databases.)
        • --name (Specify the name of the entry in the database. Required if the URL has multiple entries.)
        • --bat (Escape output to use BAT.)
      • associate
        • add (Default. Create an association with the CURRENT ACTIVE database.)
        • delete
          • {{select}} (Default: "current". Delete the selected association. You can specify the association name as either "all" or "current".)
        • show (Show all saved associations.)
      • run
        • {{command}} (Run another program with query from KeePassXC.)

Python


The keepassxc_cli_integration.kpx module provides similar functions for use directly in Python.


Notes:

  • KeepassXC-GUI !!!MUST!!! have browser integration enabled.
  • The association is carried out only with the active (and not with all open) databases. In order to receive information from all open databases, you must first carry out an association with each of them.
  • Intended for Windows. May or may not work on Linux.
  • Due to limitations of KeepassXC-GUI, it is possible to retrieve records from databases only by URL. The URL field can be written in the database without http(s):\ and can also be specified without http(s):\ in CLI\Python to retrieve data.

Installation

  1. pip / pipx
pip (or pipx) install keepassxc-cli-integration
  1. git
git clone https://github.com/overgodofchaos/keepassxc_cli_integration.git
cd keepassxc-cli-integration
pip (or pipx) install .

Examples


The query in kpx run has the following format: @kpx::{{url}}::{{login or password}}::{{name(optional)}}@kpx

kpx run poetry publish --build --username=__token__ --password=@kpx::pypi.org::password::pypi_token@kpx

This is mostly for CMD, as there is no convenient way to get the result from third-party functions.

Can be used in scripts:

example.ps1

$VeraCrypt = "C:\Program Files\VeraCrypt\VeraCrypt.exe"
$password = kpx get passoword example-vault

& $VeraCrypt /volume "C:\example\vault.hc" /letter Y /password $password /b /q

example2.ps1

$VeraCrypt = "C:\Program Files\VeraCrypt\VeraCrypt.exe"

kpx run $VeraCrypt /volume "C:\example\vault.hc" /letter Y /password $(kpx get passoword example-vault) /b /q

exemple3.bat

set VeraCrypt="C:\Program Files\VeraCrypt\VeraCrypt.exe"

VeraCrypt /volume "C:\example\vault.hc" /letter Y /password '@kpx::example-vault::password@kpx' /b /q

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

keepassxc_cli_integration-1.4.1.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

keepassxc_cli_integration-1.4.1-py3-none-any.whl (25.6 kB view details)

Uploaded Python 3

File details

Details for the file keepassxc_cli_integration-1.4.1.tar.gz.

File metadata

  • Download URL: keepassxc_cli_integration-1.4.1.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.3.2 CPython/3.13.7 Windows/11

File hashes

Hashes for keepassxc_cli_integration-1.4.1.tar.gz
Algorithm Hash digest
SHA256 7ada84d5d89982621f6dc6124f85f0646699fb9356256801f251c7fc9e7f47ba
MD5 1c391dd6a5b2705a0b6dc69058333ff3
BLAKE2b-256 4dbb78d6481a39eabf0949ffece9511d1ba0e5c78d0624255094d15e4f157aaf

See more details on using hashes here.

File details

Details for the file keepassxc_cli_integration-1.4.1-py3-none-any.whl.

File metadata

File hashes

Hashes for keepassxc_cli_integration-1.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b9d17f9c4819e0f6a2c95a88d69b183fc5b1173db952137543fd1da24bced570
MD5 e7ea1863d6c5efb6b244a3eac55bd4ba
BLAKE2b-256 0dbd4c1c6ee312f243fe61b637c5a423897eeea6b9895b482ce2b80893920213

See more details on using hashes here.

Supported by

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