{"id":13721848,"url":"https://github.com/pbkhrv/ulauncher-keepassxc","last_synced_at":"2025-05-07T14:30:48.294Z","repository":{"id":35524801,"uuid":"212235663","full_name":"pbkhrv/ulauncher-keepassxc","owner":"pbkhrv","description":"Ulauncher extension to quickly search a KeePassXC password manager database","archived":false,"fork":false,"pushed_at":"2023-07-21T04:21:39.000Z","size":123,"stargazers_count":19,"open_issues_count":18,"forks_count":15,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-14T11:39:41.521Z","etag":null,"topics":["keepassxc","ulauncher","ulauncher-extension","ulauncher-extensions"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pbkhrv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-02T01:54:09.000Z","updated_at":"2024-07-18T19:46:01.000Z","dependencies_parsed_at":"2024-11-14T11:32:20.471Z","dependency_job_id":"4eb34657-c427-4da7-a7b8-15a10cd4f340","html_url":"https://github.com/pbkhrv/ulauncher-keepassxc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pbkhrv%2Fulauncher-keepassxc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pbkhrv%2Fulauncher-keepassxc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pbkhrv%2Fulauncher-keepassxc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pbkhrv%2Fulauncher-keepassxc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pbkhrv","download_url":"https://codeload.github.com/pbkhrv/ulauncher-keepassxc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252895496,"owners_count":21821171,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["keepassxc","ulauncher","ulauncher-extension","ulauncher-extensions"],"created_at":"2024-08-03T01:01:22.119Z","updated_at":"2025-05-07T14:30:47.862Z","avatar_url":"https://github.com/pbkhrv.png","language":"Python","funding_links":[],"categories":["Clients"],"sub_categories":["Other clients"],"readme":"# ulauncher-keepassxc\n\nA [Ulauncher](https://ulauncher.io/) extension to search your [KeePassXC](https://keepassxc.org/) password manager database and copy passwords to the clipboard.\n\n## Features\n\n- Quickly search through the database entries by name, and copy passwords/usernames/URLs to the clipboard\n- Work with any file (.kdbx etc) that can be accessed by the KeePassXC itself via the `keepassxc-cli` command line tool\n- Support files locked with a passphrase. The extension asks for the passphrase and stores it in memory for a configurable amount of time\n- Doesn't require the KeePassXC app to be running\n\n## Requirements\n\n- Install a recent version of [KeePassXC](https://keepassxc.org/download/) (tested with 2.4.3, 2.5.0 and 2.6.6)\n- Make sure you can execute `keepassxc-cli` in a terminal without errors\n\n## Installation\n\nOpen Ulauncher preferences window -\u003e Extensions -\u003e \"Add extension\" and paste the following url:\n\n```\nhttps://github.com/pbkhrv/ulauncher-keepassxc\n```\n\n## Configuration\n\n- `Password database location`: path to the password database file that you want to access through Ulauncher. *This is the only preference that you need to set before you can use the extension.*\n\n- `Inactivity lock timeout`: forces you to re-enter the passphrase after you haven't used the extension for a while. By default it's set to 600 seconds (10 minutes). If you'd rather not re-enter it, you can set the value to 0, but that's probably not a great idea. NOTE: The cached passphrase is only stored in memory, so you'll need to re-enter it if you reboot your computer or restart Ulauncher.\n\n## Usage\n\nOpen Ulauncher and type in \"kp \" to start the extension. If your password database is locked with a passphrase, it'll ask you to enter it:\n\n![Unlock Database](images/screenshots/unlock-database.png)\n\nOnce unlocked, search the database for Github logins:\n\n![Search](images/screenshots/search1.png)\n\nLook at the `Github work` entry:\n\n![Entry details](images/screenshots/details1.png)\n\n## Troubleshooting\n\n### Why doesn't the passphrase window come to the foreground when it's asking me to unlock the database?\n\nPlease install [wmctrl](http://tripie.sweb.cz/utils/wmctrl/) - it's a utility that ulauncher-keepassxc calls to \"activate\" the passphrase window and bring it to the top:\n\n**Ubuntu and Debian**\n\n```shell\nsudo apt-get install wmctrl\n```\n\n## Development\n\nI use the following tools while working on this extension:\n\n- [`Black`](https://github.com/psf/black) code formatter\n- `pytest`\n- `pylint` with the `flake8` plugin\n- `mypy` static type checker\n\nYou can install them in one shot (except for `Black` - that's up to you) by running:\n\n```shell\npip install -r scripts/requirements.txt\n```\n\nCheck PEP8 compliance, perform static type analysis and run unit tests:\n\n```shell\nmake test\n```\n\nBackup the \"production\" version of the extension and symlink the development version into Ulauncher's extension directory:\n\n```shell\nmake symlink\n```\n\nQuit Ulauncher. Then run it in debug mode:\n\n```shell\nmake run_ul\n```\n\nRun extension in the terminal, connect it to Ulauncher in debug mode:\n\n```shell\nmake run\n```\n\n(if that doesn't work, check the connection string URL printed out by Ulauncher and modify the Makefile accordingly.)\n\nUnlink the development version of the extension from Ulauncher and replace it with whatever was there before:\n\n```shell\nmake unlink\n```\n\n## Contributions\n\nIssues and pull requests are welcome!\n\n\n## Inspiration and thanks\n\nI loved Alfred on MacOS, and now I love Ulauncher on Linux. The Python API is a joy to work with.\n\nThanks to [pass-ulauncher](https://github.com/yannishuber/pass-ulauncher) for the overall structure and for teaching me a few things about the API. I aaaalmost switched away from KeePassXC to [pass: the standard unix password manager](https://www.passwordstore.org/) because of it.\n\n[The Noun Project](https://thenounproject.com/) for the icons - there's nothing else quite like it.\n\nFinally, thanks to [KeePassXC](https://keepassxc.org/) on Linux and [KyPass](https://www.kyuran.be/software/kypass/) on iOS.\n\n## License\n\nMIT license. See [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpbkhrv%2Fulauncher-keepassxc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpbkhrv%2Fulauncher-keepassxc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpbkhrv%2Fulauncher-keepassxc/lists"}