terminal/doc/user-docs/ThirdPartyToolProfiles.md

# Adding profiles for third-party tools

This doc will hopefully provide a useful guide for adding profiles for common
third-party tools to your
[settings.json](https://github.com/microsoft/terminal/blob/master/doc/user-docs/UsingJsonSettings.md)
file.

All of these profiles are provided _without_ their `guid` set. If you'd like to
set any of these profiles as your _default_ profile, you'll need to make sure to
[generate a unique guid](https://www.guidgenerator.com/) for them manually.

## Anaconda

Assuming that you've installed Anaconda into `%USERPROFILE%\Anaconda3`:

```json
{
    "commandline" : "cmd.exe /k \"%USERPROFILE%\\Anaconda3\\Scripts\\activate.bat %USERPROFILE%\\Anaconda3\"",
    "icon" : "%USERPROFILE%/Anaconda3/Menu/anaconda-navigator.ico",
    "name" : "Anaconda3",
    "startingDirectory" : "%USERPROFILE%"
}
```

## cmder

Assuming that you've installed cmder into `%CMDER_ROOT%`:

```json
{
    "commandline" : "cmd.exe /k \"%CMDER_ROOT%\\vendor\\init.bat\"",
    "name" : "cmder",
    "icon" : "%CMDER_ROOT%/icons/cmder.ico",
    "startingDirectory" : "%USERPROFILE%"
}
```

## Cygwin

Assuming that you've installed Cygwin into `C:/Cygwin`:

```json
{
    "name" : "Cygwin",
    "commandline" : "C:/Cygwin/bin/bash --login -i",
    "icon" : "C:/Cygwin/Cygwin.ico",
    "startingDirectory" : "C:/Cygwin/bin"
}
```

Note that the starting directory of Cygwin is set as it is to make the path
work. The default directory opened when starting Cygwin will be `$HOME` because
of the `--login` flag.

## Far Manager

Assuming that you've installed Far into `c:\Program Files\Far Manager`:

```json
{
    "name" : "Far",
    "commandline" : "\"c:\\program files\\far manager\\far.exe\"",
    "startingDirectory" : "%USERPROFILE%",
    "useAcrylic" : false
},
```

## Git Bash

Assuming that you've installed Git Bash into `C:/Program Files/Git`:

```json
{
    "name" : "Git Bash",
    "commandline" : "C:/Program Files/Git/bin/bash.exe -li",
    "icon" : "C:/Program Files/Git/mingw64/share/git/git-for-windows.ico",
    "startingDirectory" : "%USERPROFILE%"
}
````

## Git Bash (WOW64)

Assuming that you've installed Git Bash into `C:/Program Files (x86)/Git`:

```json
{
    "name" : "Git Bash",
    "commandline" : "%ProgramFiles(x86)%/Git/bin/bash.exe -li",
    "icon" : "%ProgramFiles(x86)%/Git/mingw32/share/git/git-for-windows.ico",
    "startingDirectory" : "%USERPROFILE%"
}
```

## MSYS2

Assuming that you've installed MSYS2 into `C:/msys64`:

```json
{
    "name" : "MSYS2",
    "commandline" : "C:/msys64/msys2_shell.cmd -defterm -no-start -mingw64",
    "icon": "C:/msys64/msys2.ico",
    "startingDirectory" : "C:/msys64/home/user"
}
````

## Developer Command Prompt for Visual Studio

Assuming that you've installed VS 2019 Professional:

```json
{
    "name" : "Developer Command Prompt for VS 2019",
    "commandline" : "cmd.exe /k \"C:/Program Files (x86)/Microsoft Visual Studio/2019/Professional/Common7/Tools/VsDevCmd.bat\"",
    "startingDirectory" : "%USERPROFILE%"
}
```

<!-- Adding a tool here? Make sure to add it in alphabetical order! -->