binaer-infusion

Editing text made easy with AutoHotkey

tilm4nn — Sat, 05 Jan 2008 22:46:28 +0000

While editing text, especially computer programs but also letters, documentation or reports, it is often required to move the cursor to another position like a line up or down or to the beginning or end of the line. Fortunately keyboards have keys to do this. Unfortunately the right hand has to be removed from its usual working position to use these. This leads to interrupts of the typing work-flow, is time-consuming and is error prone when the hand has been placed back in the wrong position. A possible solution to this is to customize the keyboard behaviour so that the required functions are accessible while the hands can stay right where they are.

Customize cursor movements

AutoHotkey is a very useful Windows utility that allows, among other functions, full customization of the keyboard behaviour. Now I’ll show how it can be used to simplify navigation in text.

After AutoHotkey has been installed a so called AutoHotkey script has to be edited or created. The best way to start is to simply edit the AutoHotkey init script which is called “AutoHotkey.ini” and is located in the install directory. It can be changed using any text editor. If AutoHotkey is running it can be accessed with a right click on the AutoHotkey system tray icon and selecting “Edit This Script”.

Now the following macros can be included in the script.

;----------------------------------
; Navigation in Text
;----------------------------------
!+j::Send ^{Left}
!+l::Send ^{Right}
!j::Send {Left}
!l::Send {Right}
!i::Send {Up}
!k::Send {Down}
!SC027::Send {End}
!h::Send {Home}

The script must be saved and AutoHotkey restarted to activate the macros. If AutoHotkey is running the restart can be done by a right clicking on the AutoHotkey system tray icon and selecting “Reload This Script”

The macros just presented allow the text writer to navigate up, down, left, right, home and end by holding down the Alt key with the left hand and using i, j, k, l as arrow keys and h, : as Home and End. Navigation by word is done by holding down Alt and Shift together and using the keys j and l.

Let’s now have a look at some lines of the code to explain how the macros work:

!j::Send {Left}

The line consists of two parts. The first part is left of “::” and is called the hotkey. The part on the right side is the command executed when the hotkey is pressed. The hotkey in the example “!j” is a compound hotkey that is a press of the j key while the Alt key is being held down. The command “Send {Left}” tells AutoHotkey to send a keypress of the left arrow to the operating system. So the key combination Alt+j has now the same effect as the left arrow.

 !SC027::Send {End}

The simulation of the end key is activated by the key combination Alt+:. Since “:” is a special character in the AutoHotkey macro language the keyboard scan code “SC027″ is used in the hotkey instead.

!+j::Send ^{Left}

“+” is standing for the Shift key and “^” is standing for the Ctrl key. This macro maps Alt+Shift+j to Ctrl+Left which allows to move the cursor one word to the left in the text.

Automatically generate or replace text

Another example for the usefulness of AutoHotkey is its hotstrings function. This functions scans the text input for defined abbreviations and replaces them with some other text on the fly. Below is shown a script compartment with some examples:

;----------------------------------
; Hotstrings for programming
;----------------------------------
#Hotstring c ; Case sensitive
#Hotstring EndChars  .(
:R:pu::public
:R:st::static
:R:pr::private
:R:fi::final
:R:str::string
:R :Str::String
:R  :STr::String
:R:bo::boolean
:R:re::return
:R:imp::implements
:R:sout::System.out.println

