#71 Help update - Global Auto-Type Hot Key


I have updated the Help to include details of the difference between window matches when you use specify an Auto-Type window string in V1 and V2.
The code will replace the section here: http://keepass.info/help/base/autotype.html#autoglobal

cheers, Paul

<a name="autoglobal"></a>
<h2 class="sectiontitle"><img src="../images/b16x16_ktouch.png" class="singleimg" alt="Text">&nbsp;&nbsp;Global
Auto-Type Hot Key</h2>

<p>This is the more powerful method, but it also requires a little bit more
work/knowledge, before it can be used.</p>

<p><b>Simple Global Auto-Type Example:</b></p>

<li>Create an entry in KeePass titled <i>Notepad</i> with values for user name and password.</li>
<li>Start Notepad - under Programs -&gt; Accessories.</li>

<li>Press <i>LCtrl-Alt-A</i> within Notepad. The user name and
password will be typed into Notepad.</li>

<p>The KeePass entry title <i>Notepad</i> is matched with the window title of
Notepad and the default Auto-Type sequence is typed.</p>

<p><b>How It Works - Details:</b></p>

<p>KeePass registers a system-wide hot key for auto-type. The advantage of
this hot key is that you don't need to switch to the KeePass window and
select the entry. You simply press the hot key while having the target window
open (i.e. the window which will receive the simulated keypresses).</p>

<p>By default, the global hot key is <i>LCtrl-Alt-A</i> (i.e. hold the left Ctrl and
Alt keys, press 'A' and release all keys). You can change this hot key
in the options dialog (main menu - 'Tools' - 'Options', tab 'Integration'/'Advanced'):
here, click into the
textbox below "Global Auto-Type Hot Key Combination" and press the
hot key that you wish to use. If the hot key is usable, it will appear in the textbox.</p>

<p>When you press the hot key, KeePass will look at the title of the currently opened window and
search the currently opened database for usable entries. If KeePass finds multiple
entries that can be used, it displays a selection dialog. In order to decide if an
entry is usable for the current window title, at least one of the following conditions
must be fulfilled:</p>

<li>The title of the entry is a substring of the currently active window title.</li>
<li>The entry has a window/sequence association, of which the window specifier matches
the currently active window title.</li>

<p>The second condition has been mentioned already, but the first one
is new. By using entry titles as filters for window titles, the configuration amount
for auto-type is almost zero: you only need to make sure that the entry title
is contained in the window title of the window into which you want the entry to be
auto-typed. Of course, this is not always possible (for example, if a webpage has a
very generic title like <i>"Welcome"</i>), here you need to
use custom window/sequence associations.</p>

<div class="specificbox">
<div class="specifictitle">KeePass 1.x Only</div>
Custom window associations <b>override</b> the KeePass entry title.
Any custom window associations specified will be the <b>only</b> item(s) used to determine
a match, the KeePass entry title will <b>not</b> be used to determine a match.

Custom window/sequence associations can be specified using the Notes field of entries.

<pre>My e-mail I used to register: test@nowhere.com

Auto-Type: {USERNAME}{TAB}{TAB}Some fixed string{TAB}{PASSWORD}{ENTER}
<b>Auto-Type-Window: Some Website - Welcome*</b>

Here you can continue with your notes if you wish...</pre>

If you now have a window open that starts with "Some Website - Welcome" and press the global
auto-type hot key combination, KeePass performs the auto-type sequence above.<br>
Some sites, notably banks, use multi-page login schemes. You can use
<code>Auto-Type-Window</code> strings to automate these sites.
You can also use <code>Auto-Type-Window</code> strings to standardize your LAN login
in one KeePass entry.<br>
As many <code>Auto-Type-Window</code> strings per entry can be defined as you wish.<br>

Also, one sequence can be used for multiple windows. For this, first define a window/sequence
pair as normal, then continue by appending '-' and a number, starting with 1. Example:

Auto-Type-Window: Some Dialog - *
Auto-Type-1: {USERNAME}{ENTER}
Auto-Type-Window-1: * - Editor
Auto-Type-Window-1: * - NotePad
Auto-Type-Window-1: * - WordPad
Auto-Type-2: {PASSWORD}{ENTER}
Auto-Type-Window-2: Some Web Page - *</pre>

Here, the <code>Auto-Type-1</code> sequence will be used for all <code>Auto-Type-Window-1</code>


<div class="specificbox">
<div class="specifictitle">KeePass 2.x Only</div>
Custom window associations <b>complement</b> the KeePass entry title.
Any custom window associations specified will be used in addition to the KeePass entry
title to determine a match.

Custom window/sequence associations can be specified on the <i>'Auto-Type'</i> tab
page of each entry.



  • Dominik Reichl

    Dominik Reichl - 2010-12-29

    I've included your new info (slightly modified and moved to the end of the boxes), thanks!

    Best regards

  • Dominik Reichl

    Dominik Reichl - 2010-12-29
    • status: open --> closed

Log in to post a comment.