wedi

A lightweight, easy-to-use console text editor written in Rust.

Features

• ✅ Cross-platform support (Windows, macOS, Linux)
• ✅ Lightweight and fast startup
• ✅ Basic text editing operations
• ✅ Line numbers display (toggleable)
• ✅ Clipboard support (copy, cut, paste)
• ✅ Selection mode with Shift key
• ✅ Ctrl+S Selection Mode (for terminals without Shift key support) 🎉
• ✅ Smart line operations
• ✅ Undo/Redo (Ctrl+Z/Y) 🎉
• ✅ Search functionality (Ctrl+F) 🎉
• ✅ Comment toggling (Ctrl+K/\//) 🎉
• ✅ Go to line (Ctrl+G) 🎉
• ✅ Tab/Shift+Tab indentation 🎉
• ✅ Fast navigation (Ctrl+Arrows/Home/End) 🎉
• ✅ In-editor help (Ctrl+H) 🎉
• ✅ Chinese character support 🎉
• ✅ Syntax highlighting (219+ languages) 🎉
• ✅ Smart incremental syntax highlighting with cache optimization 🎉
• ✅ Customizable syntax themes (7 built-in themes) 🎉
• ✅ Single-line/Multi-line display mode toggle (Ctrl+L/Ctrl+O) 🎉

Installation

Using Wenget

You can install wedi using Wenget.

Using Winget

You can install wedi using Winget (Windows Package Manager).

Quick Install (One-Line Command)

Windows (PowerShell)

$env:APP_NAME="wedi"; $env:REPO="superyngo/wedi"; $env:UNINSTALL="false"; irm https://gist.githubusercontent.com/superyngo/a6b786af38b8b4c2ce15a70ae5387bd7/raw/gpinstall.ps1 | iex

Uninstall:

$env:APP_NAME="wedi"; $env:REPO="superyngo/wedi"; $env:UNINSTALL="true"; irm https://gist.githubusercontent.com/superyngo/a6b786af38b8b4c2ce15a70ae5387bd7/raw/gpinstall.ps1 | iex

Linux / macOS (Bash)

curl -fsSL https://gist.githubusercontent.com/superyngo/a6b786af38b8b4c2ce15a70ae5387bd7/raw/gpinstall.sh | APP_NAME="wedi" REPO="superyngo/wedi" bash

Uninstall:

curl -fsSL https://gist.githubusercontent.com/superyngo/a6b786af38b8b4c2ce15a70ae5387bd7/raw/gpinstall.sh | APP_NAME="wedi" REPO="superyngo/wedi" bash -s uninstall

The installation script will:

• Automatically detect your OS and architecture
• Download the latest precompiled binary from GitHub Releases
• Install to:
  • Windows: %LOCALAPPDATA%\Programs\wedi
  • Linux/macOS: ~/.local/bin
• Add the installation directory to your PATH (if needed)

Supported Platforms:

• Windows (x86_64, ARM64)
• Linux (x86_64, aarch64)
• macOS (x86_64, Apple Silicon)

Note: Replace superyngo with the actual GitHub superyngo in the URLs above.

Manual Installation

From Precompiled Binaries

Download the latest release for your platform from the Releases page.

Windows:

# Extract the downloaded zip file and move wedi.exe to a directory in your PATH
# For example:
move wedi.exe %LOCALAPPDATA%\Programs\wedi\

Linux/macOS:

# Extract the downloaded tar.gz file and move wedi to a directory in your PATH
tar -xzf wedi-*.tar.gz
chmod +x wedi
mv wedi ~/.local/bin/

From Source

If you prefer to build from source, ensure you have Rust installed:

# Clone the repository
git clone https://github.com/superyngo/wedi.git
cd wedi

# Build release binary
cargo build --release

# The binary will be available at:
# - Windows: target\release\wedi.exe
# - Linux/macOS: target/release/wedi

# Install manually
# Windows:
copy target\release\wedi.exe %LOCALAPPDATA%\Programs\wedi\

# Linux/macOS:
cp target/release/wedi ~/.local/bin/
chmod +x ~/.local/bin/wedi

Usage

# Open or create a file
wedi <filename>

# Show help
wedi -h
# or
wedi --help

# Show version
wedi -v
# or
wedi --version

# Enable debug mode
wedi --debug <filename>

Encoding Options

wedi supports specifying different encodings for reading and saving files:

# Specify source encoding (reading)
wedi <filename> --from-encoding <encoding>
# or use shorthand
wedi <filename> -f <encoding>

# Specify target encoding (saving)
wedi <filename> --to-encoding <encoding>
# or use shorthand
wedi <filename> -t <encoding>

# Specify both source and target encoding
wedi <filename> -f <encoding> -t <encoding>

Supported Encodings:

• utf-8 / utf8 (default)
• utf-16le / utf-16be
• gbk (Chinese GBK)
• shift-jis (Japanese Shift-JIS)
• big5 (Traditional Chinese Big5)
• cp1252 (Western European Windows-1252)
• And many more...

Encoding Priority for Saving: When saving files, the encoding priority is: --to-encoding > --from-encoding > detected encoding from file.

Examples:

# Read UTF-8, save as GBK
wedi file.txt -f utf-8 -t gbk

# Read with auto-detection, save as UTF-16LE
wedi file.txt -t utf-16le

# Read GBK, save as GBK
wedi file.txt -f gbk

Theme Options

wedi supports customizable syntax highlighting themes. You can choose from 7 built-in themes:

# List all available themes
wedi --list-themes

# Use a specific theme
wedi --theme <THEME_NAME> <filename>

Available Themes:

1. InspiredGitHub (light theme)
2. Solarized (dark)
3. Solarized (light)
4. base16-eighties.dark (default)
5. base16-mocha.dark
6. base16-ocean.dark
7. base16-ocean.light

Examples:

# Use Solarized Dark theme
wedi --theme "Solarized (dark)" myfile.rs

# Use Mocha theme
wedi --theme "base16-mocha.dark" myfile.py

# List all themes
wedi --list-themes

Note: The default theme is base16-eighties.dark. If you don't specify a theme, this will be used automatically.

Keyboard Shortcuts

Basic Editing

• Ctrl+W: Save file
• Ctrl+Q: Quit (press twice if modified)
• Ctrl+Z: Undo
• Ctrl+Y: Redo
• Backspace: Delete character before cursor or selected text
• Delete: Delete character under cursor or selected text
• Ctrl+D: Delete current line or selected lines
• Tab: Indent (insert 4 spaces or indent selected lines)
• Shift+Tab: Unindent (remove up to 4 leading spaces)

Navigation

• Arrow Keys: Move cursor
• Ctrl+Up / Ctrl+Home: Move to first line
• Ctrl+Down / Ctrl+End: Move to last line
• Home / Ctrl+Left: Move to line start
• End / Ctrl+Right: Move to line end
• Page Up / Page Down: Scroll page up/down
• Ctrl+G: Go to line number

Selection

• Ctrl+S: Toggle selection mode (for terminals without Shift key support)
• Shift + Arrow Keys: Select text
• Shift + Home / End: Select to line start/end
• Shift + Page Up / Down: Select page up/down
• Shift + Ctrl + Arrows: Quick select to line/file start/end
• Ctrl+A: Select all
• ESC: Clear selection and messages

Note: In Ctrl+S selection mode, all movement keys (arrows, Home/End, Page Up/Down, Ctrl+arrows) will extend selection. Press Ctrl+S again, ESC, or perform any editing operation to exit selection mode.

Clipboard

• Ctrl+C: Copy (selection or current line)
• Ctrl+X: Cut (selection or current line)
• Ctrl+V: Paste
• Alt+C: Internal Copy (selection or current line)
• Alt+X: Internal Cut (selection or current line)
• Alt+V: Internal Paste

Search

• Ctrl+F: Find text (shows search dialog with previous search term)
• PageUp/Down: Smart navigation - jump to previous/next match in search mode, normal paging otherwise
• Ctrl+N: Smart jump down - next search match in search mode, page down otherwise
• Ctrl+P: Smart jump up - previous search match in search mode, page up otherwise
• ESC: Exit search mode (preserves search results)

Note: Search mode is activated when you press Ctrl+F and find matches. Press ESC to exit search mode and return to normal navigation. The search query and results are preserved until you perform a new search.

Code

• Ctrl+/ / Ctrl+\ / Ctrl+K: Toggle line comment
• Ctrl+L: Toggle line numbers (also toggles display mode)
• Ctrl+O: Toggle display mode only (wrap ↔ horizontal scroll)
• Ctrl+J: Toggle syntax highlighting (On/Off)

Help

• Ctrl+H: Show in-editor help dialog with all keyboard shortcuts

Supported Comment Styles

wedi automatically detects file type and applies appropriate comment style:

• Rust, C/C++, Java, JavaScript, TypeScript, Go, C#: //
• Python, Shell, PowerShell, Ruby, YAML, TOML: #
• SQL, Lua, Haskell: --
• Batch, CMD: REM
• Vim: "

Comments are highlighted in green color for better visibility.

Syntax Highlighting

wedi includes comprehensive syntax highlighting powered by bat's syntax definitions, supporting 219+ programming languages including:

• System Languages: Rust, Python, JavaScript, TypeScript, Go, C, C++, Java, C#, Swift, Kotlin, etc.
• Shell Scripts: Bash, Zsh, Fish, PowerShell, Batch File, etc.
• Markup & Data: JSON, YAML, TOML, XML, HTML, CSS, Markdown, LaTeX, etc.
• Database: SQL, GraphQL, etc.
• Configuration: Dockerfile, Makefile, Nginx, Git Config, INI, etc.

Syntax Highlighting

wedi provides intelligent syntax highlighting with automatic performance optimization:

• Smart Processing: Automatically adapts processing strategy based on file size
  • Small files (≤500 lines): Full processing from start for complete accuracy
  • Large files: Incremental processing (visible area ± 100 line buffer) for optimal performance
• Cache Optimization: Maintains highlighting cache for instant re-rendering
• Accurate Multi-line Syntax: Correctly handles multi-line constructs (comments, strings, heredocs)

Use Ctrl+J to toggle syntax highlighting on/off. The intelligent processing ensures both accuracy and performance automatically.

Technical Stack

• Language: Rust 2021 Edition
• Terminal Library: crossterm (terminal control and event handling)
• Text Buffer: ropey (efficient text buffer with undo/redo)
• Clipboard: arboard (cross-platform clipboard)
• CLI Parsing: clap (command-line argument parsing)
• Unicode Support: unicode-width (proper CJK character handling)
• Syntax Highlighting: syntect (syntax highlighting engine)
• Syntax Definitions: bat project's syntaxes.bin (219+ language definitions)

Development

Build

cargo build

Run

cargo run -- <filename>

Test

cargo test

Release Build

cargo build --release

License

MIT

Third-Party Acknowledgments

wedi uses syntax definitions from the bat project:

• Source: https://github.com/sharkdp/bat
• File: assets/syntaxes.bin (219+ language definitions)
• License: MIT License / Apache License 2.0 (dual licensed)
• Original Syntax Sources: Sublime Text Packages (MIT License)

The syntax definitions are embedded in the binary and are used under the terms of the MIT License. We are grateful to the bat project maintainers and the Sublime Text community for their excellent work on syntax definitions.

For complete third-party license information, see the bat project repository.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.