Creating Macros

Introduction to Macros

One of the primary functions of Gnome15, is emitting macros when the G-Keys on your Logitech device are pressed. The macros maybe configured to do a number of things, including :-

  • Sending sequences of keys to currently focussed window as if typed.
  • Emitting single low level keyboard, mouse or joystick presses.
  • Running system commands.
  • Running Gnome15 Actions.

Some other key features of the macro system provide by Gnome15 include :

  • Multiple Macro Profiles
  • Automatic or manual profile activation
  • 3 Memory banks
  • Importing and Exporting of profiles
  • Per-profile plugin activation
  • Assign keyboard backlight colours to memory banks
  • Assign LCD background images to profiles

All of the features will now be described in detail.

Accessing Macro Configuration

All macro configuration is done using the g15-config tool. Start this by either running the command g15-config from a terminal or desktop launcher (such as Alt+F2), or locate the Logitech Keyboard Configuration application launcher in your desktops menu system.

If you have multiple supported keyboards plugged in, you should then choose the device you want to configure macros for.

Finally, go to the Macros tab.


The first concept that should be understood is the Macro Profile. A profile is a grouping of macros that are either active by default, activated when the focussed desktop window changes, or activated manually

When Gnome15 is installed, you will automatically be provided with the Default profile. This profile is made active when no other profile is active. If you only have a few macros you ever want to run (i.e. less than than the number of G keys available), this will probably be all you need.

Memory Banks

Each profile contains 3 macro slots for each macro, one for each of the M Banks (or Memory Banks). An M Bank may be activated by pressing one of the M keys on your keyboard. Then, when you press a G Key, the macro from the current profile and the currently selected bank will be activated.

Creating A New Profile

Simply click on the New button. A dialog box will pop-up asking for a name for the profile. Profile names must be unique. Once created, the profile will be selected and you can then add macros to it (see below).

Once created, you should go to the Information tab and choose an icon and background image for your profile (on supported models). If you are going to share the profile, consider adding your name to the author field.

Importing A Profile

An alternative to creating your own profile is importing one from somewhere else, such as the one you have saved or perhaps downloaded from the Gnome15 profiles thread.

Exporting A Profile

If you wish to save your profiles or share them with others, go to the Information tab and click on Export (alternatively, right-click the profile name in the list). You will be asked for a file location to save the profile to. The file is actually a standard zip archive, and so be manipulated with standard archive tools.

Removing A Profile

Simply right-click the profile in the list and choose Remove. You will be asked to confirm the removal.

Manually Activating A Profile

You may want to manually choose the currently active profile. To do so, right-click the profile in the list and choose Activate.

Locking The Profile

At times you may wish to temporarily suspend the automatic activation of profiles and Lock the current profile. The ensures the profile you choose stays active and will not change until unlocked or another profile is manually selected.

To lock a profile, right-click it in the list and choose Lock.

The reverse of locking the profile is Unlock. When selected, the profile will be unlocked and once again subject to automatic profile selection.

Leave a Reply

%d bloggers like this:
Skip to toolbar