Skip to content

Xarty with AHK

CarrieForle edited this page Jun 11, 2023 · 27 revisions

Introduction

There are 2 AHK (AutoHotKey) versions available.

  • Xarty.ahk
  • Xarty-extend.ahk

The difference between them is Xarty-extend.ahk has extend layer and compose features, while Xarty.ahk is plainly remapping, which is a lot simpler. There isn't too much for Xarty.ahk. Everything works like what you expect how a typical keyboard to work. For reference, You may refer to the official AHK documentation, it recorded more technical and specific details of the remapping.

Xarty-extend.ahk

There is, however, a lot to say about Xarty-extend.ahk. That's actually why I wrote this Wiki in the first place. The goal is to tell what you should expect when you are using this version of the layout, without having to learn AHK and going through the rather awful spaghetti source code.

Features

Xarty-extend.ahk supports 3 extend layers and compose feature. You cannot customize the extend layers, but you can write your own text to compose with compose.ini, which will be automatically generated on the first run or when compose.ini is not found in the working folder. Refer here for the specification about compose.ini.

The extend key is CapsLock. When you press the extend key, the first extend layer will be activated, when you release the extend key, the extend layer will be deactivated and go back to the normal status of Xarty layout. Shift and Ctrl is for the second and the third extend layer respectively. However, you do not just press Shift or Ctrl to activate the dedicated extend layer. You have to combine with the extend key (CapsLock) in order to activate. After activation, you can optionally released Shift (for the second layer) or Ctrl (for the third layer). The extend layer is stay activated as long as CapsLock is stay pressed.

Clone this wiki locally