Version: 3.01.00.228 Date: 2005.10.01 by Tometheus
Why am I here?
If you arrived here after launching TrillKey that means you didn't supply a command-line parameter to TrillKey.
Read the documentation for instructions on how to set it up.
TrillKey is a stand-alone program to perform certain operations in Trillian. (Useful for making HotKeys.) This has only been extensively tested in Trillian v0.7x and 3.0 (Basic and Pro). Since Cerulean Studios has not released an official EXTERNAL API yet, this isn't guaranteed to work with any other versions. It will NOT work with versions before 0.70. (There is an older version for use in Trillian 0.63 if, for some reason, you want that.) Unfortunately, since TrillKey is a stand-alone program and not a plugin, it will only work with one copy of Trillian loaded in memory (for now).
NOTE: This is NOT a Trillian plugin. Do NOT try to load it in the plugin section.
There are several ways you can use TrillKey. 1) set up an advanced event in Trillian. (AKA 'Automation') 2) create a shortcut to TrillKey with whatever arguments you want in the target / command line. 3) run it from the run dialog in windows. Use a hotkey program like WinKey
To set up an event in Trillian 0.7-2.0 go to:
preferences --> events --> advanced --> new
To set up an event in Trillian 3.0 go to
preferences --> advanced preferences --> automation --> add --> automation
event type: hotkey
action type: execute program
program: TrillKey of course :)
parameters: see below
As of TrillKey 3.00.00, multiple commands can be sent to TrillKey at once. To facilitate this, the 'delay' command was added to allow a pause between commands.
Usage: TRILLKEY [active] <command> [<modifier>]
| Command | Modifier | Description |
| active | NEW: Only perform the following commands if a Trillian window is the active window | |
| delay | <secs> | NEW: Add a delay between commands |
| ident | NEW: My Identity Information | |
| history | NEW: My Activity History | |
| alerts | NEW: Toggle systray alerts | |
| help | NEW: Trillian Help | |
| awaymsg | "message" | NEW: Set away message. (Message is required.) Surround the message with quotes ("") |
| awayedit | Away Messages Preferences | |
| away+ | Add Away Message | |
| preferences | Preferences | |
| connect | Connection manager | |
| reconnect | Reconnect globally | |
| disconnect | Disconnect globally | |
| sound | Toggle global sounds | |
| top | Toggle GLOBAL 'Always on Top' (see AOT command below for per-window setting) | |
| togglebuddy | Toggle buddy list | |
| showbuddy | Bring Buddy List to foreground | |
| exit | Exit Trillian (must be the last command) (for the delayed exit like earlier versions, use the new delay command: TRILLKEY delay <secs> exit | |
| launch | -l<file> | Launches Trillian or does nothing if Trillian already started -Looks for trillian.exe in the current folder or uses Trillian's registry entry or looks for the default install path NEW: TrillKey launch -l<file> will launch whatever file you specify if Trillian isn't started already |
| winamp | start/stop winamp and toggle Trillian sounds | |
| dock | Toggle Docking (No longer works in 3.0) | |
| dock | -d[top/bot/left/right/o] | Docking position ('o' toggles docking) (No longer works in 3.0) |
| offline | Toggle offline contacts (No longer works in 3.0) | |
| send | [medium] [name] | Opens a message window to [name] temporarily disabled in 3.0 while I figure out a new way to do it |
Usage: TRILLKEY [active] <command> <window class> [<modifier>]
| Command | Modifier | Description |
| active | NEW: Only perform the following commands if a Trillian window is the active window | |
| aot | -on -off -default -toggle | Set 'Always on Top' setting |
| show/restore | show window(s) | |
| hide | hide window(s) NOTE: Trillian won't show these windows using Trillian's View menu once they're hidden. To show these windows, either use TrillKey's 'show' command or a skin that has a 'You're On' (connections) control on the contact list. | |
| toggle | NEW: shows / hides window(s) based on whether more of the windows were hidden or visible. | |
| minimize | minimize window(s) | |
| trans | <percent> | set transparency on window(s) (rounds to the nearest 10%). Leave modifier blank to turn transparency off. |
| timestamp | -on -off -default | Turn on/off timestamping |
| clickthrough | <percent> | toggle clickthrough (*) Now with an optional transparency percent. (Transparency isn't optional, but the modifier is optional.) Note, this is best used with the desired window set to always-on-top. You can get back to the window by using alt-tab. |
| multiim | send messages to multiple windows (**) | |
| Window Class | ||
| all | Do command on all recognized open windows | |
| forceall | Force TrillKey to do command on all Trillian windows (i.e. the 'all' behavior of previous versions) | |
| buddy (contact) | Do command on the contact list | |
| private (message) | Do command on all open private message windows | |
| channel (chat) (conference) | Do command on all open channels (AKA group chats/conferences) | |
| file (transfer) | Do command on all file transfer windows | |
| container | <name> | Do command on all containers If <name> is provided, it performs command only on container specified (can be 'current') |
| current | Do command on the current window | |
| console | Do command on all open consoles |
examples: TRILLKEY hide private - hides all private message windows
TRILLKEY trans all 50 - sets all windows to 50% transparency
TRILLKEY time channel on - turns timestamp on on all channels
TRILLKEY multiim private - sends to all private message windows
TRILLKEY multiim container IRC - sends to all windows in 'IRC'
What is a TrillKey?
A 'trill key' is a real device found on
certain wind instruments. I used to want to be a clarinet/sax player :) I thought the name was appropriate for
a program to make hotkeys for Trillian features.
TrillKey by Tom Elmer <twelmerii@usa.net>, © 2001 - 2005
Webpage: http://tometheus.com/Trillian#TRILLKEY
Mailing List: http://groups.yahoo.com/group/trillkey/.
TrillKey icon designed by Kid at DesignHazard
Trillian by Cerulean Studios © 1999 - 2005
Clickthrough is a feature that allows you to set a window on top of everything, set it with a level of transparency, and work with windows underneath it as if the top window didn't exist. NOTE: Only works in win2k/XP
OK, this is a feature I designed to send messages to multiple people/channels, before Cerulean Studios added Mass Messaging to Trillian 1.0. Note that this version of mass messaging allows you to send messages to channels as well as contacts. Also, it will send the message to any window you can open. (So you can still send messages to offline contacts too on mediums that support offline messages.) This method requires you to open windows to the people you want to message as opposed to selecting them on the contact list like CS's method uses. (This was basically a way to prevent spamming.)
For an example, I use ctrl-alt-enter to send a message to all private message windows and ctrl-shift-enter to send a message to all channel windows.
3.01.00 (2005.10.01)
Fixed: Problem where the delay option was causing 100% CPU usage on some systems.
3.00.02
Added: Window type - 'file' transfer
Added: Per-window Always on Top setting ("aot")
Modified: Clickthrough now also sets the window to always-on-top
Modified: timestamp now uses '-' in front of the modifier
3.00.01
Now with an installer!
Modified: Made 'clickthrough' a little more foolproof by forcing a transparency set, added optional modifier to set the level.
Modified: Commands on 'all' windows no longer operate on unrecognized windows.
Added: 'forceall' window type forces TrillKey to operate on all Trillian windows (i.e. use the 'all' behavior of previous versions)
Added: 'toggle' toggles the hidden state of the specified windows (checks if more windows are visible or hidden.)
Added: 'message' as an alias for 'private' and 'chat' / 'conference' as aliases for 'channel'.
Fixed: bug with -l not being skipped in the launch command if Trillian was loaded.
Fixed: Current container commands should work if a container is (somehow) set AOT.
3.00.00
Added: Can now supply multiple commands
Added: active - only perform the following commands if the user is currently in a Trillian window.
Added: delay - adds a delay between commands.
Added: awaymsg - Set the away message to a custom string
Added: help - Trillian help
Added: ident - (3.0) My Identity Information
Added: alerts - Toggle Systray Alerts
Added: history - (3.0) My Activity History
Added: Throws away first argument if it is 'TrillKey'. (For all those who couldn't figure it out)
Added: Launch now looks in the default Trillian install directory also.
Changed: Should be unicode friendly now
Changed: Command line supports quoted arguments
Changed: 'Current' window detection uses GetForegroundWindow rather than the top of the z-order (fixes problems with always-on-top windows)
Changed: a few modifiers use a '-modifier' format now to make multiple commands easier.
Changed: New icon designed by Kid
Fixed: support for 2.0+ message windows (and containers)
Fixed: Multi-IM for 2.0+
Fixed: support for 3.0 contact lists without an iconholder
Disabled: Send message (need to figure out the new way to do it in 3.0)
Disabled: toggle offline contacts message no longer works in 3.0
Disabled: docking commands no longer work in 3.0
Uses a new icon made by Kid
2.0 (unreleased)
Added option to LAUNCH alternate program (i.e. TAB)
Started work on 2.0 window support.
0.725
.13 send [aim/icq/yahoo/msn/irc] [name] Opens a message window to [name]
Start/stop winamp & toggle Trillian sounds
.12 revived global away/back
added container name functionality
timestamp works in containers & with always-on-top contacts
changed container MultiIM functionality...
must specify 'current' or a name to send to only one container
with the above change, multiim all and multiim current should work correctly
added 'attach' command
.11 Docking re-enabled, stabilized (toggle offline contacts stabilized also)
.10 Now WORKS WITH ALL SKINS!
(Just don't name your chatroom or container '<something> console')
Also, made the parameter identification a little looser
- most commands can be shortened to 3 or 4 letters
MULTI-IM feature
.04 Option to send messages to windows in containers
.03 Sends <RETURN> directly to window rather than to keyboard stream
.02 fixed to work when contact list is always-on-top
Thanks to Arguile for helping me test this...
.00 Turn TIMESTAMP on/of/default
changed createprocess to ShellExecute
0.724
LAUNCH no longer requires being in the Trillian directory. (uses registry entry)
BUGFIX: I hate it when I mess up... Half of the options were disabled when a flag
was set incorrectly
Added MINIMIZE option. (Maximize doesn't work due to Trillian's handling of it.)
Changed system() to createprocess() to avoid that pesky command window.
Cleaned up documentation a bit.
TrillKey w/o arguments now launches trillkey.txt instead of the information window.
BUGFIX: Contact list options didn't work in most skins after 0.71.06 (my fault :) )
Toggle CLICKTHROUGH on windows (works with transparencies in Win2k / XP)
0.71.06
Toggle DOCKING, change docking positions
Set TRANSPARENCY on buddy list
Time delayed Trillian EXIT
Toggle OFFLINE CONTACTS
Features only available for BlueTurtle, MdXP v6.9+, or modified skins:
Ability to hide, show, and set transparency on all Trillian windows, all windows
of a certain class (i.e. all message windows), or only on the current window.
0.71.05
Toggle SOUNDS
Toggle BUDDY LIST
SHOW/HIDE buddy list
LAUNCH Trillian (or do nothing if already launched)
0.6x
Bring up PREFERENCES
Edit AWAY MESSAGES
Bring up CONNECTION MANAGER
RECONNECT / DISCONNECT globally
Toggle "ALWAYS ON TOP"