mirror of
				https://github.com/mintty/wsltty.git
				synced 2025-11-04 09:01:52 +00:00 
			
		
		
		
	Compare commits
	
		
			9 Commits
		
	
	
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| 
						 | 
					449a310d90 | ||
| 
						 | 
					87aa168b41 | ||
| 
						 | 
					9de7d8d6f1 | ||
| 
						 | 
					c91ec886b5 | ||
| 
						 | 
					4caa2c34eb | ||
| 
						 | 
					73fcc66790 | ||
| 
						 | 
					5cee2c341b | ||
| 
						 | 
					ea570a191e | ||
| 
						 | 
					2dd099265d | 
@@ -1,4 +1,4 @@
 | 
			
		||||
mintty is copyright 2008-13 Andy Koppe, 2015-22 Thomas Wolff.
 | 
			
		||||
mintty is copyright 2008-22 Andy Koppe, 2015-22 Thomas Wolff.
 | 
			
		||||
 | 
			
		||||
Licensed under the terms of the GNU General Public License version 3 or later,
 | 
			
		||||
amended with the bundling clause to clarify ambiguous interpretation.
 | 
			
		||||
 
 | 
			
		||||
							
								
								
									
										30
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										30
									
								
								README.md
									
									
									
									
									
								
							@@ -35,11 +35,23 @@ You may need to open the Properties of the installer first, tab “General”
 | 
			
		||||
section “Security” (if available) and select “Unblock”, 
 | 
			
		||||
to enable the “Run anyway” button.
 | 
			
		||||
 | 
			
		||||
#### WSLtty Portable installer
 | 
			
		||||
 | 
			
		||||
For a portable installation, e.g. on a USB stick, choose the 
 | 
			
		||||
“-install-portable.exe” file for download. Installation will prompt 
 | 
			
		||||
for a portable installation folder interactively. 
 | 
			
		||||
For example, choosing `U:\opt` will create and use folder 
 | 
			
		||||
`U:\opt\wsltty` both as installation directory and configuration directory.
 | 
			
		||||
Portable installation does not install any start menu or desktop shortcuts 
 | 
			
		||||
and no context menu entries. It creates a shortcut in the selected 
 | 
			
		||||
portable installation folder to start the default WSL distribution.
 | 
			
		||||
 | 
			
		||||
#### Installation from archive ####
 | 
			
		||||
 | 
			
		||||
In case a local anti-virus guard barfs about the wsltty installer, the 
 | 
			
		||||
release also contains a `.cab` file. Download it, open it, extract its files 
 | 
			
		||||
to some temporary deployment directory, and invoke `install.bat` from there.
 | 
			
		||||
to some temporary deployment directory, and invoke `install.bat` from there, 
 | 
			
		||||
or `install-portable.bat` for a portable installation.
 | 
			
		||||
 | 
			
		||||
#### Installation from source repository ####
 | 
			
		||||
 | 
			
		||||
@@ -62,14 +74,20 @@ the optional second parameter designates the configuration directory.
 | 
			
		||||
 | 
			
		||||
### Installation with other package management environments ###
 | 
			
		||||
 | 
			
		||||
Note that these are 3rd-party contributions and do not necessarily 
 | 
			
		||||
provide the latest version.
 | 
			
		||||
Note: These are 3rd-party packages, not managed by this repository.
 | 
			
		||||
 | 
			
		||||
#### Windows Package Manager ####
 | 
			
		||||
 | 
			
		||||
To install wsltty from the 
 | 
			
		||||
