PuTTYCS - PuTTY Command Sender 1.8.1

  • : Function ereg() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/includes/file.inc on line 646.
  • : Function ereg() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/includes/file.inc on line 646.
  • : Function ereg() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/includes/file.inc on line 646.
  • : Function ereg() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/includes/file.inc on line 646.
  • : Function ereg() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/includes/file.inc on line 646.
  • : Function ereg() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/includes/file.inc on line 646.
  • : Function ereg() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/includes/file.inc on line 646.
  • : Function ereg() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/includes/file.inc on line 646.
  • : Function split() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/sites/all/modules/flvmediaplayer/flvmediaplayer.module on line 529.
  • : Function split() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/sites/all/modules/flvmediaplayer/flvmediaplayer.module on line 529.
  • : Function split() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/sites/all/modules/flvmediaplayer/flvmediaplayer.module on line 319.
  • : Function split() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/sites/all/modules/flvmediaplayer/flvmediaplayer.module on line 529.
  • : Function split() is deprecated in /home2/optimoit/public_html/millardsoftware/millardsoftware.com/sites/all/modules/flvmediaplayer/flvmediaplayer.module on line 529.

(C) 2005 - 2008 - Millard Software - jsm174@gmail.com 
Release Date: 02/29/08

VERSION HISTORY
 
02/29/08 - v1.8.1 - Added horizontal and vertical
                    tiling. 
                    Updated tile and cascade to be
                    aware of taskbar. Cascade now 
                    uses entire desktop.               
                    Added additional Post Send delay.
                    [thanks sirandrew]
                    Added --script command line 
                    option.            
                    Rearranged preferences dialog.

                    DOWNLOADS:

                    Standalone - [ANSI] [UNICODE]
                     Installer - [UNICODE]
                        Source - [VC++ 6.0] 


                    Please support PuTTYCS!!!

                    If you like PuTTYCS and would like to
                    support future development:
                    