When a defined end character is typed (” “, “.” and “(” in this example) AutoHotkey examines the preceding text. If it can find a hotstring it is replaced. Hotstrings are defined by the notation :R::: in the AutoHotkey script file. So if the script presented above is active the input of “Str ” will immediately be replaced with “String ” while typing.

Advanced features of AutoHotkey

AutoHotkey has a lot of more features than presented here that make it easy to perform repeated tasks. They can be used for any purpose such as access to installed programs by key, control of instant messengers or gaming for example. Here is the feature list from the AutoHotkey homepage

Automate almost anything by sending keystrokes and mouse clicks. You can write a mouse or keyboard macro by hand or use the macro recorder.
Create hotkeys for keyboard, joystick, and mouse. Virtually any key, button, or combination can become a hotkey.
Expand abbreviations as you type them. For example, typing “btw” can automatically produce “by the way”.
Create custom data-entry forms, user interfaces, and menu bars. See GUI for details.
Remap keys and buttons on your keyboard, joystick, and mouse.
Respond to signals from hand-held remote controls via the WinLIRC client script.
Run existing AutoIt v2 scripts and enhance them with new capabilities.
Convert any script into an EXE file that can be run on computers that don’t have AutoHotkey installed.
Change the volume, mute, and other settings of any soundcard.
Make any window transparent, always-on-top, or alter its shape.
Use a joystick or keyboard as a mouse.
Monitor your system. For example, close unwanted windows the moment they appear.
Retrieve and change the clipboard’s contents, including file names copied from an Explorer window.
Disable or override Windows’ own shortcut keys such as Win+E and Win+R.
Alleviate RSI with substitutes for Alt-Tab (using keys, mouse wheel, or buttons).
Customize the tray icon menu with your own icon, tooltip, menu items, and submenus.
Display dialog boxes, tooltips, balloon tips, and popup menus to interact with the user.
Perform scripted actions in response to system shutdown or logoff.
Detect how long the user has been idle. For example, run CPU intensive tasks only when the user is away.
Automate game actions by detecting images and pixel colors (this is intended for legitimate uses such as the alleviation of RSI).
Read, write, and parse text files more easily than in other languages.
Perform operation(s) upon a set of files that match a wildcard pattern.
Work with the registry and INI files.

Synchronize Contacts w. Mobile and Tunderbird x2

tilm4nn — Wed, 26 Dec 2007 12:11:39 +0000

Keeping contact data on a mobile phone and the personal e-mail client in sync can be a tedious task especially if multiple e-mail client instances are involved. In this article I’m going to show how the scenario with one of Sony Ericsson’s mobile phones and two instances of Thunderbird can be handled.

On the web there exists a bunch of synchronization services that provide the possibility to sync your contact, calendar, sms, and other data among multiple mobile phones using the SyncML protocol. Together with fitting plug-ins they can also be used to sync between mobile phone and e-mail client. The services tested by me are Mobical and ZYB which both have their advantages and drawbacks.

Mobical has a more tidy and user-friendly web interface. It is the #1 choice if you plan to edit your contacts on-line. But Mobical has relative slow syncML servers which caused some problems with my SE w880i mobile so I had to apply a little trick to get it to work correctly.
ZYB caused no problems with my mobile but the flash web application has tiny widgets that are very hard to work with. Syncing contacts with my mobile and one instance of Thunderbird worked very well and fast, but when I added another Thunderbird instance I got all contacts duplicated from time to time which was mess because there is no easy way to find out which are the correct ones.

The basic setup

To start synchronization only a few easy steps are required:

Create an account with Mobical
Have Mobical send automatic configuration to the mobile phone. (Worked correctly with Sony Ericsson w880i)
Download and install the TSync Thunderbird add-on. The TSync configuration must be adjusted to use your Mobical user-name and password the database name “con” and the server URL “http://www.mobical.net/sync/server”

These three steps are sufficient to start synchronization

Tricks to apply

Unfortunately as mentioned before it is required to take care about some deficits when using certain combinations of SyncML clients and servers.

When synchronizing with Mobical and TSync there are two noticeable problems that can be easily solved: Occasionally Thunderbird will display a dialog box about a unresponsive script and asks how to proceed. In this case the option “Continue” has to be selected. In addition the progress dialog of TSync will never close by itself. It will stay open on “Receiving data from server 6/6″ and can be safely closed using the close button of the dialog window. As seen in the sync servers log file the synchronization has finished successfully.
When synchronizing with Mobical and a Sony Ericsson mobile there can be unexpected aborts of the synchronization process. This happens because of the Mobical server being very slow when many contacts have to be synchronized at once. There is a solution to this problem for the initial synchronization when all contacts to be synchronized are already stored on the Mobical server: First all contacts have to be deleted from the mobile. After logging in to the Mobical web site all contacts on the server should be moved to the Trashcan by deleting them. Now synchronization works fine if repeatedly about 20 contacts are undeleted in Mobical and a synchronization process is carried out with the mobile phone until all contacts have been undeleted and synchronized. From now on it is crucial to occasionally synchronize the mobile phone to prevent the synchronization process to abort when to many contacts have been added or changed at once.

Add another instance of Thunderbird

To avoid problems when synchronizing with multiple instances of Thunderbird it is important for the SyncML server to be able to differentiate between the instances. This done by the device id sent by the client to the server during each synchronization process. If you install TSync on two different Thunderbird instances they will both use the same device id which will cause problems during synchronization. Now I present step by step instructions how to change the device id of a TSync installation:

Locate the TSync add-on in the Thunderbird profile by looking for a file called tsync.jar.
Extract tsync.jar using your favourite zip file extractor in the same folder.
Delete tsync.jar
Open the file content/tsync/tsync.js using a text file editor.
Locate the line starting with “var devid” and change the string literal assigned to this variable.
Optionally also change the text that will appear in Mobical’s sync history by looking for the text “Tobias SyncML client for Thunderbird” in the same file and changing it to something identifying to which Tunderbird instance it refers.
Close and save tsync.js.
Recompress the once extracted folders and files to a file called tsync.jar using a zip file compressor.
Remove the extracted files and directories.
Restart Thunderbird if it was running.

After completing these steps synchronizing contacts with two Thunderbird instances can be really enjoyed.