Skip to content

Settings and folders

Where AhkWord keeps its files

Folder What
%APPDATA%\AhkWord settings.json (your settings), Templates (your own templates, and their Parts), Recovery (the recovery copies of unsaved documents)
%LOCALAPPDATA%\AhkWord the converters' working files (LibreOffice's profile, the converters' log)
rte_macros, beside AhkWord the macros, and their own settings (My signature.ini)

Type %APPDATA%\AhkWord into Explorer's address bar to open the folder.

From RTE Writer

AhkWord was RTE Writer until iteration 38. Its first start copies %APPDATA%\RTE Writer and %LOCALAPPDATA%\RTE Writer into AhkWord's folders, settings, templates and recovery copies included, and leaves the old folders as they were.

Portable mode

Put an empty file named portable (or portable.txt) beside AhkWord.exe or AhkWord.ahk, and AhkWord keeps its settings, templates, recovery copies and the converters' state in a data folder beside itself instead, so the folder can be carried to another computer. The .NET packages and the C# compiler stay in the computer's own caches, so a computer that hasn't run AhkWord before downloads them once.

Environment variables

Variable Does
AHKWORD_DATA a folder for all of AhkWord's files (settings, templates, recovery copies, the converters' state), as portable mode's data folder
AHKWORD_SETTINGS the settings file to use instead of settings.json
AHKWORD_CONVERTERS the converters to use for Word and OpenDocument files, only those and in that order: word, libreoffice, openxml, pandoc (for example libreoffice,openxml)

The old names RTE_WRITER_SETTINGS and RTE_WRITER_CONVERTERS still work.

Several windows

The windows of AhkWord share one settings file. Each saves only what it changed, so closing one doesn't undo another's changes: recent documents, macro hotkeys and remembered values are merged item by item.