cPuTTY - A real cluster solution for PuTTY
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
LICENSE
README.md

README.md

#cPuTTY A real cluster solution for PuTTY

Contents

What the...?
Features
Installing cPuTTY
Working with cPuTTY
Shortcuts
Extended usage
Troubleshooting
Acknowledgements
License

What the...?

Are you one of the poor who have to make the same changes to a file on multiple servers with PuTTY? You don't want to do this manually on each server? You are tired of not working cluster solutions for PuTTY? You are still searching a tool which is a real cluster for PuTTY? Then you should give cPuTTY a try, your search might be over. cPuTTY recognises all keyboard and mouse events which were sent to a PuTTY window and forwards them to all other clustered PuTTY windows. Type character by character once for multiple windows - in real-time!

Features

  • Add PuTTY windows to a cluster, remove them from a cluster or kill the whole cluster with shortcuts
  • All keyboard and mouse events within a cluster are forwarded to all other clustered PuTTY windows
  • Each key and shortcut on your keyboard - even mouse commands (right-click only) - are supported
  • PuTTY forks like FuTTY, KiTTY, PieTTY and TuTTY are also supported
  • Fully support for UNIX commands like vi
  • No additional windows are needed - simply use your existing PuTTY windows
  • Easy to use, works like expected 😄

Installing cPuTTY

  • Download the attached ZIP file of the latest release
  • Execute cputty.exe or cputty_x64.exe (for Windows 64-bit)
  • That's all - cPuTTY is running now!

cPuTTY should work with Windows Vista, Windows 7 and later.

Working with cPuTTY

  • Start cPuTTY
  • Open multiple SHH connections with PuTTY
  • Select a PuTTY window and press Ctrl + Alt + Page Up to add it to the cluster
  • Add other PuTTY windows to the cluster as described above
  • You can add all opened PuTTY windows to the cluster by pressing Ctrl + Alt + Insert
  • Now type something in one of the windows you have added to the cluster and have a look to the other clustered windows
  • Play a bit - everything you do in a clustered window will be imitated by the other clustered windows
  • To remove a window from a cluster, press Ctrl + Alt + Page Down
  • To kill the whole cluster, press Ctrl + Alt + End (if the cluster is empty, this shortcut closes cPuTTY)
  • Press Ctrl + Alt + Home to bring all clustered windows to the top

Shortcuts

Ctrl + Alt + Page Up - Adds the active PuTTY window to the default cluster.
Ctrl + Alt + 0-9 - Adds the active PuTTY window to a cluster group (see extended usage)
Ctrl + Alt + Page Down - Removes the active PuTTY window from its cluster.
Ctrl + Alt + Insert - Adds all opened PuTTY windows to the default cluster.
Ctrl + Alt + Home - Brings all windows from the default cluster to the top.
Ctrl + Alt + End - Removes all windows from the cluster. Closes cPuTTY, if all clusters are empty.

Extended usage

cPuTTY allows up to ten grouped clusters. For example, open four PuTTY windows. For the first both press Ctrl + Alt + 1, for the last both Ctrl + Alt + 2. You have created two standalone clusters. By opening more PuTTY windows and pressing Ctrl + Alt + 0-9 you can easily extend your clusters. Please note, that 0 is the default cluster. This means, Ctrl + Alt + Page Up and Ctrl + Alt + 0 are equal. If a PuTTY window is already clustered, you can move it with Ctrl + Alt + 0-9 to any other cluster. While no PuTTY window is active, press Ctrl + Alt + 0-9 to bring your clusters to the top.

Troubleshooting

My antivirus software detects cPuTTY as a virus.

Ignore it. It's a false positive.

How can I start cPuTTY automatically on windows startup?

Simply create a shortcut of cputty.exe (or cputty_x64.exe) and move it to the autostart folder located in the Windows start menu.

The right-click (pasting things from the clipboard) does not work. What I am doing wrong?

Due to technical reasons the right-click only works for active PuTTY windows. Please activate a PuTTY window before you right-click.

How can I change the default shortcuts of cPuTTY?

Feel free to download the source and to change it - it is all made with AutoHotKey.

I have another question, bug or feature request.

Please use the GitHub Issue Tracker.

Acknowledgements

Special thanks goes to Dean Householder. Your PuTTY Keystroke Sender and finally its source inspired me to develop a improved version of your idea.

License

Copyright (c) 2015 Daniel Prokscha

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.