# PuTTYTray
PuTTY Tray - Minimizing to the system tray, URL hyperlinking, window transparency, portable sessions and more.
Keywords: putty, tray, ssh, url, hyperlink, hyperlinking, icon, portable, portability, file, save, transparency

# PuTTY Tray

## Project Status

There's an ongoing discussion about the status of this project on Github. Please contribute.

Originally compiled by Barry Haanstra, now maintained by Chris West (Faux).

## Features

- Minimizing to the system tray (on CTRL + minimize, always or directly on startup)
- Icons are customisable
- Blinks tray icon when a bell signal is received
- Configurable window transparency
- URL hyperlinking
- Portability: optionally stores session configuration in files (for example: on a USB drive) like portaPuTTY
- Easy access to the 'always on top' setting (in the system menu)
- Android adb support

## BETA: 0.67-t029 (2016-06-26)

- Fixed: Code signing certificate, and timestamping, valid again; no more certificate errors
- Upgraded to PuTTY 0.67 (2016-03-05), which contains some security hardening, but no relevant security fixes.
- Fixed: #247: Crash if file configuration had been munged by git
- Fixed: #249: Command line length issues with cygcommand and cygterm
- Note: Automatic reconnection is deprecated. It doesn't work. Please disable it.

## BETA: 0.66-t028 (2016-01-23)

- Fixed: #220: Restore compatability with older computers
- Fixed: #229: Pageant remembers confirm mode if it restarts itself
- Fixed: About dialog could fail due to merge error, thanks to theultramage

## BETA: 0.66-t027 (2015-12-13)

A rebuild against PuTTY 0.66 (2015-11-07), fixing a security issue.

## BETA: 0.65-t026 (2015-09-22)

- Fixed: #107: Always show "Reconnect" had been accidentally removed
- Fixed: #93: Clicking links while scrolled would launch totally random bits of the scrollback
- Fixed: #205: Workaround Win10 bug for jumplists, thanks upstream
- New: #203: Support for ssh:// and putty:// fake protocols on the command-line; see the bug for registry entries

## BETA: 0.65-t025 (2015-09-21)

A rebuild against PuTTY 0.65 (2015-07-25), with a new toolchain and options, again without any significant PuTTYTray related fixes.

## BETA: 0.64-t024 (never released)

Never released at all.

## BETA: 0.64-t023 (2015-04-12) (never publicly released)

A test release against 0.64, which fixed some issues and broke many other things.

## BETA: 0.63-t022 (2014-11-09)

- Fixed: #137: Crash on start-up for some users
- Fixed: #158: Start fixing totally totally broken cygterm commands
- Fixed: #163: New TLDs in the default URL regex
- Fixed: #165: Mouse-wheel changes for vim
- Fixed: #167: Pageant tray menu was missing file configs
- Fixed: #168: Fix conf-file parser for some cases
- Fixed: #172: Improve -log behaviour

## BETA: 0.63-t021 (2014-02-25)

- New: URLs submenu, for easier keyboard access. Window -> Behaviour -> System Menu appears on alt+space.
- Fixed: #130: Broken logging/etc. paths with file sessions
- Fixed: #129: Broken full paths in logging
- Fixed: #131: Broken file sessions with folders
- Fixed: #133: Crash instead of error on bad (serial) connections
- Fixed: #136: ADB: Allow saving of host
- Fixed: #125: Error handling for file sessions

## BETA: 0.63-t020 (2013-12-22)

- Fixed: #95: Asserts while loading some keys!
- Fixed: #109: Revert #88, which broke terminal titles for some people
- Fixed: #10: Fiddled with default-settings-from-file(!)
- Fixed: #91: Menu styling
- Fixed: #96: Could generate illegal log paths
- Fixed: #97: -title, -log, etc. from KiTTY
- Fixed: #98: Can now be built with mingw
- Fixed: #106: Missing tray icon after an Explorer crash
- Fixed: #107: Can always restart session
- Fixed: #110: Auto-reconnect in more cases
- Fixed: #115: Paste delay (thanks to thechile!)
- Fixed: #123: Crash with ssh-add --invalid
- Fixed: #112: Can remove broken keys from pageant
- Plus some fiddly code changes, as usual.

