TermIDE

A cross-platform terminal-based IDE, file manager, and virtual terminal written in Rust.

Features

• Terminal-based IDE - Edit files directly in your terminal with syntax highlighting for 15+ programming languages (Rust, Python, JavaScript, TypeScript, Go, C/C++, Java, Ruby, PHP, Haskell, Nix, HTML, CSS, JSON, TOML, YAML, Bash, Markdown)
• Smart File Manager - Navigate and manage files with an intuitive TUI interface
• Integrated Virtual Terminal - Run commands without leaving the IDE with full PTY support
• Multi-panel Layout - Work with multiple files and terminals simultaneously
• Accordion Panel System - Smart panel grouping with automatic stacking based on terminal width, vertical accordion layout within horizontal groups, one expanded panel per group with others collapsed to title bar, configurable minimum panel width threshold (80 characters)
• Cross-platform - Works on Linux (x86_64, ARM64), macOS (Intel, Apple Silicon), and Windows (via WSL)
• Git Integration - See file status and changes at a glance with color-coded indicators and automatic updates
• 12 Built-in Themes - Choose from popular themes like Dracula, Nord, Monokai, Solarized, and more
• Custom Theme Support - Create and load your own themes from config directory
• System Resource Monitoring - Real-time CPU, RAM, and disk usage indicators with device names and color-coded alerts
• Batch Operations - Copy, move, and manage multiple files efficiently
• Search and Replace - Interactive modals with live search preview, match counter, Tab/Shift+Tab navigation, replace counter feedback, and state preservation
• Powerful Editing - Duplicate line/selection (Ctrl+D), configurable tab size, undo/redo (Ctrl+Z/Ctrl+Y), word wrap with accurate mouse selection
• Multi-language Support - UI localization for 9 languages (English, Chinese, French, German, Hindi, Portuguese, Russian, Spanish, Thai) with full Cyrillic keyboard layout support (case-preserving hotkey translation)
• Clipboard System - Reliable cut/copy/paste with persistent singleton for both CLIPBOARD and PRIMARY selections
• Robust Error Handling - Graceful fallbacks for theme errors, file size limits (100 MB), and clear error messages
• Mouse Support - Full mouse support for all panels and UI elements with panel close confirmation

Installation

Quick Start: Download pre-built binaries from GitHub Releases or install via your package manager.

Supported Platforms: Linux (x86_64, ARM64, WSL), macOS (Intel, Apple Silicon)

Choose Your Installation Method

# Linux x86_64 (also works in WSL)
wget https://github.com/termide/termide/releases/latest/download/termide-0.4.0-x86_64-unknown-linux-gnu.tar.gz
tar xzf termide-0.4.0-x86_64-unknown-linux-gnu.tar.gz
./termide

# macOS Intel (x86_64)
curl -LO https://github.com/termide/termide/releases/latest/download/termide-0.4.0-x86_64-apple-darwin.tar.gz
tar xzf termide-0.4.0-x86_64-apple-darwin.tar.gz
./termide

# macOS Apple Silicon (ARM64)
curl -LO https://github.com/termide/termide/releases/latest/download/termide-0.4.0-aarch64-apple-darwin.tar.gz
tar xzf termide-0.4.0-aarch64-apple-darwin.tar.gz
./termide

# Linux ARM64 (Raspberry Pi, ARM servers)
wget https://github.com/termide/termide/releases/latest/download/termide-0.4.0-aarch64-unknown-linux-gnu.tar.gz
tar xzf termide-0.4.0-aarch64-unknown-linux-gnu.tar.gz
./termide

# x86_64
wget https://github.com/termide/termide/releases/download/0.4.0/termide_0.2.0_amd64.deb
sudo dpkg -i termide_0.2.0_amd64.deb

# ARM64
wget https://github.com/termide/termide/releases/download/0.4.0/termide_0.2.0_arm64.deb
sudo dpkg -i termide_0.2.0_arm64.deb

