https://github.com/eu-ge-ne/toy
Minimalistic TUI text editor
https://github.com/eu-ge-ne/toy
deno text-editor tui typescript
Last synced: 11 months ago
JSON representation
Minimalistic TUI text editor
- Host: GitHub
- URL: https://github.com/eu-ge-ne/toy
- Owner: eu-ge-ne
- License: mit
- Created: 2025-07-18T00:44:42.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-03T03:07:01.000Z (11 months ago)
- Last Synced: 2025-08-03T05:24:22.913Z (11 months ago)
- Topics: deno, text-editor, tui, typescript
- Language: TypeScript
- Homepage:
- Size: 462 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# toy
Minimalistic TUI text editor. Built with Deno and TypeScript with zero
third-party dependencies.
- [Installation](#installation)
- [Homebrew](#homebrew)
- [Features](#features)
- [Text](#text)
- [Rendering](#rendering)
- [Input](#input)
- [UX](#ux)
- [Supported terminal emulators](#supported-terminal-emulators)
- [Keyboard shortcuts](#keyboard-shortcuts)
- [Function](#function)
- [Navigate](#navigate)
- [Select](#select)
- [Edit](#edit)
- [Roadmap](#roadmap)
- [License](#license)
## Installation
### Homebrew
Install from a tap:
```bash
brew install eu-ge-ne/tap/toy
```
## Features
### Text
- Working with large files (tested on gigabyte-sized files)
- Working with text as a sequence of Unicode grapheme clusters
- Moving cursor according to the width of characters rendered by terminal
emulators
### Rendering
- 256-color palette
- Rendering whitespace characters
- Leveraging the
[Synchronized Output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)
extension for fast rendering (5 ms median)
### Input
- [Kitty keyboard protocol](https://sw.kovidgoyal.net/kitty/keyboard-protocol)
support
- Integration with the system clipboard via OSC52
### UX
- Command Palette
- Zen mode
- Undo/Redo buffer
- Line wrapping
- Color themes
## Supported terminal emulators
- kitty
- Ghostty
- VSCode terminal
## Keyboard shortcuts
### Function
- `F1` - Open Command Palette (`⇧+F1`, `⌃+F1`, `⌥+F1`, `⌘+F1`)
- `F2` - Save
- `F5` - Toggle render whitespace
- `F6` - Toggle line wrap
- `F9` - Toggle Debug panel
- `F10` - Exit
- `F11` - Toggle Zen mode
### Navigate
- `Left`, `Right`, `Up`, `Down` - Move cursor
- `Home` - Move cursor to beginning of current line (`Fn+Left`, `⌘+Left`)
- `End` - Move cursor to end of current line (`Fn+Right`, `⌘+Right`)
- `Page Up` - Move cursor up a frame (`Fn+Up`)
- `Page Down` - Move cursor down a frame (`Fn+Down`)
- `⌘+Up` - Move cursor to the top of the text
- `⌘+Down` - Move cursor to the bottom of the text
### Select
- `⇧+Left` - Extend text selection one character to the left
- `⇧+Right` - Extend text selection one character to the right
- `⇧+Up` - Extend text selection to the nearest character at the same horizontal
location on the line above
- `⇧+Down` - Extend text selection to the nearest character at the same
horizontal location on the line below
- `⇧+Home` - Select the text between the cursor and the beginning of the current
line (`⇧+Fn+Left`, `⇧+⌘+Left`)
- `⇧+End` - Select the text between the cursor and the end of the current line
(`⇧+Fn+Right`, `⇧+⌘+Right`)
- `⇧+Page Up` - Select a frame of text above the cursor (`⇧+Fn+Up`)
- `⇧+Page Down` - Select a frame of text below the cursor (`⇧+Fn+Down`)
- `⇧+⌘+Up` - Select the text between the cursor and the beginning of the text
- `⇧+⌘+Down` - Select the text between the cursor and the end of the text
- `⌃+A` - Select all text (`⌘+A`)
### Edit
- `⌃+Z` - Undo (`⌘+Z`)
- `⌃+Y` - Redo (`⌘+Y`)
- `⌃+C` - Copy selected text (`⌘+C`)
- ️`⌃+X` - Cut selected text (`⌘+X`)
- `⌃+V` - Paste text at cursor (`⌘+V`)
- `Delete` - Delete the character to the left of the cursor
- `Fn+Delete` - Delete the character under the cursor
## Roadmap
- `⌃+F` - Find
- `F3` - Find next
- `⇧+F3` - Find previous
- Mouse support
## License
[MIT](https://choosealicense.com/licenses/mit)