Logitech G-Key Plugin

[Armada651]

Description

When the beta started the TS team promised native Logitech G-Key support. However this had low priority and there has still been no mention of it, so I decided to take matters into my own hands.

This plugin will allow you to use the G-Key macro keys on Logitech devices to directly control TeamSpeak 3 without rebinding them to other keys. It achieves this by using the debugger functions of the LUA scripting engine in the Logitech drivers.

Features you can control:

• Push-to-talk
• Output/Input mute
• Away status

Don't forget to read the included ReadMe, it explains how to set up your G-Keys to support the plugin. I've tried to make it user friendly, but it might still be hard to set up for beginners. If you're having trouble make a reply and I'll try and help you out.

Downloads

Addon page

ReadMe

Home page
Source code

Compatibility

UPDATE: It seems Logitech is transitioning more and more devices to their Logitech Gaming Software, any device using that software is fully supported by the plugin. If you find any more devices that use that software and are working with the plugin, be sure to post it in this thread so I can update the list below.

Known supported devices

• G11 Keyboard
• G13 Advanced Gameboard
• G15 Keyboard
• G19 Keyboard
• G35 Headset
• G110 Keyboard
• G510 Keyboard
• G930 Headset
• G300 Mouse (instructions)

The plugin only supports Windows as other platforms will require an approach that does not use the Logitech drivers, such as reading raw input from the device.

Troubleshooting

Always make sure the Logitech software is up-to-date and try running TeamSpeak 3 as an administrator if you have UAC on.

Make sure you are using the right TeamSpeak 3 version for your platform. If you're running a 64-bit system you will need a 64-bit client. You can find it on the downloads page.

If the problem still persists report the problem in the thread and please attach the most recent Client Log from "C:\Users\<your username>\AppData\Roaming\TS3Client\logs" this will greatly speed up the troubleshooting process.

[Stefan1200]

Plugin works great on Windows 7 / TS3 rc2-pre 64 bit, thank you.

[Armada651]

I just got into contact with someone who has a G35 headset, I expected it to use the same drivers with script functionality as the keyboards but this is not the case. I'm trying to come up with a solution, but this will require a completely different approach. This will be hard for me to even begin with, since I do not own an G35 headset. There is a dev kit for the G930 though, so it'll be easier to add support for it, but again I don't have access to the hardware to test it. Would anyone like to see support for the G-keys on Logitech headsets?

UPDATE: Version 0.3 has been released, it fixes a crash while you use Push-to-talk when you haven't connected to any server yet.

[christophroeti]

There is a dev kit for the G930 though, so it'll be easier to add support for it, but again I don't have access to the hardware to test it. Would anyone like to see support for the G-keys on Logitech headsets?

YES, Please!!!

[Armada651]

YES, Please!!!

I can add support for it if you can help me test it, I've sent you a PM.

[Inescapable]

is it possible to get this working with G110 "http://www.logitech.com/en-us/gaming/mice-keyboard-combos/devices/5902" or maybe it already works but somehow TS3 dose not support it anymore i have no clue but i cant get it working can someone update the plugin or make another because i would love to have it im running out of buttons to set PTT on

[Armada651]

is it possible to get this working with G110 "http://www.logitech.com/en-us/gaming/mice-keyboard-combos/devices/5902" or maybe it already works but somehow TS3 dose not support it anymore i have no clue but i cant get it working can someone update the plugin or make another because i would love to have it im running out of buttons to set PTT on

Are you running Windows XP by any chance?

[Inescapable]

im running win7

[Armada651]

im running win7

Could you try this version? It fixes an error some users are having on Windows XP.

[Inescapable]

same thing been through all the steps in readme but TS dose not register a button

[Armada651]

same thing been through all the steps in readme but TS dose not register a button

This could have several causes:

• Are you trying to set it as the PTT hotkey in the options? This not necessary, as the plugin will activate PTT itself ignoring any TS3 settings. (You can just clear the PTT hotkey be pressing ESC when assigning a hotkey)
• Have you edited gkey == 1 and mkey == 2 to match your control scheme? (If you want to use G5 when M1 is active you change it to gkey == 5 and mkey == 1)
• Are you sure the script is executed correctly? Try temporarily adding a log message and with the script editor open see if the message is logged when you press the key. Like this:
  

  function OnEvent(event, arg)
      gkey = arg
      mkey = GetMKeyState()
      if event == "G_PRESSED" and gkey == 5 and mkey == 1 then
          OutputDebugMessage("TS3_PTT_ACTIVATE")
          OutputLogMessage("PTT Activated\n")
      end
      if event == "G_RELEASED" and gkey == 5 and mkey == 1 then
          OutputDebugMessage("TS3_PTT_DEACTIVATE")
          OutputLogMessage("PTT Deactivated\n")
      end
  end

  Don't forget to save the script before testing. (Ctrl+S)

[Inescapable]

This could have several causes:

• Are you trying to set it as the PTT hotkey in the options? This not necessary, as the plugin will activate PTT itself ignoring any TS3 settings. (You can just clear the PTT hotkey be pressing ESC when assigning a hotkey)
• Have you edited gkey == 1 and mkey == 2 to match your control scheme? (If you want to use G5 when M1 is active you change it to gkey == 5 and mkey == 1)
• Are you sure the script is executed correctly? Try temporarily adding a log message and with the script editor open see if the message is logged when you press the key. Like this:
  

  function OnEvent(event, arg)
      gkey = arg
      mkey = GetMKeyState()
      if event == "G_PRESSED" and gkey == 5 and mkey == 1 then
          OutputDebugMessage("TS3_PTT_ACTIVATE")
          OutputLogMessage("PTT Activated\n")
      end
      if event == "G_RELEASED" and gkey == 5 and mkey == 1 then
          OutputDebugMessage("TS3_PTT_DEACTIVATE")
          OutputLogMessage("PTT Deactivated\n")
      end
  end

  Don't forget to save the script before testing. (Ctrl+S)

in the script editor i get this

attempt to call a nil value

and in TS ive tried not using any PTT button and with but nothing works for some reason

[Armada651]

in the script editor i get this

and in TS ive tried not using any PTT button and with but nothing works for some reason

Could you show me your script?

[Inescapable]

the one i just put in

function OnEvent(event, arg)
gkey = arg
mkey = GetMKeyState()
if event == "G_PRESSED" and gkey == 7 and mkey == 1 then
OutputDebugMessage("TS3_PTT_ACTIVATE")
OutputLogMessage("PTT Activated\n")
end
if event == "G_RELEASED" and gkey == 7 and mkey == 1 then
OutputDebugMessage("TS3_PTT_DEACTIVATE")
OutputLogMessage("PTT Deactivated\n")
end
end

and the one i use before

function OnEvent(event, arg)
gkey = arg
mkey = GetMKeyState()
if event == "G_PRESSED" and gkey == 7 and mkey == 1 then
OutputDebugMessage("TS3_PTT_ACTIVATE")
end
if event == "G_RELEASED" and gkey == 7 and mkey == 1 then
OutputDebugMessage("TS3_PTT_DEACTIVATE")
end
end

[Armada651]

The script is fine, but that error is definitely not normal. Do you get that error every time you press a key? What version of the drivers are you using? The current one or the legacy one?