# x86_64
wget https://github.com/termide/termide/releases/download/0.4.0/termide-0.4.0-1.x86_64.rpm
sudo rpm -i termide-0.4.0-1.x86_64.rpm

# ARM64
wget https://github.com/termide/termide/releases/download/0.4.0/termide-0.4.0-1.aarch64.rpm
sudo rpm -i termide-0.4.0-1.aarch64.rpm

# Build from source
yay -S termide

# Or install pre-built binary
yay -S termide-bin

git clone https://aur.archlinux.org/termide.git
cd termide
makepkg -si

brew tap termide/termide
brew install termide

# Run without installing
nix run github:termide/termide

# Install to user profile
nix profile install github:termide/termide

# Or add to NixOS configuration.nix
{
  nixpkgs.overlays = [
    (import (builtins.fetchTarball "https://github.com/termide/termide/archive/main.tar.gz")).overlays.default
  ];
  environment.systemPackages = [ pkgs.termide ];
}

cargo install termide

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

# Build and run
cargo run --release

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

# Enter development environment (includes Rust toolchain and all dependencies)
nix develop

# Build the project
cargo build --release

# Run
./target/release/termide

Requirements

• For pre-built binaries: No additional requirements
• For building from source:
  • Rust 1.70+ (stable)
  • For Nix users: Nix with flakes enabled

Usage

Quick Start

After launching TermIDE, you'll see:

• File manager panel on the left
• Welcome panel on the right (when no other panels are open)
• Menu bar at the top
• Status bar at the bottom

Use Alt+M to open the menu or Alt+H for help.

Documentation

For detailed documentation, see:

• English: doc/en/README.md
• Russian: doc/ru/README.md

Keyboard Shortcuts (Quick Reference)

Global:

• Alt+M - Toggle menu
• Alt+H - Show help
• Alt+Q - Quit application
• Alt+Left / Alt+Right - Switch between panel groups (horizontal navigation)
• Alt+Up / Alt+Down - Navigate panels within group (vertical navigation)
• Alt+W / Alt+S / Alt+A / Alt+D - WASD-style panel navigation (alternative to arrows)
• Alt+PgUp / Alt+PgDn - Move panel to previous/next group
• Alt+Home / Alt+End - Move panel to first/last group
• Alt+Plus (=) / Alt+Minus (-) - Increase/decrease active group width
• Escape / Alt+X / Alt+Delete - Close current panel
• Alt+Backspace - Toggle panel stacking (merge single panel into adjacent group or unstack panel from group)

File Manager:

• Enter - Open file or enter directory
• Backspace - Go to parent directory
• Space - Show file/directory information
• Insert - Toggle file selection
• Ctrl+A - Select all files
• F - Create new file
• D / F7 - Create new directory
• C / F5 - Copy selected files
• M / F6 - Move/rename files
• Delete / F8 - Delete selected files

Editor:

• Ctrl+S - Save file
• Ctrl+Z / Ctrl+Y - Undo/Redo
• Ctrl+F - Find text (interactive modal with live preview)
• Ctrl+H - Replace text (interactive modal with two fields)
• F3 / Shift+F3 - Next/Previous match
• Tab / Shift+Tab - Navigate matches (when search active)
• Escape - Close search/modal first, then close panel
• Ctrl+C / Ctrl+X / Ctrl+V - Copy/Cut/Paste
• Mouse support: Click buttons in modals, [X] to close panels

Panels:

• Alt+F - New file manager
• Alt+T - New terminal
• Alt+E - New editor
• Alt+L - New debug log panel
• Alt+P - Open configuration file in editor

Configuration

TermIDE follows the XDG Base Directory Specification for file organization.

Configuration file location:

• Linux/BSD: ~/.config/termide/config.toml (or $XDG_CONFIG_HOME/termide/config.toml)
• macOS: ~/Library/Application Support/termide/config.toml
• Windows: %APPDATA%\termide\config.toml

