mirror of
https://github.com/keepassxreboot/keepassxc.git
synced 2024-10-01 01:26:01 -04:00
9886b1075f
* Fix #5313, allow specifying local config path using environment variable and command line flag * Add command line flag `--localconfig <path>` to specify a file path to use for the local configuration settings. * Add environment variable support to set config files paths: `KPXC_CONFIG` and `KPXC_CONFIG_LOCAL` to override default locations. * Reorder startup sequence to load specified config files earlier to allow for theme settings and other early options to be picked up. * Removed old command line option `--pw`, no longer used. * Attempt a fix of application not closing when last window is gone. Only set `QApplication::setQuitOnLastWindowClosed(true)` when tray icon is enabled instead of always.
89 lines
5.0 KiB
Plaintext
89 lines
5.0 KiB
Plaintext
= KeePassXC - Database Operations
|
|
include::.sharedheader[]
|
|
:imagesdir: ../images
|
|
|
|
// tag::content[]
|
|
== Interface Overview
|
|
=== Application Layout
|
|
The KeePassXC interface is designed for simplicity and easy access to your information. The main database view is split into three main partitions detailed below. You can open multiple databases at the same time, they will appear in tabs.
|
|
|
|
.Main database interface
|
|
image::main_interface.png[]
|
|
|
|
*(A) Groups* - Organize your entries into discrete groups to bring order to all of your sensitive information. Groups can be nested under each other to create a hierarchy. Settings from parent groups get applied to their children.
|
|
|
|
*(B) Entries* - Entries contain all the information for each website or application you are storing in KeePassXC. This view shows all the entries in the selected group. Each column can be resized, reordered, and shown or hidden based on your preference. Right click the header row to see all available options.
|
|
|
|
*\(C) Preview* - Shows a preview of the selected group or entry. You can temporarily hide this preview using the close button on the right hand side or completely disabled in the application settings.
|
|
|
|
TIP: Double clicking on the text in the entries list copies that field to the clipboard. Double clicking the entry title will open the entry for editing.
|
|
|
|
=== Toolbar
|
|
The toolbar provides a quick way to perform common tasks with your database. Some entries in the toolbar are dynamically disabled based on the information contained in the selected entry. Every common action in KeePassXC can be controlled with a keyboard shortcut as well.
|
|
|
|
.Toolbar overview
|
|
image::toolbar.png[]
|
|
|
|
*(A) Database* - Open Database, Save Database +
|
|
*(B) Entries* - Create Entry, Edit Selected Entry, Delete Selected Entry +
|
|
*\(C) Entry Data* - Copy Username, Copy Password, Copy URL, Perform Auto-Type +
|
|
*(D) Lock All Databases* +
|
|
*(E) Tools* - Password Generator, Application Settings +
|
|
*(F) Search*
|
|
|
|
=== Application Settings
|
|
Users can configure KeePassXC to their personal tastes with a wide variety of general and security settings that apply to the whole application. These settings are accessible from _Tools_ -> _Settings_ or the cog wheel icon from the toolbar. Settings include: startup options, file management, entry management, user interface, language, security timeouts, and convenience.
|
|
|
|
==== Setting the Theme
|
|
KeePassXC ships with light and dark themes specifically designed to meet accessibility standards. In most cases, the appropriate theme for your system will be determined automatically, but you can always set a specific theme by using the _View_ menu. When a new theme is selected you will be prompted to restart KeePassXC to apply the theme immediately.
|
|
|
|
.Setting the theme
|
|
image::theme_selection.png[]
|
|
|
|
==== Compact Mode
|
|
For users with smaller screens or those who desire seeing more entries at once, KeePassXC offers a compact view mode. This mode shows smaller toolbar, group, and entry icons. The effect of compact mode (left side) can be seen below.
|
|
|
|
.Compact mode comparison
|
|
image::compact_mode_comparison.png[]
|
|
|
|
=== Keyboard Shortcuts
|
|
include::KeyboardShortcuts.adoc[tag=content, leveloffset=+1]
|
|
|
|
// tag::advanced[]
|
|
=== Command-Line Options
|
|
You can use the following command line options to tailor the application to your preferences:
|
|
|
|
----
|
|
Usage: keepassxc.exe [options] [filename(s)]
|
|
KeePassXC - cross-platform password manager
|
|
|
|
Options:
|
|
-?, -h, --help Displays help on commandline options.
|
|
--help-all Displays help including Qt specific options.
|
|
-v, --version Displays version information.
|
|
--config <config> path to a custom config file
|
|
--localconfig <localconfig> path to a custom local config file
|
|
--keyfile <keyfile> key file of the database
|
|
--pw-stdin read password of the database from stdin
|
|
--debug-info Displays debugging information.
|
|
|
|
Arguments:
|
|
filename(s) filenames of the password databases to open (*.kdbx)
|
|
----
|
|
|
|
Additionally, the following environment variables may be useful when running the application:
|
|
|
|
[grid=rows, frame=none, width=75%]
|
|
|===
|
|
|Env Var | Description
|
|
|
|
|KPXC_CONFIG | Override default path to roaming configuration file
|
|
|KPXC_CONFIG_LOCAL | Override default path to local configuration file
|
|
|SSH_AUTH_SOCKET | Path of the unix file socket that the agent uses for communication with other processes (SSH Agent)
|
|
|QT_SCALE_FACTOR [numeric] | Defines a global scale factor for the whole application, including point-sized fonts.
|
|
|QT_SCREEN_SCALE_FACTORS [list] | Specifies scale factors for each screen. See https://doc.qt.io/qt-5/highdpi.html#high-dpi-support-in-qt
|
|
|QT_SCALE_FACTOR_ROUNDING_POLICY | Control device pixel ratio rounding to the nearest integer. See https://doc.qt.io/qt-5/highdpi.html#high-dpi-support-in-qt
|
|
|===
|
|
// end::advanced[]
|
|
// end::content[]
|