AutoHotKey - Windows용 HotKey Script Utility

관심가져주셔서 감사합니다.

이 프로그램이 알려지기 시작한 건 그리 오래되지 않은 것으로 알고 있습니다. 그리고, 개발자가 아닌 이상 쓰기 힘든 면도 없지 않구요. 그러다보니 한글화와 스크립트에 비중을 두게 되었습니다.
아직 많이 쓰이는 건 아니지만, 강력한 기능들때문에 충분히 널리 쓰일 가능성이 있다고 보고 있습니다.

한글화에 대해서는 방대한 분량이라 솔직히 아직은 엄두가 나지 않습니다. 지금 생각중인 것은 간단한 툴 사용법이라던가 간단한 스크립트 작성에 대한 부분 정도를 한글화하거나 자체 제작하는 걸 생각하고 있고, 이후 관심을 보이는 분들이 많아지면 매뉴얼쪽이나 프로그램의 한글화에도 손을 대 볼까 하고 있습니다.

또, 리눅스/유닉스 호환 프로젝트들도 생각중인 게 몇 가지 있습니다.

QEMU같은 것만 하더라도 쓸 줄 아는 분들은 무난하게 쓰지만 모르는 분들은 아예 모릅니다. 그러나, 개인적으로나 실무에서나 가상의 PC 환경이 필요한 경우는 종종 생기지요.

VNC 계열같은 PC 원격 조종 유틸리티도 적당할 것 같구요.

비록 윈도용이지만, - 그렇기 때문에 현재 KLDP의 리눅스/유닉스 유저/개발자들이 아닌 KLDP에서 아직 활동하지 않는 윈도 유저/개발자들을 끌어들일 수 있는 - freeCommander 라던가 등등 유틸리티 종류들과, 많이 쓰임에도 한글화된 자료는 정작 별로 없는 라이브러리들에 대해서도 차차 정리해 볼 생각입니다.

AutoHotKey의 문서들 중 소개 문서와 Quick-Start Tutorial을 먼저 번역해볼까 합니다.
소개 문서는 그다지 어렵지 않고, 분량도 많지 않은 편입니다.
먼저 찜하시면 임자입니다. :-)

Tutorial은 9 파트로 나뉘어져 있는데, 각 파트는 그다지 길지 않지만 전체 분량은 조금 됩니다. :-)

** 굵은 글꼴로 된 파트는 작업이 예약되어 진행중이거나 완료된 파트입니다. ***

Creating a script
Launching a program or document
Sending keystrokes and mouse clicks
Activating and manipulating windows(진행중)
Getting input from the user with MsgBox, InputBox, etc.
Using variables and the clipboard
Repeating a series of actions over and over
Manipulating files and folders
Overview of other features

역시 먼저 찜하시면 임자입니다.

그리고, 번역 작업은 위키로 진행하는 게 좋을 것 같은데, 다른 분들 생각은 어떠신지요? 위키 페이지를 만들어 진행하거나 혹은 메일로 작업을 진행하고 결과물만을 이 쓰레드의 게시물로 올릴지 결정해야 할 것 같습니다. 모든 과정을 쓰레드에 남기자니 쓰레드가 좀 복잡해질 것 같다는 걱정도 되어서요.

참고로, 번역 작업은 당분간은 원래의 프로젝트와는 별개로 진행하다 어느 정도 정리가 되면 원래의 프로젝트 관리자분께 연락드려서 본 프로젝트의 일부분으로 만들어 나갈지, 아니면 계속 별개의 작업으로 나갈지 결정하게 될 것 같습니다.

네, 그럼 당분간 이 글타래에서 작업을 진행하도록 하겠습니다.

전 소개 문서와 Launching a program or document 파트를 번역해서 올리도록 하지요.

저도 번역 경험은 그다지 많지 않습니다. 몇 가지 프로그램들의 한글언어팩 파일 만든 것 정도와 학교 다닐때 자바 문서 몇 개 번역해본 정도......

개인적으로는 공부도 할 겸 해서 RFC 문서를 하나 잡고 번역중이긴 한데, 이것도 안 한지 꽤 됐군요. ㅡ_ㅡ 혼자만 하다보니......

원문

Introduction
AutoHotkey is a free, open-source utility for Windows. With it, you can:

Automate almost anything by sending keystrokes and mouse clicks. You can write macros 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. 
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. 
Getting started might be easier than you think. Check out the quick-start tutorial.

More about Hotkeys
AutoHotkey unleashes the full potential of your keyboard, joystick, and mouse. For example, in addition to the typical Control, Alt, and Shift modifiers, you can use the Windows key and the Capslock key as modifiers. In fact, you can make any key or mouse button act as a modifier. For these and other capabilities, see Advanced Hotkeys.