## BETA: 0.63-t019 (2013-08-21)

- Fixed: #80: alt-gr broken by default, breaking many people's input languages, sorry!
- Fixed: #81: Old sessions with saved dynamic port forwards wouldn't load properly
- Fixed: #83: pageant showing dialog at boot/login
- Fixed: #74: adb docs and options for prefering usb, emulators, etc.
- Fixed: #82: adb allows adb-wireless style serials with a ":" prefix (hack!)
- Fixed: #88: Attempt to mangle charsets less(?) when setting the terminal title. This is experimental.
- New: Various other usability improvements in adb, e.g. reporting error messages
- New: #86: Left-clicking the pageant tray icon brings up saved sessions
- Plus: other fixes from Philip Moore (FireEgl) and Rubin Xu that I'd missed.

## BETA: 0.63-t018 (2013-08-21)

- Identical to p0.63-t019, oops.

## BETA: 0.63-t017 (2013-08-11)

- New: FaTTY! PuTTYGen and Pageant bundled into the PuTTY download
- New: Automatic login assistance via. ssh keys
- New: #3: URL regex updates
- New: #55: A very bad implementation of ssh-agent's "confirm key usage" for pageant
- Fixed: Settings moved back onto sensible configuration pages
- Fixed: #15: URL mangling with unicode
- Fixed: #28: Wakeup reconnect delay
- Fixed: #61: Truncated files problem goes away with the p0.63 release
- Fixed: #72: Don't hang the settings page for systems with broken username detection
- Plus: about 30 other fixes from various people, especially Philip Moore (FireEgl) and stfnm, and over 300 changes in upstream PuTTY.

## Update: 0.62-t015 (2013-08-06)

- Fixed: #79: backport other security fixes from 0.63
- Note: PuTTY 0.63 has other fixes that may eventually be shown to be security issues, which are not in this release. If you are worried about this kind of thing, you should probably run official PuTTY 0.63 until there is a stable 0.63-derived PuTTYTray release (hopefully within a week!).

## Update: 0.62-t014 (2013-08-05)

- Fixed: #79: CVE-2013-4852: direct backport of hilighted fix for this security issue

## Update: 0.62-t013 (2012-10-25)

- Fixed regression: #51: #50 didn't fully fix #38's break of adb terminals, thanks to ztNFny
- Fixed: adb wouldn't connect to the emulator
- New: #56: xterm bracketed paste mode, thanks to stfnm

## Update: 0.62-t012 (2012-10-10)

- Fixed regression: #50: #38 broke adb terminals, thanks to ztNFny

## Update: 0.62-t011 (2012-10-08)

- Fixed: #42: Some characters would break link detection, thanks to Silver
- Fixed: #41: Crash on URL detection near the lower-right of the terminal
- Fixed: #38: Multiple device support for Android Debug (adb), thanks to YumeYao
- New: #34: Pageant icon

## Update: 0.62-t010 (2012-04-06)

- Fixed: #29: Crash on behaviour tab
- Fixed: #27: Use two rows for connection type menu, thanks to stfnm
- Fixed: #31: Enable jumplists for people using file settings
- Fixed: #6: Compiles under linux (not all functionality present or even applicable)

## Update: 0.62-t009 (2012-03-15)

- Fixed: #20: Invisible icon after flashing tray, thanks to stfnm
- Fixed: #23: Merge adbputty by sztupy, giving Android Debug Bridge support
- Fixed: #24: Behaviour menu would assert if putty.hlp was present, thanks to stfnm

## Update: 0.62-t008 (2012-01-22)

- New: Executables now signed, should (eventually) make IE less angry; no code changes

## Update: 0.62-t007 (2012-01-13)

- Fixed: #2: At least one case of transparent icons
- Fixed: #14: Serial connections giving "Invalid Port"

## Update: 0.62-t006 (2011-12-16)

- New: Now built against PuTTy 0.62, a bugfix release, including security updates
- New: Simplified URL handling support, fixing spotify: urls
- Fixed: #9: Issues with bold fonts and colours

