2016-09-14 14:55:14 +02:00
Mintty as a terminal for Bash on Ubuntu on Windows / WSL.
2016-09-29 14:53:19 +02:00
### Overview ###
2016-09-14 14:55:14 +02:00
2016-09-16 12:50:22 +02:00
Run the [installer ](https://github.com/mintty/wsltty/releases ) to install
2016-09-14 14:55:14 +02:00
* wsltty package components (see below) in the user’
2016-09-18 12:06:23 +02:00
* an empty wsltty “home directory” to enable storage of a mintty config file
2016-09-19 00:46:51 +02:00
* a Desktop Shortcut and a Start Menu Shortcut to start WSL with a login bash in the *Windows user profile* directory; to start in the Linux home directory instead, add a `cd` command to your Linux `$HOME/.profile` script
2016-09-14 14:55:14 +02:00
* context menu entries for Windows Explorer to start WSL with a bash in the respective directory
2016-09-19 00:46:51 +02:00
* a script `wsl.bat` to invoke wsltty manually; copy the script from `%LOCALAPPDATA%\wsltty` to `%SYSTEMROOT%\System32` if desired
2016-09-18 12:06:23 +02:00
* an uninstall script that can be invoked manually to remove shortcuts and context menu entries
2016-09-14 14:55:14 +02:00
2016-09-29 14:53:19 +02:00
### Configuration ###
#### Command line script wsl.bat ####
* To enable invocation of this script from WIN+R or from cmd.exe,
copy it from `%LOCALAPPDATA%\wsltty` into `%SYSTEMROOT%\System32` .
(The package does not do this to avoid trouble with missing admin privileges.)
* To start the terminal in the current directory when calling the script from the command line,
modify it (or a copy for this purpose) and remove the final `-l` parameter.
* To enforce starting in your Linux home directory, do *either* of:
* On Linux side, add a `cd` command to your `$HOME/.profile` .
* In the script (or a copy for this purpose), add `-C~` as first parameter of `wslbridge` : `... /bin/wslbridge -C~ -t /bin/bash -l` .
#### Desktop shortcut and Start menu shortcut ####
To enforce starting in your Linux home directory, do *either* of:
* On Linux side, add a `cd` command to your `$HOME/.profile` .
* Open Shortcut Properties; in the Target, add `-C~` as first parameter of `wslbridge` : `... /bin/wslbridge -C~ -t /bin/bash -l` .
### Components ###
2016-09-14 14:55:14 +02:00
For mintty, see the [Mintty homepage ](http://mintty.github.io/ ).
It is based on [Cygwin ](http://cygwin.com )
and includes its runtime library ([sources ](http://mirrors.dotsrc.org/cygwin/x86/release/cygwin )).
For interacting with WSL, it uses [wslbridge ](https://github.com/rprichard/wslbridge ).
