General profile settings in Windows Terminal

The settings listed below are specific to each unique profile. If you’d like a setting to apply to all of your profiles, you can add it to the defaults section above the list of profiles in your settings.json file.

This is the name of the profile that will be displayed in the dropdown menu. This value is also used as the «title» to pass to the shell on startup. Some shells (like bash ) may choose to ignore this initial value, while others ( Command Prompt , PowerShell ) may use this value over the lifetime of the application. This «title» behavior can be overridden by using tabTitle .

Property name: name

Necessity: Required

Accepts: String

Command line

This is the executable used in the profile.

Property name: commandline

Necessity: Optional

Accepts: Executable file name as a string

Default value: «cmd.exe»

Starting directory

This is the directory the shell starts in when it is loaded.

Property name: startingDirectory

Necessity: Optional

Accepts: Folder location as a string

Default value: «%USERPROFILE%»

Example: Start the PowerShell profile in the GitHubRepos folder of your Documents directory by finding the powershell.exe profile and adding «startingDirectory»: «%USERPROFILE%/Documents/GitHubRepos»,

Example with WSL: When setting the starting directory for a Linux distribution installed via WSL, use the format: «startingDirectory»: «\\\\wsl$\\DISTRO NAME\\home\\USERNAME» , replacing with the placeholders with the proper names of your distribution. For example, «startingDirectory»: «\\\\wsl$\\Ubuntu-20.04\\home\\user1» .

Default behavior: When the startingDirectory value is not specified, you will get different results depending on where you launch Terminal:

• If you run Windows Terminal from the Start menu: C:\windows\system32
• If you run wt.exe from the Start menu: C:\windows\system32
• If you run wt.exe from Win+R: %USERPROFILE%
• If you run wt.exe from the explorer address bar: whatever folder you were looking at.

Backslashes need to be escaped. For example, C:\Users\USERNAME\Documents should be entered as C:\\Users\\USERNAME\\Documents .

This sets the icon that displays within the tab, dropdown menu, jumplist, and tab switcher.

Property name: icon

Necessity: Optional

Accepts: File location as a string, or an emoji

Example: By placing the icon image ubuntu.ico in the folder located at %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState , you can display the icon by adding this line to the profile in your settings.json: «icon»: «ms-appdata:///roaming/ubuntu.ico» .

Tab title

If set, this will replace the name as the title to pass to the shell on startup. Some shells (like bash ) may choose to ignore this initial value, while others ( Command Prompt , PowerShell ) may use this value over the lifetime of the application. If you’d like to learn how to have the shell set your title, visit the tab title tutorial.

Property name: tabTitle

Necessity: Optional

Accepts: String

Hide profile from dropdown

If hidden is set to true , the profile will not appear in the list of profiles. This can be used to hide default profiles and dynamically generated profiles, while leaving them in your settings file. To learn more about dynamic profiles, visit the Dynamic profiles page.

Windows Terminal: Как включить редактор настроек с графическим интерфейсом

Windows Terminal представляет собой приложение с открытым исходным кодом, разрабатываемое Microsoft и позволяющее запускать несколько консольных интерфейсов в одном окне Windows. На каждой из вкладок Windows Terminal можно использовать различные оболочки, например командную строку, PowerShell, оболочки Linux, установленные в подсистеме WSL и сторонние консоли, установленные пользователем.

На этой неделе компания Microsoft выпустила новую версию Windows Terminal 1.5. Инструмент поставляется с несколькими полезными улучшениями, например с поддержкой перехода по гиперссылкам, улучшениями цветовой палитры и поддержкой эмодзи.

Чтобы настроить текущую версию Windows Terminal, вам нужно изменить параметры в файле settings.json с помощью обычного текстового редактора.

Microsoft запускает тестирование нового графического интерфейса настроек

Две недели назад состоялся релиз Windows Terminal Preview 1.6, в котором Microsoft тестирует функцию, позволяющую настраивать приложение с помощью графического интерфейса.

Чтобы открыть редактор настроек с графическим интерфейсом, вам нужно добавить горячую клавишу для команды openSettings . В примере ниже мы задали сочетание Ctrl+Shift+S, но вы можете использовать любую другую комбинацию клавиш:

• Откройте файл settings.json с помощью меню Параметры в Windows Terminal Preview 1.6 и добавьте следующую запись:

• После сохранения файла settings.json изменения будут применены незамедлительно.

Теперь вы можете нажать комбинацию Ctrl+Shift+S, чтобы запустить графический редактор настроек, который позволяет сконфигурировать основные параметры приложения.

Вы можете добавить новые профили или поработать с текущими профилями, настроив их отображение и расширенные параметры.

Раньше, чтобы настроить Windows Terminal, нужно было много работать с текстом, а при сохранении settings.json иногда возникали ошибки.

