Skip to content

Support for tiling over multiple monitors #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sepich wants to merge 10 commits into
base: master
Choose a base branch
from
Open

Support for tiling over multiple monitors #5

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
72ec358
Support for tiling over multiple monitors
sepich Apr 5, 2015
40bf611
typo fix
sepich Apr 5, 2015
04d5312
Dont tile closed windows still in cluster
sepich Apr 6, 2015
a70feae
Merge branch 'master' of https://github.com/sepich/cputty
sepich Apr 6, 2015
ae7705b
fix for skipped windows when Cluster reorganized
sepich Jun 6, 2015
70bc30a
Merged from PuTTY-Keystroke-Sender
sepich Oct 1, 2016
db30d93
BG jobs optimize
sepich Oct 1, 2016
0c935fe
Ctrl-Alt-Home to summon all the windows :raised_hands:
sepich Oct 1, 2016
0604070
Transparent icon fix
sepich Oct 1, 2016
8bead59
Ctrl-Alt-End to work in Suspend also
sepich Oct 1, 2016
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
*.cmd
*.exe
96 changes: 41 additions & 55 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,79 +1,65 @@
#cPuTTY
A real cluster solution for PuTTY

### Contents
[What the...?](#what-the)
[Features](#features)
[Installing cPuTTY](#installing-cputty)
[Working with cPuTTY](#working-with-cputty)
[Shortcuts](#shortcuts)
[Extended usage](#extended-usage)
[Troubleshooting](#troubleshooting)
[Acknowledgements](#acknowledgements)
[License](#license)
#cPuTTY
A real cluster solution for PuTTY.
Furter development of:
- https://github.com/deanhouseholder/PuTTY-Keystroke-Sender
- https://github.com/dprokscha/cputty

### 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!
Are you one of the poor who have to make the same changes 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
* Add PuTTY windows to a numbered 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
* PuTTY forks like FuTTY, KiTTY, PieTTY and TuTTY are supported. Also including MinTTY.
* Tile PuTTY windows over (multiple) monitors
* Fully support for UNIX commands like ``vi``
* No additional windows are needed - simply use your existing PuTTY windows
* Easy to use, works like expected :smile:
* It should work with Windows Vista, Windows 7 and later

### Installing cPuTTY
* Download the attached ZIP file of [the latest release](https://github.com/dprokscha/cputty/releases)
* Execute *cputty.exe* or *cputty_x64.exe* (for Windows 64-bit)
* That's all - cPuTTY is running now!
### Download
* Download compiled binary in [Releases](https://github.com/sepich/cputty/releases) section
* Or run from sources via [AutoHotKey](https://github.com/Lexikos/AutoHotkey_L)
* No installation needed

cPuTTY should work with Windows Vista, Windows 7 and later.
### Shortcuts
``Ctrl`` + ``Alt`` + ``1-4`` - Tile windows over 1-4 monitors
``Ctrl`` + ``Alt`` + ``5-0`` - Adds the active PuTTY window to a cluster group (see [extended usage](#extended-usage))
``Ctrl`` + ``Alt`` + ``Page Down`` - Stop sending events to other windows
``Ctrl`` + ``Alt`` + ``Page Up`` - Resumes event sending
``Ctrl`` + ``Alt`` + ``Home`` - Brings all windows from all clusters to the top
``Ctrl`` + ``Alt`` + ``End`` - Removes windows from current cluster. Closes cPuTTY, if all clusters are empty.
``Win`` + ``W`` - Auto-enter saved text (password). On first run asks for the text
``Alt`` + ``G`` - Reload cPuTTY

### 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)
* Start cPuTTY, it would sit in System Tray
* Open multiple PuTTY windows
* They would automatically added to default cluster (0), and have this number added to Window Title
* To tile/align all windows on one screen by pressing ``Ctrl`` + ``Alt`` + ``1``
* To move some windows to another cluster, select the window and press ``Ctrl`` + ``Alt`` + ``5-9``
* Now type something in one of the windows you have added to the cluster and have a look to the other windows of the same cluster
* To temporary stop replicating events, press ``Ctrl`` + ``Alt`` + ``Page Down``. System Tray icon would change to lock. To resume press ``Ctrl`` + ``Alt`` + ``Page Up``
* 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](#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.
cPuTTY allows up to six grouped clusters. For example, open four PuTTY windows. For the first both press ``Ctrl`` + ``Alt`` + ``9``, for the last both ``Ctrl`` + ``Alt`` + ``5``. You have created two standalone clusters. By opening more PuTTY windows and pressing ``Ctrl`` + ``Alt`` + ``5-0`` you can easily extend your clusters. Please note, that ``0`` is the default cluster. This means that newly opened windows would be automatically added to it. If a PuTTY window is already clustered, you can move it with ``Ctrl`` + ``Alt`` + ``5-0`` to any other cluster. While no PuTTY window is active, press ``Ctrl`` + ``Alt`` + ``5-0`` to bring your clusters to the top.

### Troubleshooting
##### My antivirus software detects cPuTTY as a virus.
Ignore it. It's a false positive.
AutoHotKey sometimes being marked as a virus. In case precompiled binary looks unsafe for you - run cPuTTY as ahk script.
##### 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.
Simply create a shortcut of *cputty.exe* and move it to the autostart folder located in the Windows start menu.
##### How can I change the default shortcuts of cPuTTY?
Feel free to [download the source](src/cputty.ahk) and to change it - it is all made with [AutoHotKey](https://github.com/Lexikos/AutoHotkey_L).
##### I have another question, bug or feature request.
Please use the [GitHub Issue Tracker](https://github.com/dprokscha/cputty/issues).
Please use the [GitHub Issue Tracker](https://github.com/sepich/cputty/issues).

### Acknowledgements
Special thanks goes to [Dean Householder](http://www.deanhouseholder.com/). Your [PuTTY Keystroke Sender](http://www.deanhouseholder.com/projects/putty-keystroke-sender/) and finally its [source](http://www.autohotkey.com/board/topic/84935-send-keystrokes-to-multiple-windows/?p=541210) 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.
Thanks to the original [dprokscha/cputty](https://github.com/dprokscha/cputty) and [deanhouseholder/PuTTY-Keystroke-Sender](https://github.com/deanhouseholder/PuTTY-Keystroke-Sender)
Changes are:
- Windows tiling/aligning
- Auto-enter saved text
- Fixed: Right click to non active window
- Fixed: Win-<x> shortcuts leave <x> typed in other windows
- Fixed: Shift-Ins paste correctly to all windows
Loading