0
0
mirror of https://github.com/keepassxreboot/keepassxc.git synced 2024-09-20 20:23:05 +02:00
KeePassXC is a cross-platform community-driven port of the Windows application “Keepass Password Safe”.
Go to file
2017-03-16 10:09:50 -04:00
.github Add -DWITH_ASAN=ON requirement to pull request template 2017-03-15 15:23:47 +01:00
.tx Moved transifex to new url 2016-11-11 16:30:57 -05:00
cmake Mark CMake library variables as advanced 2017-02-26 18:39:03 +01:00
share Merge branch 'master' into develop 2017-03-02 22:53:25 +01:00
snap/gui Updated snapcraft build to include networking 2017-02-20 14:16:04 +01:00
src Change cli commands description. 2017-03-16 10:09:50 -04:00
tests Merge branch 'develop' into feature/yubikey 2017-03-10 18:01:14 +01:00
utils Migrate entropy-meter to keepassxc-cli 2017-03-16 10:09:50 -04:00
.gitattributes Add github-linguist language hints. 2017-02-15 16:36:02 -05:00
.gitignore Add release folder, CLion and KDevelop project files 2017-02-16 21:25:04 -05:00
.travis.yml Enable ASAN option in Travis build 2017-03-15 15:23:52 +01:00
AppImage-Recipe.sh Unset XDG_DATA_DIRS before launching app, resolves #194, reverts #273 2017-02-10 01:55:09 +01:00
CHANGELOG Bump version to 2.1.3, update CHANGELOG 2017-03-02 21:56:22 +01:00
CMakeLists.txt Install path on Mac. 2017-03-16 10:09:50 -04:00
COPYING Update KMessageWidget files in COPYING also [skip ci] 2017-02-10 02:50:46 +01:00
Dockerfile Install Qt 5.8 inside Docker container 2017-02-06 21:13:24 +01:00
INSTALL.md Updated INSTALL documentation. (#140) 2017-01-04 18:47:29 -05:00
LICENSE.BOOST-1.0 Display git revision in about dialog. 2015-07-18 13:14:13 +02:00
LICENSE.BSD Add crypto classes and tests. Link to libgcrypt. 2010-09-11 19:49:30 +02:00
LICENSE.CC0 Fix database icons license issues. 2013-03-23 21:50:23 +01:00
LICENSE.GPL-2 Add "LICENSE" prefix to license filenames. 2010-08-15 12:33:42 +02:00
LICENSE.GPL-3 Add "LICENSE" prefix to license filenames. 2010-08-15 12:33:42 +02:00
LICENSE.LGPL-2.1 Fix typo in filename. 2013-03-24 14:16:34 +01:00
LICENSE.LGPL-3 Add LGPL-3 license text for the Oxygen icons. 2013-03-24 11:54:20 +01:00
LICENSE.NOKIA-LGPL-EXCEPTION Add support for gzip compressed databases. 2010-09-23 22:27:59 +02:00
README.md Add WITH_ASAN option to README 2017-03-16 00:20:38 +01:00
release-tool Enable Yubikey in release-tool by default 2017-02-26 00:08:48 +01:00
snapcraft.yaml Merge branch 'release/2.1.3' into develop 2017-02-22 14:13:58 +01:00

KeePassXC Travis Build Status Coverage Status KeePassXC Authenticode Certificate Campaign!

KeePass Cross-platform Community Edition

About

KeePassXC is a community fork of KeePassX with the goal to extend and improve it with new features and bugfixes to provide a feature-rich, fully cross-platform and modern open-source password manager.

Additional features compared to KeePassX

  • Auto-Type on all three major platforms (Linux, Windows, OS X)
  • Stand-alone password generator
  • Password strength meter
  • YukiKey HMAC-SHA1 authentication for unlocking databases
  • Using website favicons as entry icons
  • Merging of databases
  • Automatic reload when the database changed on disk
  • KeePassHTTP support for use with PassIFox in Mozilla Firefox and chromeIPass in Google Chrome or Chromium.
  • Many bug fixes

For a full list of features and changes, read the CHANGELOG document.

Note about KeePassHTTP

KeePassHTTP is not a highly secure protocol and has certain flaw which allow an attacker to decrypt your passwords when they manage to intercept communication between a KeePassHTTP server and PassIFox/chromeIPass over a network connection (see here and here). KeePassXC therefore strictly limits communication between itself and the browser plugin to your local computer. As long as your computer is not compromised, your passwords are fairly safe that way, but use it at your own risk!

Installation

Pre-compiled binaries can be found on the downloads page. Additionally, individual Linux distributions may ship their own versions, so please check out your distribution's package list to see if KeePassXC is available.

Building KeePassXC yourself

More detailed instructions are available in the INSTALL file or on the Wiki page.

First, you must download the KeePassXC source tarball or check out the latest version from our Git repository.

To clone the project from Git, cd to a suitable location and run

git clone https://github.com/keepassxreboot/keepassxc.git

This will clone the entire contents of the repository and check out the current develop branch.

To update the project from within the project's folder, you can run the following command:

git pull

Once you have downloaded the source code, you can cd into the source code directory and build and install KeePassXC with

mkdir build
cd build
cmake -DWITH_TESTS=OFF ..
make -j8
sudo make install

cmake accepts the following options:

  -DWITH_XC_AUTOTYPE=[ON|OFF] Enable/Disable Auto-Type (default: ON)
  -DWITH_XC_HTTP=[ON|OFF] Enable/Disable KeePassHTTP and custom icon downloads (default: OFF)
  -DWITH_XC_YUBIKEY=[ON|OFF] Enable/Disable YubiKey HMAC-SHA1 authentication support (default: OFF)

  -DWITH_TESTS=[ON|OFF] Enable/Disable building of unit tests (default: ON)
  -DWITH_GUI_TESTS=[ON|OFF] Enable/Disable building of GUI tests (default: OFF)
  -DWITH_DEV_BUILD=[ON|OFF] Enable/Disable deprecated method warnings (default: OFF)
  -DWITH_ASAN=[ON|OFF] Enable/Disable address sanitizer checks (Linux only) (default: OFF)
  -DWITH_COVERAGE=[ON|OFF] Enable/Disable coverage tests (GCC only) (default: OFF)

Contributing

We are always looking for suggestions how to improve our application. If you find any bugs or have an idea for a new feature, please let us know by opening a report in our issue tracker on GitHub or join us on IRC on freenode channels #keepassxc or #keepassxc-dev.

You can of course also directly contribute your own code. We are happy to accept your pull requests.

Please read the CONTRIBUTING document for further information.