Session data location:

• Linux/BSD: ~/.local/share/termide/sessions/ (or $XDG_DATA_HOME/termide/sessions/)
• macOS: ~/Library/Application Support/termide/sessions/
• Windows: %APPDATA%\termide\sessions\

Log file location:

• Linux/BSD: ~/.cache/termide/termide.log (or $XDG_CACHE_HOME/termide/termide.log)
• macOS: ~/Library/Caches/termide/termide.log
• Windows: %LOCALAPPDATA%\termide\cache\termide.log

Example Configuration

# Theme name - choose from built-in themes or use a custom theme
theme = "default"

# Tab size (number of spaces per tab)
tab_size = 4

# Language (auto, de, en, es, fr, hi, pt, ru, th, zh)
# "auto" detects from environment variables (TERMIDE_LANG, LANG, LC_ALL)
language = "auto"

# System resource monitor update interval in milliseconds (default: 1000)
resource_monitor_interval = 1000

# Minimum panel width for horizontal layout (default: 80)
# Panels narrower than this will stack vertically
min_panel_width = 80

# Show git diff colors on line numbers in editor (default: true)
show_git_diff = true

# Enable word wrap in editor (default: true)
word_wrap = true

# Minimum log level: debug, info, warn, error (default: info)
min_log_level = "info"

# Session retention period in days (default: 30)
# Sessions older than this will be automatically deleted on startup
session_retention_days = 30

# File manager extended view width (default: 50)
# Minimum width to display size and time columns
fm_extended_view_width = 50

# Optional: Custom log file path
# log_file_path = "/custom/path/to/termide.log"

Available Themes

Dark Themes:

• default - Default dark theme
• midnight - Midnight Commander inspired theme
• dracula - Popular Dracula theme
• onedark - Atom One Dark theme
• monokai - Classic Monokai theme
• nord - Nord theme with blue tones
• solarized-dark - Dark Solarized theme

Light Themes:

• atom-one-light - Atom One Light theme
• ayu-light - Ayu Light theme
• github-light - GitHub Light theme
• material-lighter - Material Lighter theme
• solarized-light - Light Solarized theme

Theme Examples:

Dracula Theme

Monokai Theme

Custom Themes

You can create custom themes by placing TOML files in the themes directory:

• Linux: ~/.config/termide/themes/
• macOS: ~/Library/Application Support/termide/themes/
• Windows: %APPDATA%\termide\themes\

User themes take priority over built-in themes with the same name. See themes/ directory in the repository for theme file format examples.

Language Configuration

You can also set the language via environment variable:

export TERMIDE_LANG=ru  # Set Russian UI
./termide

Development

Project Structure

src/
├── app/           # Application core and event handling
├── config.rs      # Configuration management
├── constants.rs   # Application constants
├── i18n/          # Internationalization (en, ru)
├── panels/        # Panel implementations (file manager, editor, terminal)
├── state.rs       # Application state management
├── system_monitor.rs  # CPU/RAM monitoring
├── theme.rs       # Theme system and built-in themes
└── ui/            # UI components (menus, modals, status bar)

themes/            # Built-in theme definitions (TOML files)
doc/
├── en/            # English documentation
└── ru/            # Russian documentation

Building

# Development build
cargo build

# Release build with optimizations
cargo build --release

# Run tests
cargo test

# Check code quality
cargo clippy
cargo fmt --check

Nix Development

The project includes a Nix flake for reproducible development environments:

# Enter development shell
nix develop

# Build with Nix
nix build

# Run checks
nix flake check

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

License

This project is licensed under the MIT License.

Acknowledgments

Built with:

• ratatui - Terminal UI framework
• crossterm - Cross-platform terminal manipulation
• portable-pty - PTY implementation
• tree-sitter - Syntax highlighting
• ropey - Text buffer
• sysinfo - System resource monitoring