$5 $10 $20 $30 other
As of 3/4/2008, total donations: $131! 06/21/07 - v1.7 - Added Ctrl-R and Ctrl-D buttons. Added support for any control sequence using {%CTRL%} token in command input Added support for an incremental counter using {%INC%} token in command input Added scroll command history using up/down arrow keys Changed command history right/left buttons to up/down buttons Added support to check for PuTTYCS updates Added support for automatically running on system startup DOWNLOADS: Standalone - [ANSI] [UNICODE] Installer - [UNICODE] 11/20/06 - v1.6 - Added support for PuTTYtel, TuTTY, and PieTTY Added support for user defined cascade size Changed scripting to send CR on last line if Carriage Return is enabled 05/30/06 - v1.5 - Improved system tray logic Added Windows XP style Added close, backspace, and delete buttons 12/21/05 - v1.4a - Fixed password not sending CR 12/19/05 - v1.4 - Added window opacity 12/15/05 - v1.3 - Added minimize to system tray Added tab completion 12/06/05 - v1.2 - Added mouse Copy/Paste emulation Navigation through command history moves cursor to end of command 11/18/05 - v1.1a - Fixed AltGr support 11/17/05 - v1.1 - Added UNICODE support Added clear command history button Added AltGr support 11/07/05 - v1.0 - Initial release ABOUT PuTTYCS is a small windows application that is intended to be used along with multiple instances of PuTTY (including PuTTYtel, TuTTY, and PieTTY). It's purpose is to send the same command to each PuTTY window. It is can be useful for copying files, starting and stopping processes, and examining logs on multiple servers. If you're not familiar with PuTTY, then this tool is probably not for you. If you want to find out more about PuTTY, visit the PuTTY homepage at: http://www.chiark.greenend.org.uk/~sgtatham/putty SCREENSHOTS INSTALLATION PuTTYCS is a simple standalone application. It can be placed and run from anywhere. USAGE Most of PuTTYCS is very self explanatory. You select a PuTTY filter, enter a command, and click the Send button. The command will then be sent to each PuTTY window matching the selected filter. FILTERS A filter is a match to a PuTTY window title. It can contain wildcards (* and ?). A filter can be inclusive, exclusive, or both. An inclusive filter should begin with a plus (+), while an exclusive filter should begin with a minus (-). Multiple filters should be separated with a semi colon (;). For example, take the following servers: www-server1.mydomain.com, www-server2.mydomain.com, www-server3.mydomain.com, www-server4.mydomain.com Note: For this example, these server names are exactly the same as title of the PuTTY window. A filter to represent all of these servers could be written in the following ways: +www-server* +www-server?.mydomain.com +www-server1.mydomain.com;+www-server2.mydomain.com; +www-server3.mydomain.com;+www-server4.mydomain.com; A filter to represent servers 1, 3, and 4 could be written as: +www-server1.mydomain.com;+www-server3.mydomain.com; +www-server4.mydomain.com; +www-server*;-www-server2.mydomain.com +www-server?.mydomain.com;-*server2* You can manage the filters by clicking Filters button. Up to 100 filters can be defined. From the Filters dialog, filters can be created, modified, copied, removed, and re-organized. Add - Adds a PuTTY filter Edit - Edits the selected PuTTY filter Copy - Copies the selected PuTTY filter Remove - Removes the selected PuTTY filter Remove All - Removes all PuTTY filters Move Up - Moves the selected PuTTY filter up the list Move Down - Moves the selected PuTTY filter down the list NOTE: You can not remove, edit, or move the ALL PuTTYs filter. PUTTY ARRANGING Once filters have been defined, PuTTY windows can easily be rearranged. They can be cascaded, tiled, minimized, and even hidden. Just click on the corresponding button. To unhide PuTTY windows, click either the Cascade, Tile, or Minimize buttons. To automatically PuTTY windows, close the Close button. CTRL PuTTYCS supports sending control characters. To send a control character, the {%CTRL%} token followed by the actual control character should be entered in the command input. For example, to send a control-J, the command input would be: {%CTRL%}J The CTRL button will automatically add the {%CTRL%} token at the current position in the command input. INC The {%INC%} token is used to send an incremental counter to each filtered PuTTY window. This may be useful, for example, if you want to copy files with the same name from several servers into one directory with one command (assume the one directory is shared across each server): cp /opt/WebSphere/AppServer6/profiles/app/logs/SystemOut.log ~user/SystemOut{%INC%}.log If you have ten filtered PuTTY windows, after executing the command, ~user will contain: SystemOut1.log SystemOut2.log SystemOut3.log . . . SystemOut10.log The INC button will automatically add the {%INC%} token at the current position in the command input. COMMAND HISTORY PuTTYCS supports a command history up to 100 items. To scroll through the history, use the up and down arrows above the Command input field. Optionally, you can use the up and down arrow keys if "Scroll command history with up/down arrows keys" is checked in the preferences. The close (x) button will prompt you about clearing the command history. CARRIAGE RETURN The carriage return push button is to the right of the command history buttons. When enabled, a carriage return should be sent 1) when the Send button is pressed, and 2) after the last line of a script [see SCRIPT]. This maybe useful if you want to send most of a command and than manually complete it. ARROW PAD The arrow pad sends arrow key presses to PuTTY windows. If your comparing files on multiple servers using VI, you may find this handy. The center dot can be used to send several carriage returns to PuTTY windows. If you're tailing log files and quickly want to clear the screen, you may find this handy. BKSP, DELETE, CTRL-C, CTRL-D, CTRL-R, CTRL-], ESC, ENTER These buttons send the corresponding key press to PuTTY windows. If you use VI, or telnet inside of PuTTY, this may be useful. PASSWORD This button will bring up the Send Password dialog. If you are using PuTTYCS in front of other users, this can be used to protect your password. CAUTION: Make sure all PuTTY windows are waiting for a password! PREFERENCES This button will bring up the Preferences dialog. Preferences are loaded each time PuTTYCS is started. Window: Tool Window Display PuTTYCS as a tool window with the thin title bar. Always on top Display the PuTTYCS on top of all other windows. Minimize to system tray Minimizes PuTTYCS to the system tray. If this is enabled, PuTTYCS can only be exited through the system tray popup menu. Opacity Use the slider to set the opacity for the PuTTYCS window. This maybe useful if PuTTYCS sometimes blocks your existing PuTTY windows. Auto arrange: Off, Cascade, Tile When switching filters, automatically cascade or tile PuTTY windows. Minimize other PuTTYs When auto arranging filtered PuTTY windows, minimize all other PuTTYs. Arrange on startup When starting PuTTYCS, auto arranging filtered PuTTY windows. Unhide PuTTYs on exit Unhides any PuTTYs hidden using the Hide button. Tile method: Vertical, Horizontal, Classic When tiling PuTTY windows use this method. Use Classic to tile like PuTTYCS v1.7 and lower. Cascade dimensions: Sets the dimensions of filtered PuTTY windows when the Cascade button is pressed. Press the Find button to determine the dimensions of the largest visible PuTTY window. NOTE: PuTTYCS only supports cascading dimensions between 98x18 (12x1) and 1042x802 (130x50). Default dimensions are 642x386 (80x24). These dimensions are hardcoded and will not change with system settings. Keyboard/Mouse: Enable Tab ccmpletion Pressing Tab in the command field, sends the command including the Tab key. Useful for file completion in shells like tcsh. Scroll command history with up/down arrow keys Enable this to allow the up and down arrow keys to scroll through the command history. Selection copies, right button pastes Enable this to emulate PuTTY's selection to clipboard, and right mouse button paste feature. Transition delays: (Advanced) Window Sets the amount time (in milliseconds) to pause after focusing a PuTTY window and before sending the command. NOTE: The slower the machine or remote connection, the higher this value should be. Post send Sets the amount time (in milliseconds) to pause after sending a command to a PuTTY window. NOTE: The slower the machine or remote connection, the higher this value should be. Miscellaneous: Save Password Saves the password used in the Send Password dialog. NOTE: Passwords are encoded in Base64 and stored in the PuTTYCS.ini file. This may present a potential security risk. [see CONFIG FILE section] Run on system startup If enabled, adds a registry entry that automatically executes PuTTYCS when the system is started. NOTE: The registry entry is: HKEY_CURRENT_USER\Software\ Microsoft\Windows\CurrentVersion\Run\PuTTYCS Check for updates on startup If enable, PuTTYCS will check for software updates when started. SCRIPT This button can be used to a load a PuTTYCS script. A script can be any text file and should end with a .pcs extension. If you do not want to send a carriage return at the end of the script 1) make sure the last line of the script is not blank, and 2) the Carriage Return button is not enabled. Because the core of PuTTYCS is based on SendKeys in C++, the script should follow the syntax defined by SendKeys. Some features such as application activation have been removed. For more information on the SendKeys syntax, visit the following web site: http://www.codeproject.com/cpp/sendkeys_cpp_Article.asp CONFIG FILE The configuration file is usually stored in the Windows directory: C:\Windows\PuTTYCS.ini COMMAND LINE OPTIONS -s, --script <path> Send a PuTTYCS script. If PuTTYCS is already running, the script will be sent to the current filter, otherwise the script will be sent to the last selected filter. -h, --help Displays the help dialog. KNOWN ISSUES PuTTYCS does not take over full control of a PuTTY window. It only activates a PuTTY window and sends the keystrokes that make up the command. If another application takes over focus, the keystrokes may be directed to it instead. Sending keystrokes to multiple PuTTY windows is usually rather quick so experiencing this problem should be rare. The CAPS LOCK and SHIFT keys should not be pressed while commands are being sent to PuTTY windows. Occasionally when launching PuTTYCS with Arrange on Startup enabled, PuTTYCS will end up behind the newly arranged PuTTY windows. Filters are not checked for uniqueness. Thus you can have the same filter defined more than once. The Filters are scanned in the order they appear in the drop list. Scripting support is extremely poor. It was added as a "nice to have". PuTTY has some different logic for resizing windows. For example, on the Start bar, choose Tile or Cascade. You will see that PuTTY windows do not re-arrange themselves properly. PuTTYCS gets around this by performing a variety of hide, move, resize, and show commands. However, at times, PuTTYs may not arrange as expected. Also, because PuTTY snaps to the text size, Vertical and Horizontal tiling will contain gaps. PuTTYCS officially supports PuTTY. I have support to find PuTTYtel, TuTTY, and PieTTY windows based upon user requests. I can't guarantee they will work as expected. To use Tab completion on several windows, press the Tab key and wait until all windows receive the command. Pressing the Tab key too early may send an additional Tab to one of filtered PuTTY windows. With v1.7+, the Check for Updates uses an API that internally uses Internet Explorer. Thus, if Internet Explorer can reach www.millardsoftware.com, PuTTYCS should be able to as well. However, if it can not, PuTTYCS may appear to freeze for a short time. For the next release, I will try to improve this code, PuTTYCS does not work well with multiple monitors. I have looked into this and it would be extensive rewrite of the code. FUTURE When I first released PuTTYCS, I had no plans on releasing any major updates. However, from all the positive feedback I've received, I have started coding version 2. It is a complete rewrite. Unfortunately, progress is much slower than I would like. The next major version supports tabbing and launching PuTTYs. PuTTYCS still needs a LOGO!! If you can draw and would be interested in designing a logo please contact me!! SOURCE CODE Since PuTTY's source code is available, I'm making this source code available as well. I cleaned it up as best I could, but comments are sparse. It should compile under Visual C++ 6. I LIKE IT If you like this application, drop me a line at jsm174@gmail.com. It's just cool to hear from people around the world! If you really like and use this application, please consider donating. You can use the Paypal link found on the homepage or on the "About PuTTYCS..." dialog. CREDITS PuTTYCS uses source code from SendKey in C++. For more information visit: http://www.codeproject.com/cpp/sendkeys_cpp_Article.asp Base64 encoding and decoding was based on source code found at: http://www.adp-gmbh.ch/cpp/common/base64.html The wildcard compare was based on source code found at: http://www.codeproject.com/string/wildcmp.asp The ANSI version of CommandLineToArgv() can be found at: http://www.koders.com/c/fid63F8E1B505B46BF92349E967A24E3DD1D2BFF72D.aspx Horizontal and vertical tiling routines are based on source code found at: http://source.winehq.org/source/dlls/user32/mdi.c DISCLAIMER Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.