Fragpedal Tutorial: How to add downloaded macros to your IDI Macro Library

Posted by on Jan 13, 2012 in Blog, Support |

Although the Fragpedal comes with an installed set of macros, it is commonplace to share, download, and add macros to your macro library, as well as create them using the MacroBuilder module.

This post explains the simple process to import a new macro to the \macro directory and then place it on a button. 

We’ll start with some introductory information about IDI macros, and then take you step by step through the process to add and use new macros.

What are IDI macros?

IDI Macros are small text files that contain the instructions that the Configurator uses to assign specific “binds” to Fragpedal buttons. Macro files are stored in the \macro directory under the Fragpedal home directory

  • Windows 7 and Vista home directory = C:\Users\Public\Public Hardware\GWS\IDI Device\
  • XP home directory = C:\Program Files\GWS\IDI Device\

Macros exist originally on disc; after assignment to a button, a version of the macro is also stored in memory inside the device. 

  • Once a macro is stored in the Fragpedal’s internal memory, the Fragpedal uses that version of the macro, and does not need the file version on disc.
  • The general preference is to keep the file versions of the macro on disc for convenience so that they can be imported to the Fragpedal on other buttons, in other configurations, and as needed. 

In summary, a macro file on disc is not needed for the Fragpedal operation; they are stored on disc for convenience sake for future binding availability.

I copied a macro into the \macro subdirectory, but it doesn’t appear in the list of macros?  What’s up?

It’s not enough to copy the macro to the macro directory; it must also be “added” to a “macro list” file.

The Configurator is designed to support as many as 30 sets of configuration information for the buttons, these sets being used for different games or applications. 

It could quickly become confusing, if for each configuration, the macro menu displayed all the macros in the macro folder.  The majority of these wouldn’t even work with your particular game and would just clutter the macro list.

Instead, the Configurator supports separate “macro lists” for each configuration to eliminate clutter, so we’ll only need to add the new macro to the appropriate configuration’s “macro list” file for it to display and be assigned to buttons in that configuration slot.

What are “macro list” files and why are they needed?

The “macro list” files are simple tab-delimited spreadsheet files with a .txt file extension (Windows Macros.txt, WOW macros.txt, etc).

These “macro list” spreadsheet files integrate with the Configurator application and are used to populate the “Macro” selection of the Button Assignment menu for the various configuration slots. Macro list files are the means by which your unique user-created content can be seamlessly integrated with the Configurator application.

You can use the same “macro list” file for all your configurations (with the clutter issue described above) or you can create separate “macro list” files (for example “BF3 Macros.txt”) and assign these files to various configuration slots in the Configurator, so that they selectively display macros (in this case only BF3 macros for the BF3 configuration.) Specific “macro list” files you have created and edited are assignable to configurations using the Configuration menu dropdown for each configuration.

What is the default “macro list” file for the Fragpedal?

The default macro list file that comes with the Configurator app is “Windows Macros.txt”.  It lists all the macros that come with the installation.  Many of these macros are sample or example macros or otherwise generally useful. “Windows Macros.txt” is automatically assigned by default to each new configuration you create, so you will have all the macros in the list available for that configuration. 

How would I make a new “macro list” file for a particular game-based configuration?

The easiest way to create new “macro list” files is to copy the default “Windows Macros.txt”; rename it, edit it to include only the appropriate macros, and then assign it to the relevant configuration from the Configuration menu.

Note: Don’t attempt to edit these files from a word processor app; tab-delimited files are best created and edited from a spreadsheet program. 

How do I assign a macro I just copied into the macro folder to a button of my current configuration?

  1. With the Configurator open, and the Fragpedal plugged in, select (click on) the configuration in the configuration list that you want to use the macro with.
  • Unless you have chosen another file, the “macro list” file for this configuration is “Windows Macros.txt.”

  • Of course you can add new macrolist.txt files to the \macro directory, and use the Configuration menu to choose these instead for a configuration; but for this example, we will assume you are simply going to add the new macro to the default “Windows Macros.txt” macro list file, and that this file is active for your configuration.  (Check the Configuration Properties to be sure)
  1. Click on the button label for the button you wish to place the macro on.
  • This will pop open the Button Assignment Menu.
  1. From the Button Assignment Menu, select “Macro”. 
  • This opens the Macro form. 
  1. When the Macro form opens, click on the “Add Macro” button. 
  • This opens the “Add Macro” form.
  1. When the “Add macro” form opens, click on the 2nd field from the top labeled “Code file”. 
  • This will open a file dialog that displays all the macros in the macro directory.
  1. Scroll through the list until you find the new added macro, and select it. 
  • (The new macro into this directory should appear in alphabetical order.) The selection will return you to the “Add Macro” form.
  1. Click on the “Name” field and enter text that names the button the macro will be placed on. 
  • This field is limited to 16 characters, and will display on the top line of the button display for the button.  Without it, you will not have a clue what the button will do, so it’s important to fill in this field.
  1. Click on the Brief Description field, and enter text as desired.
  • This field is limited to 32 characters, and displays as the 2nd line of the button label once the macro is assigned, and gives you a little more information about the macro/button.
  1. Click in the Help field and add explanatory text about the macro. 
  • This information will display when you click on the button and select “Show Button Help” Depending on the macro, it may be very helpful to have strategic info here about how and why the macro/button is to be used.  There is a 1024 character limit to this field (you can copy and paste into it), which is about 2 paragraphs. This is not required, fill in as desired.
  1. With the information fields filled in to your liking, click on the OK button on the Add Macro form.
  • The Add Macro form will disappear, returning you to the Macro form.
  1. On the Macro form, scroll to the bottom of the macro list and select the newly added macro, (the button help text should now appear in the right hand help pane) and click OK on the Macro form.
  • The Macro form will disappear, bringing you back to the home page of the Configurator display and the macro should appear on the button showing the (2) button info text labels as you have entered them.
  1. Click on the highlighted “SAVE” button at the bottom right corner of the Configurator display.
  • The macro is saved to the Fragpedal memory and now ready to use. From now on, because you have once “added” the macro to a “macro list” file, it will appear in the Macro list and be selectable for assignment to buttons.

If you run into any difficulties with the above instructions please feel free to call or email us at office@goodworksystems.com and we’ll be sure to get you set.

 

Customer Service Staff

Gamingmouse.com/Gamingmouse.co.uk