⚡️ Termix

A modern, high-performance file navigator for your terminal

---

Built with .NET 10 and Spectre.Console, Termix delivers a fluid, visually rich experience for navigating, searching, and managing files and your most-used directories, all from your terminal.

Read the Full Documentation

---

Demo

termix.mp4

Watch the full walkthrough → Termix on Vimeo (1 minute)

Features

• Intuitive Vim-Style Navigation: Move efficiently with h j k l, gg / G, and Ctrl+u / Ctrl+d.
• Real-time Recursive Search: Press s and start typing to instantly filter your entire directory tree.
• Advanced Bookmark System: Press m to mark a directory, then press b to open a filterable menu and instantly jump to any saved location.
• Powerful Visual Mode: Press v to select multiple files and perform batch operations (yank, cut, delete) with ease.
• Rich Previews: View text files with syntax highlighting, render images in the terminal, and browse archive contents.
• Smart Ignoring: Automatically respects .gitignore files to keep your views clean and relevant.
• Nerd Font Support: Enhanced with icons for file types, with a graceful ASCII fallback for universal compatibility.
• Cross-Platform: A single, consistent experience on Windows, macOS, and Linux.

Installation

Recommended: Install via Script (All Platforms)

Our installation scripts automatically download the latest native, self-contained version of Termix, which does not require the .NET SDK to be installed.

macOS / Linux:

# Install or update to the latest version
curl -fsSL https://raw.githubusercontent.com/amrohan/termix/main/install.sh | bash

Windows (PowerShell):

# Install or update to the latest version
iex (iwr "https://raw.githubusercontent.com/amrohan/termix/main/install.ps1")

For more options, like installing a specific version or uninstalling, see the Installation Guide.

Alternative: .NET Global Tool

This method is for users who prefer to manage Termix through the dotnet tool ecosystem.

Requirements

• Termix v3.0.0 and newer: Requires the .NET 10 SDK or later.
• Termix v2.x.x (e.g., v2.6.0): Requires the .NET 9 SDK.

Commands

To install the latest version (requires .NET 10 SDK):

dotnet tool install --global termix

To install a specific older version compatible with the .NET 9 SDK:

dotnet tool install --global termix --version 2.6.0

Core Commands

Termix uses Vim-style, case-sensitive keybindings. Press ? in the app for a full, scrollable list.

Key(s)	Action
↑ / k	Move selection up
↓ / j	Move selection down
h / Backspace	Navigate to parent directory
l / Enter	Open file or enter directory
gg / G	Jump to top / bottom of list
s	Start real-time recursive search
O	Open in external editors/apps
v	Enter/Exit Visual Mode for multi-select
m	Mark (Add) a new bookmark
b	Open the Bookmark menu
y	Yank (copy) selected item(s) to clipboard
Y	Yank Path to system clipboard
x	Cut (move) selected item(s) to clipboard
p	Paste from clipboard
d	Delete selected item(s) (with confirmation)
a	Add a new file or directory
r	Rename selected item
t	Open the interactive sort menu
?	Show/Hide the Help Screen
q	Quit Termix

Documentation

For a complete guide on workflows, features, and advanced usage, please visit the * *official documentation site**.

Contributing

Contributions are welcome! Whether it's bug reports, feature requests, or code contributions, please feel free to get involved.

• Report a Bug or Request a Feature: Please open an issue on the GitHub Issues page.
• Contribute Code: Fork the repository and submit a pull request. Please see our CONTRIBUTING.md file for development setup and guidelines.

Acknowledgements

• This project is made possible by the fantastic Spectre.Console library.
• File previews are enhanced by ImageSharp and SharpCompress.
• Icons are provided by the Nerd Fonts project.

License

Termix is licensed under the MIT License.