https://github.com/elia/vscode-textmate

TextMate features and keybindings for Visual Studio Code
https://github.com/elia/vscode-textmate

textmate vscode vscode-extension vscode-keybindings

Last synced: 5 months ago
JSON representation

TextMate features and keybindings for Visual Studio Code

Host: GitHub
URL: https://github.com/elia/vscode-textmate
Owner: elia
License: mit
Created: 2023-04-27T14:11:33.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2025-09-30T07:50:38.000Z (9 months ago)
Last Synced: 2025-09-30T09:28:01.901Z (9 months ago)
Topics: textmate, vscode, vscode-extension, vscode-keybindings
Language: JavaScript
Homepage: https://marketplace.visualstudio.com/items?itemName=elia.vscode-textmate
Size: 670 KB
Stars: 9
Watchers: 2
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md

Awesome Lists containing this project

README

# TextMate for Visual Studio Code

This extension aims at recreating the TextMate experience in Visual Studio Code.

## Features

### TextMate Commands

Execute arbitrary scripts with configurable input/output handling via keyboard shortcuts. Define commands directly in your `keybindings.json` with full control over execution context.

#### Usage

Add keybindings to your `keybindings.json`:

```json
{
"key": "ctrl+alt+cmd+t",
"command": "vscode-textmate.command",
"when": "editorTextFocus",
"args": {
"script": "#!/usr/bin/env bash\n\nopen \"$TM_PROJECT_DIRECTORY\" -a Terminal.app",
"save": "currentDocument",
"input": "none",
"output": "discard"
}
}
```

#### Arguments

#### Environment Variables

Scripts receive TextMate-style environment variables:

- `TM_SELECTED_TEXT` - Currently selected text
- `TM_CURRENT_LINE` - Current line content
- `TM_CURRENT_WORD` - Current word at cursor
- `TM_FILENAME` - Current file name
- `TM_FILEPATH` - Current file path
- `TM_DIRECTORY` - Current file directory
- `TM_PROJECT_DIRECTORY` - Workspace root directory
- `TM_LINE_INDEX` - Current line (0-based)
- `TM_LINE_NUMBER` - Current line (1-based)
- `TM_COLUMN_NUMBER` - Current column (1-based)

#### Examples

**Text transformation:**
```json
{
"key": "ctrl+u",
"command": "vscode-textmate.command",
"when": "editorTextFocus",
"args": {
"script": "tr '[:lower:]' '[:upper:]'",
"input": "selection",
"output": "replaceInput"
}
}
```

**Insert timestamp:**
```json
{
"key": "ctrl+alt+d",
"command": "vscode-textmate.command",
"when": "editorTextFocus",
"args": {
"script": "date +%Y-%m-%d",
"input": "none",
"output": "insertText"
}
}
```

**Sort lines:**
```json
{
"key": "ctrl+alt+s",
"command": "vscode-textmate.command",
"when": "editorTextFocus",
"args": {
"script": "sort",
"input": "selection",
"output": "replaceInput"
}
}
```

### Keybindings

A good amount of keybindings have been ported from TextMate.

### `windowTitle`

You can now use `scmBranchName` in the `windowTitle` setting.

### `closeOtherEditors`, `closeEditorInAllGroups`

Fix the default VSCode behavior of asking to save unsaved files when closing editors.
These commands will close specified editors except any "dirty" or "pinned" editor.

### `openProject`

Open a project in a new window, selecting from subfolders of the folders listed in the `projectFolders` setting.

### `openQuickly`

Quick file opener that replaces VS Code's default "Open Quickly…" command with TextMate's behavior. Press ⌘T to open a searchable list of all files in the workspace, filtered intelligently to exclude common build artifacts and dependencies. Uses the same selection interface as other TextMate commands for a consistent experience.

### `selectFromList` (internal)

Provides a flexible UI for selecting items from a list. Shows a webview-based selection interface that allows for multi-selection from a provided array of items.
Can be used by other extensions as a nearly drop-in replacement for `showQuickPick`.

#### Command Usage

```js
picks = await vscode.commands.executeCommand(
"vscode-textmate.showSelectFromList",
items,
options
)
```

#### Parameters

- **`items`** (array, required): Array of items to select from. Items can be:
- Strings: `"Item 1"`
- Numbers/Booleans: `42`, `true`
- Objects: `{ label: "Custom Item", description: "Optional description" }`

- **`options`** (object, optional): Configuration options
- **`title`** (string): Title displayed in the selection interface (default: `"Select From List"`)
- **`renderAs`** (string): Where to show the interface:
- `"sidebar"`: Shows in dedicated sidebar view
- `"panel"`: Opens in webview panel
- Defaults to user's `vscode-textmate.selectFromList.renderAs` setting

#### Examples

```js
// Simple string selection
const picks = await vscode.commands.executeCommand(
"vscode-textmate.showSelectFromList",
["Option 1", "Option 2", "Option 3"],
{ title: "Choose Options" }
)

// Mixed item types with custom rendering
const picks = await vscode.commands.executeCommand(
"vscode-textmate.showSelectFromList",
[
"Simple string",
{ label: "Complex Item", description: "With description" },
42,
true
],
{
title: "Mixed Selection",
renderAs: "panel"
}
)
```

### File Operations

| Name | Command | Keybinding |
| ------------ | ------------- | ------------- |
| Open Quickly | `openQuickly` | ⌘T |

### Navigation

You can now navigate between brackets and blocks using `ctrl` with `up` and `down`, adding `shift` to also update the selection.

| Name | Command | Keybinding |
| ----------------------------- | ------------------------------------------- | -------------- |
| Jump to Selection | `jumpToSelection` | ⌘J |
| Move to beginning of Block | `moveToBeginningOfBlock` | ⌃⭡ |
| Move to end of Block | `moveToEndOfBlock` | ⌃⭣ |
| Select to beginning of Block | `moveToBeginningOfBlockAndModifySelection` | ⌃⇧⭡ |
| Select to end of Block | `moveToEndOfBlockAndModifySelection` | ⌃⇧⭣ |
| Move to beginning of Column | `moveToBeginningOfColumn` | ⌥⭡ |
| Move to end of Column | `moveToEndOfColumn` | ⌥⭣ |
| Select to beginning of Column | `moveToBeginningOfColumnAndModifySelection` | ⌥⇧⭡ |
| Select to end of Column | `moveToEndOfColumnAndModifySelection` | ⌥⇧⭣ |
| Jump to Selection | `jumpToSelection` | ⌘J |

### Editing

| Name | Command | Keybinding |
| ----------- | ------------ | -------------- |
| Join Lines | `joinLines` | ⌃⇧J |
| Toggle Case | `toggleCase` | ⌃_ |
| Transpose | `transpose` | ⌃T |

_All commands are under the `vscode-textmate` namespace, e.g. `vscode-textmate.moveToEndOfColumn`._

## Troubleshooting

**VS Code plays a sound with some keybindings:** https://superuser.com/a/1530872

## License

[MIT](LICENSE)

[Icon by Marc Oliver Orth](https://github.com/marc2o/TextMate-macOS-Icon/blob/main/LICENSE)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/elia/vscode-textmate

Awesome Lists containing this project

README