В новом графическом интерфейсе настроить Windows Terminal стало значительно проще. Кроме того, теперь инструмент стал более дружественным для менее технически подкованных пользователей — им больше не придется взаимодействовать с файлом JSON.

Установка и настройка Терминала Windows Install and set up Windows Terminal

Установка Installation

Терминал Windows можно установить из Microsoft Store. You can install Windows Terminal from the Microsoft Store.

Если у вас нет доступа к Microsoft Store, можно скачать сборки, опубликованные на странице выпусков GitHub. If you don’t have access to the Microsoft Store, the builds are published on the GitHub releases page. При установке из GitHub терминал не будет автоматически обновляться с установкой новых версий. If you install from GitHub, the terminal will not automatically update with new versions.

Первый запуск First run

После установки при открытии терминала он запустится с помощью PowerShell в качестве профиля по умолчанию в открытой вкладке. After installation, when you open the terminal, it will start with PowerShell as the default profile in the open tab.

Динамические профили Dynamic profiles

Если у вас установлены дистрибутивы WSL или несколько версий PowerShell, терминал автоматически создаст профили. The terminal will automatically create profiles for you if you have WSL distros or multiple versions of PowerShell installed. Дополнительные сведения о динамических профилях см. на этой странице. Learn more about dynamic profiles on the Dynamic profiles page.

Открытие новой вкладки Open a new tab

Новую вкладку профиля по умолчанию можно открыть, нажав сочетание клавиш Ctrl+Shift+T или кнопку «+» (плюс). You can open a new tab of the default profile by pressing ctrl+shift+t or by selecting the + (plus) button. Открыть другой профиль можно с помощью раскрывающегося меню. Для этого щелкните «˅» (стрелка) рядом с кнопкой «+». To open a different profile, select the ˅ (arrow) next to the + button to open the dropdown menu. Из этого меню можно выбрать, какой профиль следует открыть. From there, you can select which profile to open.

Открытие новой панели Open a new pane

Вы можете параллельно запустить несколько оболочек с помощью панелей. You can run multiple shells side-by-side using panes. Чтобы открыть панель, нажмите сочетание клавиш ALT+SHIFT+D . To open a pane, you can use alt+shift+d . С помощью этого настраиваемого сочетания клавиш можно открыть еще одну панель выделенного профиля. This key binding will open a duplicate pane of your focused profile. Дополнительные сведения о панелях см. на этой странице. Learn more about panes on the Panes page.

Конфигурация Configuration

Чтобы выполнить настройку параметров Терминала Windows, в раскрывающемся меню выберите Параметры. To customize the settings of your Windows Terminal, select Settings in the dropdown menu. В текстовом редакторе по умолчанию откроется файл settings.json . This will open the settings.json file in your default text editor. (Текстовый редактор по умолчанию определяется в параметрах Windows.) (The default text editor is defined in your Windows settings.)

Терминал поддерживает настройку глобальных свойств, влияющих на все приложение, свойств профиля, влияющих на параметры каждого профиля, а также сочетания клавиш, позволяющих взаимодействовать с терминалом с помощью клавиатуры. The terminal supports customization of global properties that affect the whole application, profile properties that affect the settings of each profile, and key bindings that allow you to interact with the terminal using your keyboard.

Аргументы командной строки Command line arguments

Вы можете запустить терминал в определенной конфигурации с помощью аргументов командной строки. You can launch the terminal in a specific configuration using command-line arguments. С помощью этих аргументов можно открыть терминал с конкретными вкладками и панелями, применяя параметры настраиваемого профиля. These arguments let you open the terminal with specific tabs and panes with custom profile settings. Дополнительные сведения об аргументах командной строки см. на этой странице. Learn more about command-line arguments on the Command line arguments page.

Диагностика Troubleshooting

В случае возникновения каких-либо проблем при использовании терминала посетите страницу устранения неполадок. If you encounter any difficulties using the terminal, reference the Troubleshooting page. Если вы заметите какие-либо ошибки или захотите отправить запрос функции, щелкните в меню терминала О программе ссылку «Отзыв», чтобы перейти на страницу GitHub и сообщить об ошибке. If you find any bugs or have a feature request, you can select the feedback link in the About menu of the terminal to go to the GitHub page where you can file a new issue.

Кастомизация командной строки для пользователей Windows

Перевод статьи «PowerShell Themes and Windows Terminal Color Schemes – How to Customize Your Command Line».

Недавно я настраивал Windows Terminal для своей локальной среды разработки. В этой статье, написанной по горячим следам, я расскажу, как это делается.

Скачать Windows Terminal можно из Microsoft Store. Сделайте это, если еще не сделали и если у вас Windows 10. В более ранних версиях Windows Terminal недоступен.

