Win-KeX Win

Content:

  • Overview

  • Usage

    • Start

    • Start Root Session

    • Session Management

    • Sound Support

    • Multiscreen Support

    • Stop

OverviewWin-KeX in Window Mode will run a Kali Linux desktop session in a separate window.

Window mode helps keeping the Windows and Kali environments visually apart.

Win-KeX utilises TigerVNC for its client and server components.

UsageStart

  • Start Win-KeX as normal user in window mode via: kex --win or simply via kex

  • NOTE: Window mode is the default Win-KeX mode so β€œβ€“win” can be omitted in all commands on this page.

  • You will be prompted to set a vnc server password during first launch. The password can be changed later via

    kex --passwd

    This will start the Win-KeX server and launch the Win-KeX client in full screen mode:

Start Root Session

  • Start Win-KeX as root in window mode via: sudo kex --win

  • You will be prompted to set a vnc server password during first launch. The password can be changed later via

    sudo kex --passwd

    This will start the Win-KeX server as root and launch the Win-KeX client in full screen mode. Note: The Win-KeX client always prompts for the vnc server password when connecting to a root session.

Session Management

  • Pressing β€œF8” will open the client’s context menu, which allows to manage the client sessions, e.g. close the client, switch between full screen and window, etc.)

  • You can disconnect from active sessions by pressing β€œF8” -> β€œExit viewer”, this will close the client but leave the session running in the background

  • You can re-connect to a session by typing kex --win --start-client

Sound Support

  • Win-KeX includes pulse audio support

  • To start Win-KeX with sound support, add --sound or -s, e.g. kex --win -s

  • When starting Win-KeX with sounds support for the first time, ensure to select

    β€œPublic networks”

    when asked for authorisation to allow traffic through the Windows Defender firewall

Multiscreen Support

  • Win-KeX supports mutiscreen setups: Press β€œF8” an go to β€œOptions” -> β€œScreen” then untick β€œEnable full-screen mode over all monitors” & β€œFull screen mode”, move Win-KeX to the desired screen and re-enable full-screen mode

Stop

  • To close the Win-KeX client, press β€œF8” and select β€œExit viewer”

  • To shutdown Win-KeX in window mode, type kex --win --stop

Enjoy Win-KeX!

Last updated