mirror of
				https://github.com/mintty/wsltty.git
				synced 2025-10-30 22:54:03 +00:00 
			
		
		
		
	
			
				
					
						
					
					1106032955b987806f6c6e17f526935b6e079407
				
			
			
		
	Mintty as a terminal for Bash on Ubuntu on Windows / WSL.
Overview
Run the installer 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 cdcommand to your Linux$HOME/.profilescript
- context menu entries for Windows Explorer to start WSL with a bash in the respective directory
- a script wsl.batto invoke wsltty manually; copy the script from%LOCALAPPDATA%\wslttyto%SYSTEMROOT%\System32if 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%\wslttyinto%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 -lparameter.
- To enforce starting in your Linux home directory, do either of:
- On Linux side, add a cdcommand to your$HOME/.profile.
- In the script (or a copy for this purpose), add -C~as first parameter ofwslbridge:... /bin/wslbridge -C~ -t /bin/bash -l.
 
- On Linux side, add a 
Desktop shortcut and Start menu shortcut
To enforce starting in your Linux home directory, do either of:
- On Linux side, add a cdcommand to your$HOME/.profile.
- Open Shortcut Properties; in the Target, add -C~as first parameter ofwslbridge:... /bin/wslbridge -C~ -t /bin/bash -l.
Components
For mintty, see the Mintty homepage.
It is based on Cygwin and includes its runtime library (sources).
For interacting with WSL, it uses wslbridge.
Description
				
					Languages
				
				
								
								
									C
								
								38.5%
							
						
							
								
								
									Shell
								
								23.4%
							
						
							
								
								
									Makefile
								
								19.7%
							
						
							
								
								
									Batchfile
								
								14.6%
							
						
							
								
								
									VBScript
								
								3.8%