Как настроить меню PowerShell

Одно из самых больших преимуществ Windows Terminal — возможность использовать несколько оболочек в одном окне, переключаясь между вкладками.

Установив приложение, откройте терминал и нажмите на значок v вверху (рядом с открытой вкладкой). Вы увидите список доступных терминалов, но их мы пока проигнорируем.

В выпадающем меню выберите опцию «Settings» («Настройки»). Это откроет файл settings.json в вашем дефолтном текстовом редакторе.

В этом файле вы найдете довольно много настроек. Первое, на что нужно обратить внимание, — свойство profiles . Оно содержит все опции выбора терминала. Вложенное свойство defaults содержит дефолтные настройки для всех профилей, а свойство list — профили ваших терминалов.

Давайте рассмотрим свойство list . В настоящий момент оно содержит примерно такие значения:

Свойство list — это массив объектов. Оно определяет, какие исполняемые файлы могут загружаться через Windows Terminal. В нашем примере доступные опции — Windows PowerShell и приглашение командной строки CMD.

Давайте разберем свойства в этих объектах:

• guid — уникальный идентификатор (Globally Unique Identifier). Используется исключительно для настройки defaultProfile , которую мы рассмотрим позже.
• name — имя, отображаемое в выпадающем списке, когда вы открываете новую вкладку в Windows Terminal.
• commandline — исполняемый файл, который загружается при открытии вкладки этого профиля.
• hidden — булево значение, определяющее, появляется ли данный профиль в выпадающем списке для новой вкладки. Если вы нечасто пользуетесь каким-нибудь терминалом, можно поставить для него значение true , чтобы он не показывался в списке. Таким образом вы сохраните настройки этого терминала, но в выпадающем списке будете видеть только те терминалы, которые вам нужны.

Пример пользовательской настройки PowerShell Windows Terminal

Вполне вероятно, что вы сможете обойтись дефолтными настройками (это зависит от вашей среды разработки). Я большую часть работы выполняю в Windows Subsystems for Linux (WSL 2), но периодически пользуюсь Git Bash, поэтому у меня есть пара дополнительных опций.

Здесь вы видите несколько новых свойств:

• source : Это свойство генерируется автоматически, когда Windows Terminal обнаруживает и генерирует профиль для исполняемого файла нового терминала. Не нужно добавлять это свойство, если вы конструируете профиль вручную.
• icon : Используется для выбора, какой .ico-файл значка должен появляться рядом с именем в выпадающем списке новой вкладки.
• startingDirectory : Путь к файлу, на который будет указывать Windows Terminal при загрузке новой вкладки с этим профилем.

Как создать пользовательский профиль в PowerShell

Windows Terminal не сгенерировал настройки профиля для Git Bash, так что мне пришлось сделать это вручную. Если вам нужно сделать то же самое, вот инструкция.

Сначала нужно сгенерировать значение guid . Оно имеет формат <00000000-0000-0000-0000-000000000000>. Сгенерировать его можно в Windows PowerShell, запустив [guid]::NewGuid() , или в WSL, запустив uuidgen .

Затем определите путь к исполняемому файлу в свойстве commandline . Значение %PROGRAMFILES% указывает на вашу директорию «Program Files» («Файлы программ») и учитывает разницу между путями для 32 и 64-битных приложений.

Если же ваша инсталляция расположена в вашей директории пользователя, вы можете использовать значение %USERPROFILE% . Флаги -i -l используются для того, чтобы Windows Terminal корректно загружал ваш файл .bashrc.

Свойство icon можно пропустить. Но если вы хотите, чтобы в выпадающем списке рядом с названием терминала отображался значок, здесь нужно указать путь к файлу изображения.

Свойство name указывать обязательно, оно определяет имя, которое будет показываться в выпадающем списке. Здесь я использовал «Git Bash», чтобы четко понимать, какой терминал откроет эта опция.

Наконец, для свойства startingDirectory нужно установить путь к директории, которую терминал будет «считать» дефолтной. У себя я поставил %USERPROFILE% , что указывает терминалу на мою директорию пользователя Windows. Благодаря этому я могу быстро переходить в мою папку «Документы» и прочие папки.

Как настроить ваш дефолтный профиль в PowerShell Windows Terminal

Если вы прокрутите назад файл settings.json, вы увидите свойство defaultProfile . Эта опция принимает значение guid , которое должно совпадать с одним из значений guid в вашем массиве list . Вкладка профиля, guid которого вы здесь укажете, будет загружаться при старте Windows Terminal.

Поскольку большую часть своей работы я делаю в WSL, я установил именно его guid в качестве значения для свойства defaultProfile .

Теперь при открытии приложения Windows Terminal сразу загружается экземпляр WSL.

Как составить собственную цветовую схему в PowerShell Windows Terminal

