mirror of
https://github.com/mintty/wsltty.git
synced 2025-01-31 02:01:01 +00:00
41 lines
2.2 KiB
Markdown
41 lines
2.2 KiB
Markdown
Mintty as a terminal for Bash on Ubuntu on Windows / WSL.
|
||
|
||
### Overview ###
|
||
|
||
Run the [installer](https://github.com/mintty/wsltty/releases) to install
|
||
* wsltty package components (see below) in the user’s application directory (where WSL is also installed)
|
||
* an empty wsltty “home directory” to enable storage of a mintty config file
|
||
* 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
|
||
* context menu entries for Windows Explorer to start WSL with a bash in the respective directory
|
||
* a script `wsl.bat` to invoke wsltty manually; copy the script from `%LOCALAPPDATA%\wsltty` to `%SYSTEMROOT%\System32` if desired
|
||
* an uninstall script that can be invoked manually to remove shortcuts and context menu entries
|
||
|
||
### 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 ###
|
||
|
||
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).
|
||
|