trayTrix

trayTrix Manual

Contributing

The development of trayTrix is driven largely by users like you, so if you discover a bug, have a feature request, or just want to share feedback, please contact me. You can also help by writing a review on the website from which you downloaded it and by telling your friends about trayTrix.

System Requirements

trayTrix runs on Windows 2000, XP, Vista, 7 and 8, both 32 and 64 bit. There are no other special requirements.

Installation, Updating And Uninstalling

Installing

Simply double click the installer file (traytrix_ins.exe) you downloaded to install trayTrix. If you have a 64 bit OS, the 64 bit binary will be installed, else the 32 bit binary will be installed.

Program Updates

You can check the 12Bytes website for new versions of trayTrix, or simply use the built-in automatic or manual update check functions in the Configuration Interface which will retrieve the release notes and offer to download and install a new version when one is available.

When installing a new version, you can usually install over top of your existing installation, however you should always check the release notes for any special instructions.

Uninstalling

You can uninstall trayTrix either through the start menu shortcut or the Windows programs manager.

If you installed trayTrix on your system drive, it will have created an \trayTrix folder in your user application data directory where it stores your settings and and data. You should delete this directory only if you do not intend on installing the program again.

Quick Start Guide

When you start trayTrix, you will see a new icon in the system tray next to your clock. Click the icon to open the trayTrix Toolbar, which contains all of the buttons for running various programs, opening documents, web addresses, etc. Click the Settings button to configure trayTrix.

Configuration and usage

Click the trayTrix icon in the system tray (next to your clock), then click the Settings button to open the Configuration Interface.

Spelling

Spell-check clipboard hotkey: The hotkey used to spell check the contents of the clipboard. The corrected text will be placed back on the clipboard and ready to be pasted into your document.

Spell-check selection hotkey: Pressing this hotkey will copy text that has already been selected in your document. The corrected text will be placed back on the clipboard and ready to be pasted into your document.

Spell-check document hotkey: Pressing this hotkey will automatically select and copy all of the text in your document. The corrected text will be placed back on the clipboard and ready to be pasted into your document.

Auto-paste text for selection and document: Enabling this option will automatically paste the spell-corrected text to the currently focused window.

Toolbar Options

Background color: Set the background color of the Toolbar.

Border color: Set the border color of the Toolbar. If you do not want a border, set the color to the same color as the Toolbar background.

Edit the Toolbar settings: The Toolbar contains all of the buttons to run the built-in programs, as well as those you may have added. You can easily add new buttons or remove those you do not want. See the Editing the Toolbar buttons section below for details.

Program Options

Edit the lookup service providers: The lookup service providers are contained in the list you see when you click the Search button on the Toolbar. You can easily edit the list of providers and add new ones or remove those you do not want. See the Editing the lookup service providers section below for details.

Show logo on startup: Briefly display the trayTrix log when starting the program.

Auto-check for program updates: When enabled, trayTrix will automatically check for a newer version every time you exit the program. If an update is detected, you will be notified the next time you start it.

Base delay time (ms): If you find that all of the text you selected for spell checking is not placed back on the clipboard, try increasing the base delay time in increments of about 50 until the spell checker works as expected.

Editing the lookup service providers

The list is stored in the services.ini file in the trayTrix configuration directory. You can edit the file by clicking the Settings button on the Toolbar, then clicking the Edit but that is associated with the service providers. The services.ini file is a typical “ini” file with the following format:

[SECTION NAME]
KEY NAME=KEY VALUE

In our case, the section name is “[CONFIG]” and is never changed. The key name is the name that will be displayed in the combination control on the Lookup Interface and the key value is the service provider URL. The key names can be anything, but every key name must be unique. The key name and the key value must be separated with an “=” character.

To add a new service, go to the website you want to add and see if they have a search function. For this example, we will use Files Tube. We can see on the Files Tube home page that they have their own search function, so we will want to enter an easily recognizable key word, like “ZZZZ”,  and preform a search. After we submit our query, we see that the the address has changed in our browser address bar to:

http://www.filestube.to/query.html?q=ZZZZ&select=All

Now click the Edit button in the trayTrix Configuration Interface to open the trayTrix File Editor and edit the lookup service providers. Anywhere under the [CONFIG] section, add a new line and enter the name of the service as you want it to appear in the Lookup Interface combination control. Here are a couple of possibilities:

Files Tube
Files (Files Tube)
Files (filestube.to)