Other Features
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 pixel colors. 
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. 

Limitations on Windows 95/98/Me: Some of the advanced features -- such as mouse button hotkeys and hotstrings -- are not available on Win9x.

Acknowledgements
A special thanks to Jonathan Bennett, whose generosity in releasing AutoIt v2 as free software in 1999 served as an inspiration and time-saver for myself and many others worldwide. In addition, many of AutoHotkey's enhancements to the AutoIt v2 command set, as well as the Window Spy and the script compiler, were adapted directly from the AutoIt v3 source code. So thanks to Jon and the other AutoIt authors for those as well.

Finally, AutoHotkey would not be what it is today without these other individuals.

번역문

소개
AutoHotKey는 윈도용의 자유, 오픈-소스 유틸리티이다. 이것으로, 다음과 같을 일을 할 수 있다.

키 입력과 마우스 클릭에 의한 무엇이든지 거의 모두 자동화할 수 있다. 당신은 직접 매크로를 작성할수도 있고, 매크로 레코더를 사용할 수도 있다.
키보드, 조이스틱, 마우스를 이용해 핫키를 만들 수 있다. 거의 모든 키나 버튼, 혹은 조합은 핫키가 될 수 있다.
당신이 입력한 약어가 확장될 수 있다. 예를 들어, "btw"를 입력하면 자동으로 "by the way"가 만들어질 수 있다.
맞춤형 데이터 입력 형식, 유저 인터페이스, 메뉴 바 등을 만들 수 있다. 자세한 건 GUI 부분을 보라.
키보드, 조이스틱, 마우스의 키들과 버튼들을 재배치(Remap)할 수 있다.
기존의 AutoIt v2 스크립트와 새로운 기능으로 강화된 스크립트를 실행할 수 있다.
AutoHotKey가 설치되지 않은 컴퓨터에서도 실행할 수 있도록 스크립트를 EXE 파일로 변환할 수 있다.
시작하는 것은 당신이 생각하는 것 보다 쉬울 것이다. quick-start tutorial을 보라.

Hotkey에 대해 더 자세히
AutoHotKey는 당신의 키보드, 조이스틱, 마우스의 모든 잠재적인 능력을 완벽하게 해방시킨다. 예를 들어,
Control, Alt, Shift 제어(modifier) 키를 치는 것은 물론, 당신은 Windows 키와 Capslock키도 제어 키 처럼 사용할 수 있다.
사실상, 당신은 어느 키나 혹은 마우스 버튼 입력도 제어 키처럼 만들 수 있다.
이러한 것들과 다른 능력들에 대해서는 고급 핫키(Advanced Hotkeys) 항목을 보라.

다른 기능

사운드 카드의 볼륨, 음소거, 그리고 다른 설정들을 변경할 수 있다.
어떤 윈도우도 투명하게 또는 항상위에 있게 만들거나 그 모양을 변경할 수 있다.
조이스틱과 키보드를 마우스처럼 쓸 수 있다.
시스템을 감시할 수 있다. 예를 들면, 원하지 않는 윈도들이 종료되는 순간 그것들이 다시 나타나게 할 수 있다.(?)
클립보드의 내용이나 탐색기 창에서 복사된 파일명을 바꾸거나 회복시킬 수 있다.
Win+E나 Win+R 같은 윈도우의 자체 단축키를 재정의하거나 사용할 수 없게 할 수 있다.
(키나 마우스 휠, 또는 버튼을 써서) Alt-Tab을 대신해 RSI(?)를 완화할 수 있다
당신의 아이콘, 툴팁, 메뉴 아이템과 서브 메뉴들로 사용자 정의 트레이 아이콘 메뉴를 구성할 수 있다.
다이얼로그 상자, 툴팁, 풍선도움말, 팝업 메뉴들을 사용자와 상호작용하도록 표시할 수 있다.
스크립트 액션에 응답해 시스템을 끄거나 로그오프 하도록 할 수 있다.(?)
사용자가 얼마나 오랫동안 아무것도 하지 않는지 감지할 수 있다. 예를 들어, 사용자가 자리를 비웠을때에만 CPU intensiv task들을 실행시킬 수 있다.
픽셀 색상을 탐지하는 것에 의해 게임 액션들을 자동화할 수 있다.
텍스트 파일들을 읽고 쓰고 분석하는 것이 다른 언어들보다 더 쉽다.
와일드카드 패턴에 일치되는 파일들의 셋으로 작업하는 것을 할 수 있다.
레지스트리와 INI파일을 다룰 수 있다.