## Update: 0.61-t004 (2011-10-09)

- New: Now built against PuTTy 0.61, getting features like Windows 7 Jumplist and Aero support
- New: Ctrl+mousewheel zoom support
- Fixed: Stupidly huge (256x256) icon for Vista+
- Fixed: URL detection works on URLs ending with )s
- Fixed: Build script generator (mkfiles.pl) now works as expected

## Update: 0.60 (r3) (2011-09-12?)

- New: Load sessions from file using the command line with -loadfile or -file [sessionname]
- New: Added 'always on top' to the system menu
- New: Automatically selects 'sessions from file' when the registry does not contain any sessions
- New: Added option 'reconnect on connection failure'
- New: Default font set to 'Consolas' when using Windows Vista
- Fixed: URL hyperlink bug - preferred browser settings ignored in Windows Vista (thanks Jesper Svennevid)
- Fixed: With 'show tray icon: always' enabled: clicking the tray icon will minimize the PuTTY window if it is open.

## Download

The current version is 0.67-t029.
Last update: 26th June, 2016.

If you have any problems at all, please raise a ticket in the github bug tracker, preferably after trying it in stock PuTTY, and maybe the previous release, thanks!

As Europe is descending into chaos and/or a police-state, I am obliged to ask you please, please not to download, or use, this software if you are a terrorist.

- putty.exe
  SHA256 / GPG (putty.exe) = 31ba5b51450e1b1fd2cc6038ceb107058068519e9535907ab06850ed23c989b3

There is no-longer a separate pageant download, as it is bundled.

- Other downloads, including debug symbols and broken plink build, and older versions

What's that "SHA256/GPG" thing?

- This allows you to increase your confidence that you downloaded the right thing. If your browser tells you you're on https://puttytray.goeswhere.com, and there's no errors about certificates, and your computer asks you if you if you're sure you want to run software made by Christopher West (that's me!), then you're already pretty safe.
- If you're worried that a government is out to get you, however, you can check further. You need GnuPG. There's a problem here, in that it's quite hard to convince yourself that you got the right GnuPG. That problem is best left to your friendly Linux machine, unfortunately.
- With GnuPG (gpg.exe), you can ask it to generate the SHA256 of the file, using gpg --print-md sha256 putty.exe. This should match (ignoring the spaces and new lines) the value you see above.
- To go one step further, you can check that the value you see above is correct. It's signed (in the git tag) with my GnuPG key. Once you're sure you have the right gpg key, you can be sure you've got the right tag, and hence the right hash, and hence the right binary. Phew!

If you are looking for the original version of PuTTY:

- PuTTY download page

## Authors

- Chris West (Faux), the current maintainer
- Barry Haanstra, for the original compilation of PuTTYTray, and this website
- robotslave, for patches
- stfnm, for patches
- sztupy, for adbputty
- Philip Moore (FireEgl), for FuTTY
- Everaldo, for making the beautiful Crystal SVG icon set from which I derived the PuTTY Tray icon
- Samuli Gröhn, for making the NuTTY hyperlink patch
- Jakub Kotrla because he invented the PuTTY File patch
- warp13.co.uk, for the reconnect patch
- dwalin.ru, for parts of the TuTTY session icon code

And, of course,

- Simon Tatham, and the rest of the PuTTY team, for releasing PuTTY in the first place.

Please note:
If this software does not work as expected, eats your PC or kills your cat, you should know that it comes without warranty of any kind. You install it at your own risk.
Also, please do not bother any of the people mentioned above with questions about PuTTY Tray. If it does not work, raise an issue at github, or try the original version.

## Source

github

The source is available from github. The compilation is available under the MIT license, which allows you to do pretty much anything.

See the tag list for tar/zip downloads if you'd prefer not to use git.

There's a guide to building PuTTYTray with Visual Studio 2010 Express, to guide you through getting PuTTYTray to build and run, completely from scratch.

- FauxFaux' PuTTYTray github

If you find a bug or have a feature request, please raise a github issue:

- bug tracker

Please feel free to use the forking and pull-request features of github.