This first part is called the “key name” and we must add an “=” after the service name we chose:

Files Tube=

For the key value, we simply paste the URL from our browser address bar:

Files Tube=http://www.filestube.to/query.html?q=ZZZZ&select=All

Lastly, we look for our key word “ZZZZ” in the URL and replace it with “$1”:

Files Tube=http://www.filestube.to/query.html?q=$1&select=All

And we are done! Save the file and exit the Configuration Interface. Now when we open the Toolbar Interface and click the Search button, our new service will be available in the combination control.

To remove a service you do not want, you can either delete the line, or comment it out by prepending it with a semi-colon ( ; ).

Editing the Toolbar buttons

The Toolbar button settings are stored in the toolbar.ini file in the trayTrix configuration directory. You can edit the file by clicking the Settings button on the Toolbar, then clicking the Edit but that is associated with the Toolbar. The toolbar.ini file is a typical “ini” file with the following format:

[SECTION NAME]
; a comment line - lines beginning with a semi-colon are ignored by trayTrix
KEY NAME=KEY VALUE

Following is the syntax for the key/value pairs in the toolbar.ini file. Each key value must contain 3 pipe ( | ) characters and 2 commas. The parts enclosed in square brackets are optional:

[SECTION]
KEY=ICON.ICO/BUTTON LABEL|[ICON TOOL-TIP TEXT]|[HOTKEY]|EXECUTE TYPE,COMMAND,[WORKING DIRECTORY/PARAMETERS]

The explanations for each part follows:

[SECTION]: Each section represents a row of buttons. It does not matter what the names are, as long as each section name is unique (you may want to use names like [ROW1], [ROW2], etc.). The minimum number of rows is 1. The maximum number of buttons you can place on the toolbar is 48. You can have as many rows of buttons as you want and each row may contain as many buttons as you want, as long as total number of buttons does not exceed 48.

KEY: The key name is not important, it is only important that it is present and that each key name within a section is unique.

=: The equals character separates the key name from the key value, which is everything that follows the equals character.

ICON.ICO/BUTTON LABEL: This can be a file name of an icon in the trayTrix\resources\icons\toolbar folder or, if you do not want an image to be displayed on the button, a short text label. You may put your own icons in this folder to be used for your custom button images. See below for more information about the icons and where to get them.

ICON TOOL-TIP TEXT: This is the text that will be displayed when the mouse cursor hovers over the button. You may omit this parameter if you do not want a tool-tip.

HOTKEY: The hotkey you want to use to invoke this function. Hotkeys must be in hex format. Use the conversion utility in the File Editor to convert the hotkey to the proper format. You may omit this parameter if you do not want to set a hotkey for the function.

EXECUTE TYPE,COMMAND,WORKING DIRECTORY/PARAMETERS: This parameter breaks down as follows:

EXECUTE TYPE: The execute type must be either Run or ShellEx. Run is used to run an executable (.exe, .bat, .com, ect.), while ShellEx is used to open a document or address using the default program assigned to handle the file type or address protocol. For example, if you wanted to run Notepad, you would use Run, whereas if you wanted to open a .txt document using the default program for handling the .txt extension, you would use ShellEx.

COMMAND: Must be an executable, file name or web address.

WORKING DIRECTORY/PARAMETERS: If the command Run is used, you may specify the working directory.  if the command ShellEx is used, you may specify the parameters. This parameter is optional.

The execute type, command and the working directory/parameters must be separated with a comma only (no spaces). If you omit a parameter, both commas must still be present.

The only exception to the above is the built-in commands which are assigned to special functions and do not use Run or ShellEx.  these 5 buttons appear in the first row by default, but you can move or swap them with buttons from another row. If you do not want a button for a built-in function to appear, just comment out the line by prepending it with a semi-colon ( ; ).

By default, [ROW1] contains all of the buttons for the built-in functions, but you can move these buttons to another row if you want, or comment out ( ; ) the functions you do not want.

Example Toolbar button code

Here we will create 4 Toolbar buttons; one to run Notepad, another to send an email using our default email client, another to open the trayTrix manual (this web page) with the default browser, and a fourth for opening a text document using the default shell handler for .txt files.

First we will create a new row to add our buttons to, rather than adding them to an existing row. To do this, add the following section name on a new line at the end of the toolbar.ini file, making sure the name is unique:

[ROW2]