После настройки приложений можно сфокусироваться на стилях текста, чтобы сделать его покрасивее.

Под свойством profiles в файле settings.json вы найдете свойство schemes . Оно содержат массив объектов цветовых схем, выглядит это примерно так:

Если вы использовали инструменты вроде пакета chalk в npm, вы можете узнать некоторые из значений цветов (purple здесь — это magenta в chalk).

• name : используется для назначения цветовой схемы одному из профилей, созданных нами ранее.
• cursorColor : определяет цвет курсора.
• selectionBackground : определяет цвет фона для выделенного текста.
• background : задает цвет фона в вашем терминале.
• foreground : задает цвет переднего плана для терминала. В моей текущей конфигурации я не ощутил никаких отличий при изменении этого значения.

Свойства цветов определяют конкретные цветовые коды. Для своего цветового профиля я установил следующие настройки:

Советую поиграться с этими значениями, пока не подберете набор цветов, полностью удовлетворяющий ваши требования.

Как связать цветовую схему с профилем

Настроив цвета, нужно как-то привязать их к профилю терминала. Эти настройки можно применить в свойстве defaults (свойство, вложенное в свойство profiles ). Таким образом настроенная цветовая схема применится ко всем вашим терминалам. Но я предпочитаю настраивать разные цвета для разных терминалов, чтобы было удобно определять, в правильной ли вкладке я нахожусь.

Давайте применим эту цветовую схему для профиля WSL. Добавьте ключ colorScheme в ваш объект профиля и задайте ему значение — name вашей схемы. У вас должно получиться что-то вроде этого:

Перезапустив Windows Terminal, вы увидите уже новые цвета.

Дополнительные настройки внешнего вида

В моем объекте WSL-профиля есть несколько дополнительных настроек:

Вы можете включить их в объект своего профиля, подогнав по вкусу.

• useAcrylic : В Windows 10 включает эффект прозрачности для фона терминала.
• Если включен эффект прозрачности, при помощи acrylicOpacity можно отрегулировать его интенсивность. Чем ниже число, тем выше прозрачность.
• fontFace : Выбор шрифта для терминала. Учтите, что выбранный шрифт должен быть установлен в вашем компьютере. Я использую шрифт PxPlus IBM VGA8.
• fontSize : определяет размер шрифта (в pt).
• experimental.retroTerminalEffect : Моя любимая настройка. Создает ретроэффект, напоминающий вид экрана старых CRT-мониторов.

Вот как выглядит итоговый результат моих настроек:

Любую из этих настроек внешнего вида можно добавить в defaultSettings , чтобы применить глобально, ко всем профилям.

Дополнительные настройки в PowerShell Windows Terminal

Есть несколько дополнительных настроек, на которые стоит обратить внимание.

После свойства schemes идет свойство actions . В нем содержится массив настроек с сочетаниями клавиш.

По умолчанию в Windows Terminal копирование и вставка осуществляется нажатием Ctrl+Shift+C и Ctrl+Shift+V соответственно. Но вы можете назначить сочетание Ctrl+C и Ctrl+V :

Опция singleLine со значением false предохраняет от разрыва строк при копировании текста.

Практически вверху вашего файла settings.json есть еще два свойства, влияющие на поведение при копировании текста из терминала:

• copyOnSelect по умолчанию имеет значение false . Если поставить true , выделение текста мышью будет копировать этот текст в буфер.
• copyFormatting тоже по умолчанию имеет значение false . Если поставить true , будет копироваться и форматирование текста (по умолчанию копируется как plain text).

Копировать текст из терминала в целом безопасно, но вставлять в него текст нужно с осторожностью. Windows Terminal имеет пару настроек, защищающих от ненужного риска:

• largePasteWarning по умолчанию имеет значение true . В вашем файле settings.json его может и не быть. Эта настройка вызывает диалогове окно при попытке вставить более 5KB содержимого.
• multiLinePasteWarning по умолчанию имеет значение true . В вашем файле settings.json его тоже может не быть. Эта настройка вызывает диалоговое окно при попытке вставить текст, содержащий разрывы строки (это распространенный прием атаки с захватом буфера обмена, суть ее в том, чтобы при вставке начали запускаться какие-то команды).

Я настоятельно рекомендую оставить эти настройки и ничего не менять.

Дополнительные источники

Поздравляю! Вот вы и сделали собственный вариант настройки Windows Terminal.

Чтобы узнать о других способах кастомизации, не раскрытых в этой статье, обратитесь к документации: Windows Terminal Customization Documentation.

Что касается цветовых схем, есть много готовых вариантов, которые можно скачать в виде JSON-файлов. Вы найдете их в Windows Terminal Themes. Именно там я нашел свою схему, которую лишь немного подкрутил по своему вкусу.