[Windows Package Manager Community Repository](https://github.com/microsoft/winget-pkgs), 
 | 
			
		||||
invoke one of
 | 
			
		||||
* `winget install wsltty`
 | 
			
		||||
* `winget upgrade wsltty`
 | 
			
		||||
 | 
			
		||||
#### Chocolatey ####
 | 
			
		||||
 | 
			
		||||
If you use the [Chocolatey package manager](https://chocolatey.org/), 
 | 
			
		||||
invoke one of
 | 
			
		||||
<img height=222 align=right src=https://github.com/mintty/wsltty.appx/raw/master/wsltty.appx.png>
 | 
			
		||||
* `choco install wsltty`
 | 
			
		||||
* `choco upgrade wsltty`
 | 
			
		||||
 | 
			
		||||
@@ -82,10 +100,6 @@ then, invoke one of
 | 
			
		||||
* `scoop install wsltty`
 | 
			
		||||
* `scoop update wsltty`
 | 
			
		||||
 | 
			
		||||
#### Windows Appx package ####
 | 
			
		||||
 | 
			
		||||
A Windows Appx package and certificate is available in the [wsltty.appx](https://github.com/mintty/wsltty.appx/) repository.
 | 
			
		||||
 | 
			
		||||
### Uninstallation ###
 | 
			
		||||
 | 
			
		||||
To uninstall wsltty desktop, start menu, and context menu integration:
 | 
			
		||||
 
 | 
			
		||||
							
								
								
									
										31
									
								
								appveyor.yml
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										31
									
								
								appveyor.yml
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,31 @@
 | 
			
		||||
# This file is part of wsltty project
 | 
			
		||||
 | 
			
		||||
# Build image; of course wsltty has nothing to do with Visual Studio -
 | 
			
		||||
# this is just the name of Appveyor's build environment image
 | 
			
		||||
# that also contains cygwin
 | 
			
		||||
image: Visual Studio 2022
 | 
			
		||||
 | 
			
		||||
# Version format
 | 
			
		||||
version: "#{build}"
 | 
			
		||||
 | 
			
		||||
# Do not increment build number after pull requests
 | 
			
		||||
pull_requests:
 | 
			
		||||
  do_not_increment_build_number: true
 | 
			
		||||
 | 
			
		||||
# Do not start a new build when a new Git tag is created
 | 
			
		||||
skip_tags: true
 | 
			
		||||
 | 
			
		||||
init:
 | 
			
		||||
- cmd: |
 | 
			
		||||
    set PATH=C:\cygwin64;C:\cygwin64\bin;%windir%\System32
 | 
			
		||||
    setup-x86_64 -q -P unzip -P zoo -P patch -P lcab
 | 
			
		||||
    winget install Alpine
 | 
			
		||||
 | 
			
		||||
build_script:
 | 
			
		||||
- cmd: |
 | 
			
		||||
    make
 | 
			
		||||
 | 
			
		||||
test_script:
 | 
			
		||||
- cmd: |
 | 
			
		||||
    bin\mintty.exe --log mintty.log --exec echo hello mintty
 | 
			
		||||
    grep echo mintty.log
 | 
			
		||||
							
								
								
									
										27
									
								
								install-portable.bat
									
									
									
									
									
										Executable file
									
								
							
							
						
						
									
										27
									
								
								install-portable.bat
									
									
									
									
									
										Executable file
									
								
							@@ -0,0 +1,27 @@
 | 
			
		||||
@echo off
 | 
			
		||||
 | 
			
		||||
set sel="Select folder to place installation of portable wsltty"
 | 
			
		||||
 | 
			
		||||
for /f "usebackq delims=" %%f in (`powershell "(new-object -COM Shell.Application).BrowseForFolder(0, '%sel%', 0, 0).self.path"`) do set f=%%f
 | 
			
		||||
set instdir=%f%\wsltty
 | 
			
		||||
 | 
			
		||||
if "%f%"=="" (
 | 
			
		||||
	echo no installation
 | 
			
		||||
	exit
 | 
			
		||||
) else if not exist "%f%" (
 | 
			
		||||
	echo invalid installation folder %instdir%
 | 
			
		||||
	exit
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
call install "%instdir%" "%instdir%" /P
 | 
			
		||||
 | 
			
		||||
rem create shortcut
 | 
			
		||||
cd /D "%instdir%"
 | 
			
		||||
set instpath=%instdir:~2%
 | 
			
		||||
set target=%%COMSPEC%%
 | 
			
		||||
set minttyargs=/C bin\mintty.exe --WSL= --icon=/wsl.ico --configdir=. -~
 | 
			
		||||
set bridgeargs= -
 | 
			
		||||
set wdir=%instpath%
 | 
			
		||||
set icon=%instpath%\wsl.ico
 | 
			
		||||
cscript /nologo mkshortcut.vbs "/name:WSL Terminal Portable"
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										11
									
								
								install.bat
									
									
									
									
									
								
							
							
						
						
									
										11
									
								
								install.bat
									
									
									
									
									
								
							@@ -1,9 +1,9 @@
 | 
			
		||||
@echo off
 | 
			
		||||
 | 
			
		||||
set refinstalldir=%%LOCALAPPDATA%%\wsltty
 | 
			
		||||
set installdir="%LOCALAPPDATA%\wsltty"
 | 
			
		||||
set refconfigdir=%%APPDATA%%\wsltty
 | 
			
		||||
set configdir="%APPDATA%\wsltty"
 | 
			
		||||
if "%installdir%" == "" set installdir="%LOCALAPPDATA%\wsltty"
 | 
			
		||||
if "%configdir%" == "" set configdir="%APPDATA%\wsltty"
 | 
			
		||||
call dequote installdir
 | 
			
		||||
call dequote configdir
 | 
			
		||||
set oldroot="%installdir%"
 | 
			
		||||
@@ -137,11 +137,16 @@ mkdir "%configdir%\themes" 2> nul:
 | 
			
		||||
mkdir "%configdir%\sounds" 2> nul:
 | 
			
		||||
 | 
			
		||||
rem create config file if it does not yet exist
 | 
			
		||||
if not exist "%configdir%\config" echo # To use common configuration in %%APPDATA%%\mintty, simply remove this file>"%configdir%\config"
 | 
			
		||||
if exist "%configdir%\config" goto appconfig
 | 
			
		||||
echo # To use common configuration in %%APPDATA%%\mintty, simply remove this file>"%configdir%\config"
 | 
			
		||||
if "%3" == "/P" echo # Do not remove this file for WSLtty Portable>>"%configdir%\config"
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
:appconfig
 | 
			
		||||
 | 
			
		||||
rem skip configuration for WSLtty Portable
 | 
			
		||||
if "%3" == "/P" goto end
 | 
			
		||||
 | 
			
		||||
rem distro-specific stuff: shortcuts and launch scripts
 | 
			
		||||
cd /D "%installdir%"
 | 
			
		||||
echo Configuring for WSL distributions
 | 
			
		||||
 
 | 
			
		||||
							
								
								
									
										29
									
								
								makefile
									
									
									
									
									
								
							
							
						
						
									
										29
									
								
								makefile
									
									
									
									
									
								
							@@ -10,16 +10,16 @@
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# wsltty release
 | 
			
		||||
ver=3.5.3
 | 
			
		||||
ver=3.6.1
 | 
			
		||||
 | 
			
		||||
# wsltty appx release - must have 4 parts!
 | 
			
		||||
verx=3.5.3.0
 | 
			
		||||
verx=3.6.1.0
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
##############################
 | 
			
		||||
# mintty release version
 | 
			
		||||
 | 
			
		||||
minttyver=3.5.3
 | 
			
		||||
minttyver=3.6.1
 | 
			
		||||
 | 
			
		||||
##############################
 | 
			
		||||
 | 
			
		||||
@@ -27,7 +27,7 @@ minttyver=3.5.3
 | 
			
		||||
repo=Biswa96/wslbridge2
 | 
			
		||||
 | 
			
		||||
# wslbridge2 master release version
 | 
			
		||||
wslbridgever=0.8
 | 
			
		||||
wslbridgever=0.9
 | 
			
		||||
 | 
			
		||||
# wslbridge2 latest version
 | 
			
		||||
#archive=master
 | 
			
		||||
@@ -148,10 +148,13 @@ $(wslbridgedir).zip:
 | 
			
		||||
wslbridge-source:	$(wslbridgedir).zip
 | 
			
		||||
	unzip -o $(wslbridgedir).zip
 | 
			
		||||
	cp $(wslbridgedir)/LICENSE LICENSE.wslbridge2
 | 
			
		||||
	# patch
 | 
			
		||||
	cd $(wslbridgedir); patch -p1 < ../0001-notify-size-change-inband.patch
 | 
			
		||||
	# as a hotfix for #302, we assume the two patches are 
 | 
			
		||||
	# not needed anymore for wslbridge2 v0.9
 | 
			
		||||
	# patch to fix #220
 | 
			
		||||
	# test case in mintty: (sleep 0.1; echo -e "\e[31;80t") & wslbridge2
 | 
			
		||||
	##cd $(wslbridgedir); patch -p1 < ../0001-notify-size-change-inband.patch
 | 
			
		||||
	# patch to https://github.com/Biswa96/wslbridge2/commit/41575379b416703c49e2687e957440239a4cdfb7
 | 
			
		||||
	cd $(wslbridgedir); patch -p0 < ../0002-add-com-for-lifted-wsl.patch
 | 
			
		||||
	##cd $(wslbridgedir); patch -p0 < ../0002-add-com-for-lifted-wsl.patch
 | 
			
		||||
 | 
			
		||||
wslbridge-frontend:	wslbridge-source
 | 
			
		||||
	echo ------------- Compiling wslbridge2 frontend
 | 
			
		||||
@@ -279,7 +282,7 @@ cop:	copcab
 | 
			
		||||
	mkdir -p rel
 | 
			
		||||
	cp -fl $(CAB)/* rel/
 | 
			
		||||
 | 
			
		||||
installer:	cop cab normal-installer silent-installer
 | 
			
		||||
installer:	cop cab normal-installer silent-installer portable-installer
 | 
			
		||||
 | 
			
		||||
cab:
 | 
			
		||||
	# build cab archive
 | 
			
		||||
@@ -299,6 +302,16 @@ silent-installer:
 | 
			
		||||
	# build installer
 | 
			
		||||
	cd rel; iexpress /n wsltty-quiet.SED
 | 
			
		||||
 | 
			
		||||
InstallPrompt=Install Mintty terminal for WSL Portable?
 | 
			
		||||
FinishMessage=Mintty for WSL Portable installation finished
 | 
			
		||||
 | 
			
		||||
portable-installer:
 | 
			
		||||
	# prepare build of installer
 | 
			
		||||
	rm -f rel/$(CAB)-install-portable.exe
 | 
			
		||||
	cd rel; sed -e "/InstallPrompt/ s/=.*/=$(InstallPrompt)/" -e "/FinishMessage/ s/=.*/=$(FinishMessage)/" -e "/AppLaunched/ s/install/install-portable/" -e "/TargetName/ s/install.exe/install-portable.exe/" wsltty.SED > wsltty-portable.SED
 | 
			
		||||
	# build installer
 | 
			
		||||
	cd rel; iexpress /n wsltty-portable.SED
 | 
			
		||||
 | 
			
		||||
install:	cop installbat
 | 
			
		||||
 | 
			
		||||
installbat:
 | 
			
		||||
 
 | 
			
		||||
@@ -60,6 +60,7 @@ FILE24="mintty.ico"
 | 
			
		||||
FILE25="mkshortcut.vbs"
 | 
			
		||||
FILE26="dequote.bat"
 | 
			
		||||
FILE27="cmd2.bat"
 | 
			
		||||
FILE28="install-portable.bat"
 | 
			
		||||
 | 
			
		||||
[SourceFiles]
 | 
			
		||||
SourceFiles0=.
 | 
			
		||||
@@ -93,4 +94,5 @@ SourceFiles0=.
 | 
			
		||||
%FILE25%=
 | 
			
		||||
%FILE26%=
 | 
			
		||||
%FILE27%=
 | 
			
		||||
%FILE28%=
 | 
			
		||||
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user