Windows 95/98/Me에서의 제한사항: 마우스 버튼 핫키나 핫스트링 같은 고급 기능의 일부들은 Win9x에서 사용이 불가능하다.

감사의 말
AutoIt v2를 199년에 자유 소프트웨어로 릴리스하여 나 자신과 많은 전 세계의 다른이들에게 영감을 주고 시간을
절약시켜준 마음이 넓은 Jonathan Bennett에게 매우 감사드린다. 더불어, 그는 AutoHotkey를 강화시키기 위해
AutoIt v2 명령어 셋, 윈도 스파이와 스크립트 컴파일러, AutoIt v3 소스 코드롤 직접 개조하여 주었다.
Jon과 다른 AutoIt 저작자들에게 깊은 감사를 드린다.

마지막으로, AutoHotkey 다른 사람들 없이는 오늘날 존재하지 못했을 것이다.

매뉴얼의 가장 처음에 있는, 소개 부분을 번역해 보았습니다.
여기 저기 의역도 좀 되어 있고, 대충 번역해버린 부분도 있습니다. :) 잘못 번역한 것도 있을겁니다. 좀 이상하거나 잘못된 부분은 지적해 주시면 감사하겠습니다.

modifier key를 어떻게 번역해야 하나 고민하다, 제어 키로 번역해두었습니다.

원문

Launching a program or document
The Run command is used to launch a program, document, URL, or shortcut, as in the following examples:
Run, Notepad
Run, C:\My Documents\Address List.doc
Run, C:\My Documents\My Shortcut.lnk
Run, www.yahoo.com
Run, mailto:someone@anywhere.com

A hotkey can be assigned to any of the above examples by including a hotkey label. In the first example below, the assigned hotkey is Win+N, while in the second it is Control+Alt+C:
#n::Run, Notepad
^!c::Run, calc.exe

The above examples are known as single-line hotkeys because each consists of only one command. To have more than one command executed by a hotkey, put the first line beneath the hotkey definition and make the last line a return. For example:
#n::
Run, http://www.google.com
Run, Notepad.exe
return

If the program or document to be run is not integrated with the system, specify its full path to get it to launch:
Run, %ProgramFiles%\Winamp\Winamp.exe

In the above example, %ProgramFiles% is an environment variable maintained by the operating system. By using it rather than something like C:\Program Files, the script is made more portable, meaning that it would be more likely to run on other computers. 

To have the script wait for the program or document to close before continuing, use RunWait instead of Run. In this example, the MsgBox command will not execute until after the user closes Notepad:
RunWait, Notepad
MsgBox, The user has finished (Notepad has been closed).

To learn more about launching programs -- such as launching them in a minimized/maximized/hidden state, specifying a working directory, passing parameters, using system verbs, and discovering a program's exit code -- click here.

번역문

프로그램이나 문서 실행하기
Run 명령어는 아래 예제들처럼 프로그램, 문서, URL, 또는 단축아이콘을 실행하는 데 사용된다.
Run, Notepad
Run, C:\My Documents\Address List.doc
Run, C:\My Documents\My Shortcut.lnk
Run, www.yahoo.com
Run, mailto:someone@anywhere.com

핫키는 이전 예제들의 어느 것이든 핫키 레이블을 포함시킴으로써 할당시킬 수 있다. 먼저, 처음 예제에서, 할당된 핫키는 Win+N이고, 두 번째에서는 Control+Alt+C이다.
#n::Run, Notepad
^!c::Run, calc.exe

이전 예제들은 알다시피 단지 하나의 명령으로 구성된 한 줄 핫키들이다. 하나의 핫 키에 하나 이상의 명령을 실행하도록 하려면, 첫 줄은 핫키 정의를 넣고 마지막 줄은 return을 넣는다. 예제:
#n::
Run, http://www.google.com
Run, Notepad.exe
return

만일 프로그램이나 문서가 시스템에 통합되지 않고(*역자주*시스템의 환경에 상관없이) 실행되도록 하려면, 실행 가능한 완전한 경로를 명기해야한다.
Run, %ProgramFiles%\Winamp\Winamp.exe

위의 예제에서, %ProgramFiles%는 운용되는 시스템에 의해 관리되는 환경 변수이다. 이것을 사용하는 것이 C:\Program Files같은 것을 사용하는 것 보다 스크립트를 다른 컴퓨터에서 실행하는 것 같은 일을 하는 데 있어 보다 이식성있게 만든다.

Run 대신 RunWait를 사용하여 스크립트는 계속 실행되기 전에 프로그램이나 문서가 종료(close)되는 것을 기다릴 수 있다. 이 예제는, MsgBox 명령을 사용자가 Notepad를 닫기 전에는 실행하지 않는다.
RunWait, Notepad
MsgBox, The user has finished (Notepad has been closed).

