Win Session Manager

A secure, portable RDP, SSH and PowerShell session manager for Windows administrators — with KeePassXC integration for encrypted credential management.

Disclaimer: This project is provided as-is, without any warranty or guarantee of maintenance. Use it at your own risk. Contributions are welcome but there is no commitment to ongoing support or updates.

Features

• RDP, SSH and PowerShell session management in one tool
• KeePassXC integration — credentials are fetched live from your KeePass database, never stored in plain text
• DPAPI encryption — the KeePass master password is encrypted and tied to your Windows login
• Group management — organise hosts in groups, reorder via drag & drop
• Quick search — find any host instantly
• Ping status — live reachability indicator per host
• Documentation URL per host — open wiki pages with one click
• Import / Export — share or back up your host configuration (no passwords included)
• Portable .exe — no installation required

Requirements

• Windows 10 / 11
• KeePassXC (recommended, required for automatic credentials)
  • Browser Integration must be enabled under Tools > Settings > Browser Integration
  • KeePassXC must be running and unlocked when connecting

Getting Started

Option A: Download portable .exe

Download the latest WinSessionManager-portable.exe from the Releases page and run it directly — no installation needed.

Option B: Run from source

Prerequisites: Node.js LTS

git clone https://github.com/JaKoIT/win-session-manager.git
cd win-session-manager
npm install
npm start

Build portable .exe

$env:CSC_IDENTITY_AUTO_DISCOVERY="false"
npm run build

Output: dist\WinSessionManager-portable.exe

KeePassXC Setup

1. Open KeePassXC
2. Go to Tools > Settings > Browser Integration and enable it
3. Launch Win Session Manager — the setup dialog will appear on first run
4. Select your .kdbx file and enter your master password
5. Click Save & Test

When adding a host, search for the KeePass entry name and select it. Credentials are fetched automatically when you connect.

Security

What	How
KeePass master password	DPAPI-encrypted, tied to your Windows login
Host credentials	Never stored — fetched live from KeePassXC
RDP password handoff	Temporary DPAPI-encrypted .rdp file, not persisted
SSH password handoff	Copied to clipboard, cleared after 30 seconds
Config file	%APPDATA%\win-session-manager\hosts.json — contains no passwords

Connection Types

Protocol	Method
RDP	mstsc.exe with DPAPI-encrypted credentials
SSH	Windows OpenSSH — password auto-copied to clipboard
PowerShell	Enter-PSSession via WinRM

Contributing

Contributions, bug reports and feature requests are welcome.
Please open an issue or submit a pull request.

But remember: This project is provided as-is, without any warranty or guarantee of maintenance. Use it at your own risk. Contributions are welcome but there is no commitment to ongoing support or updates.

License

MIT — see LICENSE