Content

Record Macro

Introduction

What -- Record Macro is an exciting new feature in KoalaTerm 4.1. It can automatically record all your typings, actions, be it normal characters, or function keys as a KoalaTerm script, and play back exactly as what you have done on your current session.

Why -- Macro is designed for saving your time in having to learn writing scripts, thus make your terminal session much more efficient and convenient! Although previous KoalaTerm version has the most capable script in the toolbar facilities among all terminal emulators, it often takes some time for a terminal user to learn how to write those scripts. Now with this new macro recording feature, you don't need to write a single line of script.

How-- When you want to record the macro in the current session, just press the MACRO button on the toolbar, do what you would normally do to finish some tasks, press the MACRO button again, then all your operations on this session have been recorded as KoalaTerm script. Then you can save this generated script to a customized button or a mapped key, or copy to clipboard and paste into another application. Later on, if you want to repeat what you have done, just press the designed button or mapped key, And miracle occurs, all that you have done is automatically being performed on the screen, no need your even a single typing.

Save and Play the MACRO

After your macro has been recorded as KoalaTerm Script, you must select a way to save the created script first, you can play it back thereafter. There are totally three ways to save the macro : Save to Button, Save to Mapped Key and Copy to Clipboard.

Save to a Customized Button and Play it

After you have finished recording the macro, click the MACRO button on the toolbar, then on the pop-up box (see the fig. below), follow the steps below:

1. Check Save to Button on the left side,
2. From the drop-down list, select a Button# for the script.
3. In the Button Caption, specify a title for this button.
4. Click OK to finish and close the box.
5. On the current session screen, if there is no button palette displayed, click View menu, click Button Palette to show.
6. Now on the Button# selected on step 2, you should see a button with the name specified on step 3. Just click this button. And the whole operating procedures you have done is being executed on your screen.

Note:

• For button palette reference, please refer to BUTTON SETTINGS in SETTINGS page.
• If you want to view or edit the script, click Edit Script on the bottom
• If you hope to retain the macro, you can use "Save" menu to save the current session into the directory, then later on you can open this session file, and continue using the macro.

Save to Mapped Key and Play it

After you have finished recording the macro, click the MACRO button on the toolbar, then on the pop-up box (see the fig. below), follow the steps below:

1. Check Save to Mapped Key on the left side.
2. From the drop-down list, select an item or a combination item as a mapped key.
3. Click OK to finish and close the box.
4. On the current session, just press the mapped key specified in step 2. And the whole operating procedures you have done is being executed on your screen.

Note:
• When you select items other than character, the "text typing box" next to it will be dimmed.
• The Character can be any numbers or keys.
• You can select an item plus "CTRL , ALT or SHIFT" to generate a combination mapped key.
• If you want to view or edit the script, click Edit Script on the bottom
• If you hope to retain the macro, you can use "Save" menu to save the current session into the directory, then later on you can open this session file, and continue using the macro.

Copy to Clipboard

After you have finished recording the macro, click the MACRO button on the toolbar, then on the pop-up box (see the fig. below), follow the the steps below:

1. Check Copy to Clipboard on the left side.
2. Click OK to finish and close the box.
3. On the current session, click Paste button, and the script recorded by macro is printed on your screen. Or you can paste the script into another editable application, and save it for later references.

Note: Use this way to save macro, you can only save the script created by macro, not possible play the operating procedures as the above two ways.