프로그램 실행에 관한 더 많은 것 -- 최소화/최대화/숨겨진 상태로 실행하고, 작업 디렉토리를 정하고, 파라미터는 넘겨주고, 시스템 verbs(?)를 사용하고, 프로그램의 종료 코드를 받는 것과 같은 -- 을 배우고자 한다면 여기를 클릭하라. (*주*Tutorial - Launch a program or document (continued) 항목으로 연결되게 되어 있음.)

좀 쉽지 않은 부분들이 있었으나, 나름대로 의역을...... :)

짧으니까 그래도 금방 끝나는군요. 30분 정도 걸린 듯 합니다.

원문

Sending keystrokes and mouse clicks
Keystrokes are sent to the active (foremost) window by using the Send command. In the following example, Win+S becomes a hotkey to type a signature. Be sure that a window such as an editor or draft e-mail message is active before pressing the hotkey:
#s::
Send, Sincerely,{enter}John Smith
return

In the above example, all characters are sent literally except {enter}, which results in a simulated press of the Enter key. The next example illustrates some of the other commonly used special characters:
Send, ^c!{tab}pasted:^v

The above example sends a Control+C followed by an Alt+Tab followed by the string "pasted:" followed by a Control+V. See the Send command for a complete list of special characters and keys. 

Mouse Clicks: To send a mouse click to a window it is first necessary to determine the X & Y coordinates where the click should occur. This can be done with either AutoScriptWriter or Window Spy, which are included with AutoHotkey. The following steps apply to the Window Spy method:

Launch Window Spy from the program's tray-icon menu or the Start Menu. 
Activate the window of interest either by clicking its title bar, alt-tabbing, or other means (Window Spy will stay "always on top" by design). 
Move the mouse cursor to the desired position in the target window and write down the mouse coordinates displayed by Window Spy (or press Shift-Alt-Tab to activate Window Spy so that the "frozen" coordinates can be copied and pasted). 
Use the coordinates discovered above with the MouseClick command as in this example, which clicks the left mouse button:
MouseClick, left, 112, 223 
To move the mouse without clicking, use MouseMove. To drag the mouse, use MouseClickDrag.

번역문

키 입력(keystrokes:키를 치다의 의미이므로 키 입력으로 의역합니다)과 마우스 클릭 보내기
키 입력은 Send 명령을 사용함으로써 활성화 된 (맨 앞의) 윈도우로 보내진다. 다음 예제에서, Win+S는 서명을 치는 핫키가 된다.  물론, 편집기 혹은 이메일 메시지 초안(draft) 같은 윈도우가 핫키를 누르기 전에 활성화 되어야 한다.
#s::
Send, Sincerely,{enter}John Smith
return

위의 예제에서, {enter} 외의 모든 문자들이 글자 그대로 보내어지며, {enter}는 Enter 키를 누르는 것을 흉내낸 결과가 된다. 다음 예제는 다른 일반적으로 사용되는 특수 문자들 중 일부를 설명한다.
Send, ^c!{tab}pasted:^v

위 예제는 Control+C 이후 Alt+Tab을, 그리고 그 후에는 문자열 "pasted:"를, 그 후에는 Control+V를 보낸다. 특수 문자들과 키들의 완전한 목록은 Send 명령 항목을 보라.

마우스 클릭: 마우스 클릭을 윈도우로 보내는 것은 먼저 클릭이 발생할 X와 Y좌표의 한계를 정하는 것이 필요하다. 이것은 AutoHotkey에 포함된 AutoScriptWriter나 Window Spy 둘 중 하나로 할 수 있다. 다음 순서로 Window Spy의 기능을 적용한다.

프로그램의 트레이-아이콘 메뉴나 시작 메뉴에서 Window Spy를 실행한다.
타이틀바를 클릭하거나 alt-tab을 이용하거나 혹은 다른 것들을 써서 관심있는 윈도우를 활성화시킨다. (Window Spy는 "항상 맨 위에" 머무르도록 디자인 되었다.)
마우스 커서를 타겟 윈도의 원하는 지점으로 이동시키고, Window Spy에 표시되는 마우스 좌표를 기록한다. (또는 Shift-Alt-Tab을 눌러 Window Spy를 활성화시키면 "동결된" 좌표를 복사하고 붙일 수 있다.)
알아낸 좌표를 왼쪽 마우스 버튼을 클릭하는 다음 예제처럼 MouseClick 명령에서 사용한다.
MouseClick, left, 112, 223