Oh! Text Hooker Ver 1.0 ( GPL ) ( 2004/05/16 ) Oh! Text Hooker's FIRST BIRTHDAY Today is Oh! Text Hooker's first birthday. HAPPY BIRTHDAY! Oh! Text Hooker was made for finding difficult words in the dictionary one year ago. And now, it is widely used among the Japanese game players for translation. This project is much more successful than I expected. However, sadly I can't spend time for Oh! Text Hooker anymore. If I can make money by developing Oh! Text Hooker, I may be able to spend time developing Oh! Text Hooker. However, I think that it would not happen. So I have one good news and one bad news to notice. The bad news is that I've decided to stop developing Oh! Text Hooker from now on. The good news is that I've decided to open Oh! Text Hooker source code under GPL. Even if I stop the development of Oh! Text Hooker and open the source code under GPL, I will update Oh! Text Hooker homepage when there is very important Oh! Text Hooker related news such as Oh! Text Hooker clone is made or someone decided to develop Oh! Text Hooker. ABOUT "Oh! Text Hooker" Personally, I study Japanese by playing Japanese computer/video games. However, it's not easy to find difficult words in the dictionary. Especially, it's very hard to find unknown Chinese characters. Before making this application I used Japanese IME 2000 in MS windows 2000. Because, handwriting Chinese character input method is available in Japanese IME 2000. I felt that it was very inconvenient. Threrfore, I decided to make the application to copy & paste the Japanese characters from the games. "Oh! Text Hooker" hooks text related win32 APIs and try to display correct form and lets the user to copy & paste to find a dictionary. ( WOW ) In addition, if the user wants to translate the text into his/her own way, he/she can do that very easily by writing his/her own custom translation plugin. Currently, Oh! Text Hooker supports Japanese-Korean translation ( by ezTrans XP and Babel TOP 2002 ) and Japanese-English translation ( by amikai free web translation service ) plugins. All plugin source codes are available in the doc/plugins directory. HOW TO USE "Oh! Text Hooker" Very simple guide to translate Japanese in the game into English by using Oh! Text Hooker. 1) Make sure your OS is Windows NT/2000/XP/2003 and connected to internet. 2) Download the latest version of Oh! Text Hooker from http://ohhara.sarang.net/ohthk and unzip the compressed file. 3) Execute the Japanese game you want to translate. 4) Execute Oh! Text Hooker ( ohthk.exe ). 5) Select the Japanese game process and click "Attach" button. 6) After Settings dialog shows up, select "jetrans.dll" for the "Translation Plugin". 7) Now, you can see the translated text of Japanese game. Sorry for the lack of English documentation of Oh! Text Hooker. WORKING ENVIRONMENT MS Windows 2000/XP/2003. I didn't test on MS Windows NT. But I think it will be ok. It doesn't support MS Windows 95/98/ME. DON'T TRY. SCREEN SHOTS You can see demo screenshots from doc/scrshots ( Oh! Text Hooker 0.1 ). You can see more demo screenshots from doc/scrshotsa. BUGS I expect there are many bugs in Oh! Text Hooker. Because Oh! Text Hooker is not a normal application but a kind of hacking tool. However, even if you report a bug to me, I can't guarantee the bug is patched soon. Because I don't continue to develop Oh! Text Hooker anymore. BUILD You need Visual C++ 6.0 and cygwin. Cygwin is not used for compiling. It is used for script languages ( awk, sed, and so on ) So I think it's possible to compile without cygwin if you try. I usually use Visual C++ in the command line, so there is no project or workspace file. There are some useless source files because this source tree is what I used before for the other purpose. TODO I wanted to do the following items but I couldn't because I have no time to do it. I want someone to do these stuff. 1) Support windows 9x/ME. I didn't think it was important. However, many people want it. So it is very important. 2) Support emulators. If Oh! Text Hooker hooks the text from emulator such as playstation or pc9801, it will be terrific. 3) Make patches for unsupported games. There are some games Oh! Text Hooker doesn't support. In that case, by making patch file for Oh! Text Hooker, the problem can be solved. There are some patches in util directory. 4) Improve user interface. Many people are saying that the user interface of Oh! Text Hooker is not good. Honestly, I've made Oh! Text Hooker without concerns about user interface. So, need to redesign the user interface. 5) Redesign whole Oh! Text Hooker. The source code of Oh! Text Hooker has becomes complex. And I think it's better to create separate process for Oh! Text Hooker. Now, Oh! Text Hooker thread is created under the target process. ETC If you want to hire me, contact me. ( My major is computer science and engineering and I am majoring in electronic and electrical engineering as my second major. I have an experience to work in a company for three years. I made a sun personal java virtual machine clone and ported CVM to many digital broadcasting STBs in Alticast. I have an experience in the computer security area, too. I can speak Korean, English, and Japanese. For more information, visit http://ohhara.sarang.net ) REFERENCES MSDN Library 2001 Programming Windows Fifth Edition by Charles Petzold Programming Applications for Microsoft Windows Fourth Edition by Jeffrey Richter WARNING DO NOT TRY TO HOOK TEXT FROM VERY IMPOTANT PROCESS. "Oh! Text Hooker" CAN CAUSE A SEVERE PROBLEM. LICENSE See src/prj/ohthk/doc/license.txt. ------------------------------------------------------------------------------ Taeho Oh ( ohhara@postech.edu, ohhara@plus.or.kr ) http://ohhara.sarang.net Postech ( Pohang University of Science and Technology ) http://www.postech.edu PLUS ( Postech Laboratory for Unix Security ) http://www.plus.or.kr ------------------------------------------------------------------------------