Next we create our first key/value pair which will be used to run Notepad, either by clicking the Toolbar button, or by pressing the hotkey combination Ctrl+Alt+N. First, add the following code under the [ROW2] line:

; run Notepad by clicking the toolbar button or by pressing Ctrl+Alt+N - show the hotkey in the tool-tip
1=notepad.ico|Notepad (Ctrl+Alt+N)||Run,notepad.exe,

Next, click in the hotkey conversion box at the top of the editor, press Ctrl+Alt+N, then click the Convert button. The code for the hotkey will be copied to the clipboard, ready to be pasted where our hotkey needs to go:

; run Notepad by clicking the toolbar button or by pressing Ctrl+Alt+N - show the hotkey in the tool-tip
1=notepad.ico|Notepad (Ctrl+Alt+N)|0x064E|Run,notepad.exe,

You will notice that a comma is placed after notepad.exe. Every line of button code must contain 3 pipe characters ( | ) and 2 commas. Although we are not appending any parameters to the Run command,  the last comma must be present.

Next we will create the button code for our email button. To open our default email client, we use ShellEx instead of Run to process the “mailto:” protocol using the default shell handler. Again, although we are not specifying any parameters, the trailing comma after “mailto:” must still be present. Add the new key/value pair below the notepad code:

; send an email by clicking the toolbar button or by pressing Ctrl+Alt+E - no hotkey in the tool-tip
2=email.ico|Email|0x0645|ShellEx,mailto:,

Next we will add the code to open the trayTrix on-line manual (this page). Although we are not specifying a hotkey this time, all 3 of the pipe ( | ) characters must be present:

; open the on-line manual for trayTrix, no hotkey
3=help.ico|trayTrix Manual||ShellEx,http://12bytes.org/software/traytrix,

Lastly we will create the button code to open a text file using the default program for handling the .txt extension. In this case we will omit the icon and the hotkey. In place of the icon we will add a simple text label for the button:

; open a text document with the default shell handler - no icon, no tool-tip, no hotkey
4=My Text File|||ShellEx,C:\mytextfile.txt,

Toolbar button resources

You can create custom Toolbar buttons to do almost anything. In addition to your own ideas, you might find more here.

For the button images, you can create your own, find them on the web, or i can create them for you. All button images must be 64×64 pixel icon (.ico) files. There are many resources for icons, but i like Find Icons because the website is laid out nicely and the selection is large. If you cannot find an icon that you like for your custom button, and it is likely one that others will use, contact me and i will create one for you.

To create your own buttons from scratch, you might want to try Inkscape, which is the software i use to create all the trayTrix button images. Although Inkscape cannot natively export Windows .ico files, there are plenty of utilities that can.

Screen capturing

The Screen Capture utility is a rudimentary utility for capturing a .bmp or .png image of your entire desktop, a portion of the desktop, a program window, or a specific part of a program window. When capturing a window or the whole desktop, it is also possible to capture the mouse cursor.

Capturing part of a program window, also called a “control”, will not work on many cross-platform programs, such as Firefox, Chrome, OpenOffice, etc..

In addition to saving the image to a specified folder, it may also be copied to the clipboard.

Registration

Upon start-up, trayTrix will ask if you want to run the program in demo mode or register it. Most settings and user data will not be saved until the program is registered.

To register trayTrix, click the “Buy Now” button in the “trayTrix – Registration” window when the program is started. A web page will open where you can make your payment using PayPal (typically a PayPal account is not required). After your payment has been processed, restart trayTrix and click the “Verify Registration” button in the “trayTrix – Registration” window. Simply follow the prompts to complete the process.

If you have any problems verifying your registration, there is a possibility that there is a temporary network outage, you are behind a restrictive firewall, or the server itself is down. Wait a while, then try again. If you continue experiencing problems however, please send a support request.

To verify that the program was registered successfully, open the trayTrix Configuration Interface and look for your email address at the bottom of the window.

Support

To report a bug or send feedback, open the Configuration Interface and click the “Feedback” link near the bottom right. This will open the 12Bytes website where you can submit a support request.

If you are reporting a problem, please be as thorough as possible and include a detailed description of the exact steps necessary to reproduce the problem. Also attach any configuration files or screen captures if you suspect it may help troubleshoot the issue.

Licensing

trayTrix is shareware. A license agreement is included in the package you downloaded. You can also view the licensing terms at the 12bytes.org website.