dtree - Directory Tree Navigator

A fast, lightweight, and feature-rich TUI for interactive directory tree navigation.

Why dtree?

dtree combines the simplicity of tree with the power of modern file managers, creating the perfect tool for developers who live in the terminal. Unlike traditional file managers that try to do everything, dtree focuses on what matters most: fast navigation and intelligent file viewing.

Navigate instantly. Jump between projects with bookmarks, find files with fuzzy search, and preview code with syntax highlighting - all without leaving your keyboard. No more endless cd commands or opening heavy GUIs just to peek at a file.

Stay in flow. Built with Rust for blazing-fast performance and zero-copy operations, dtree handles massive directory trees without breaking a sweat. Asynchronous search runs in the background while you keep working. Your terminal, your speed.

Your tool, your way. Fully customizable themes, configurable keybindings, and seamless shell integration. Works beautifully with vim-style navigation, integrates with your favorite editor, and fits naturally into your existing workflow.

Features

• 🌳 Interactive Tree View - Visual directory navigation with expand/collapse
• 📄 File Preview - Syntax-highlighted preview for 100+ languages
• 🔍 Fuzzy Search - Fast asynchronous search with intelligent matching
• 🔖 Bookmarks - Save and quickly jump to favorite directories
• 📏 Directory Sizes - Async calculation with visual indicators
• 🖥️ Fullscreen Viewer - Dedicated file viewer with search and tail mode
• ✂️ Visual Selection - Vim-style line selection with keyboard and mouse
• 🔧 Binary File Support - Automatic detection with hex editor integration
• 🎨 Customizable - TOML configuration with full theme support
• 🖱️ Mouse Support - Click, drag, scroll, and resize
• ⚡ Fast - Zero-copy tree operations, async background tasks

Quick Start

# Build from source
git clone https://github.com/holgertkey/dtree.git
cd dtree
cargo build --release
cp target/release/dtree ~/bin/

# Launch from current directory
dt

# Navigate to a directory
dt /path/to/directory

# View a file in fullscreen
dt -v README.md

# Create and use bookmarks
dt                    # Open dtree
# Press 'm' to create bookmark
# Press 'q' to exit
dt myproject          # Jump to bookmark instantly

# Basic navigation inside dtree:
# j/k - move up/down
# l/h - expand/collapse
# v - fullscreen viewer
# V - visual selection mode (in fullscreen)
# s - toggle file preview
# / - search
# i - help

Installation

Linux / macOS

Automated Installation (Recommended)

The easiest way to install dtree on Linux is using the automated installation script:

# Clone repository
git clone https://github.com/holgertkey/dtree.git
cd dtree

# Run automated installation (builds and installs everything)
./install-linux.sh

What this script does:

• ✅ Builds the release binary (dtree)
• ✅ Installs to ~/bin/dtree
• ✅ Adds ~/bin to PATH (if needed)
• ✅ Installs bash wrapper function to .bashrc (or .zshrc for zsh users)
• ✅ Tests the installation

After installation:

1. Reload your shell: source ~/.bashrc
2. Test with: dt --version
3. Try: dt to open interactive tree

Manual Installation (From Source)

If you prefer to install manually:

git clone https://github.com/holgertkey/dtree.git
cd dtree
cargo build --release

# Install to user bin
mkdir -p ~/bin
cp target/release/dtree ~/bin/

# Or install system-wide
sudo cp target/release/dtree /usr/local/bin/

Bash Integration (Manual Setup)

Add this to your ~/.bashrc for seamless shell integration:

# Directory tree navigator
dt() {
  # Store current directory before navigation
  local prev_dir="$PWD"

  # Handle special case: dt - (return to previous directory)
  if [ "$1" = "-" ]; then
    if [ -n "$DTREE_PREV_DIR" ] && [ -d "$DTREE_PREV_DIR" ]; then
      cd "$DTREE_PREV_DIR" || return
      export DTREE_PREV_DIR="$prev_dir"
    else
      echo "dt: no previous directory" >&2
      return 1
    fi
    return
  fi

  # If flags or bookmark commands are passed, run dtree directly
  case "$1" in
    -h|--help|--version)
      command dtree "$@"
      return
      ;;
    -bm)
      # Bookmark management - run directly
      command dtree "$@"
      return
      ;;
  esac

  # For navigation: dtree resolves paths/bookmarks
  local result=$(command dtree "$@")
  local exit_code=$?

  if [ $exit_code -ne 0 ]; then
    return $exit_code
  fi

  # Only cd if result is a valid directory
  if [ -n "$result" ] && [ -d "$result" ]; then
    cd "$result" || return
    # Save previous directory for dt -
    export DTREE_PREV_DIR="$prev_dir"
  fi
}

Then reload your shell:

source ~/.bashrc

Windows

Automated Installation (Recommended)

The easiest way to install dtree on Windows is using the automated installation script:

# Clone repository
git clone https://github.com/holgertkey/dtree.git
cd dtree

# Run automated installation (builds and installs everything)
.\install-windows-binary.ps1

What this script does:

• ✅ Builds the release binary (dtree.exe)
• ✅ Installs to C:\Users\<YourName>\bin\
• ✅ Installs dt.bat wrapper for cmd.exe
• ✅ Installs PowerShell dt function for seamless navigation
• ✅ Adds directory to PATH
• ✅ Tests the installation

After installation:

1. Restart PowerShell (or run . $PROFILE to reload)
2. Test with: dt --version
3. Try: dt to open interactive tree

Manual Installation

If you prefer to install manually:

# 1. Build the project
cargo build --release

# 2. Create bin directory and copy binary
New-Item -Path "$env:USERPROFILE\bin" -ItemType Directory -Force
Copy-Item target\release\dtree.exe "$env:USERPROFILE\bin\"
Copy-Item dt.bat "$env:USERPROFILE\bin\"

# 3. Add to PATH (restart terminal after this)
$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$currentPath;$env:USERPROFILE\bin", "User")

# 4. Install PowerShell wrapper
.\install-windows-wrapper.ps1

# 5. Reload PowerShell profile
. $PROFILE

PowerShell Integration

The PowerShell wrapper enables directory navigation with bookmarks. It's automatically installed by the installation script.

If you need to reload the wrapper (after reinstalling):

# Option 1: Reload profile in current session
. $PROFILE

# Option 2: Reinstall wrapper
.\install-windows-wrapper.ps1

# Option 3: Restart PowerShell

Verify installation:

# Check version
dt --version

# Test bookmark navigation
dt -bm add test          # Create bookmark
dt test                  # Navigate to bookmark (should change directory)
pwd                      # Verify current directory changed

Cmd.exe Support

The dt.bat wrapper is automatically installed and provides the same functionality in cmd.exe:

REM Basic commands
dt --version        REM Show version
dt                  REM Open interactive tree
dt C:\Windows       REM Navigate to directory
dt -                REM Return to previous directory
dt -bm list         REM List bookmarks

Configuration

After first run, configuration file will be created at:

• Config: %APPDATA%\dtree\config.toml
• Bookmarks: %APPDATA%\dtree\bookmarks.json

Typically located at: C:\Users\<YourName>\AppData\Roaming\dtree\

Troubleshooting

Problem: dtree.exe not found

Check if directory is in PATH:

# Check PATH
$env:PATH -split ';' | Select-String "bin"

# Restart terminal to pick up PATH changes

Problem: Permission denied when running scripts

You may need to allow script execution:

# Check current policy
Get-ExecutionPolicy

# Allow scripts (run as Administrator)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

CLI Commands

Basic Usage

# Launch interactive tree from current directory
dt

# Navigate to specific directory
dt /path/to/directory

# Jump to bookmark
dt myproject

# Return to previous directory (like cd -)
dt -

File Viewing

# View file in fullscreen mode
dt -v README.md
dtree --view README.md

# After viewing, press 'q' to navigate to file's directory

Bookmark Management

# List all bookmarks
dt -bm
dt -bm list

# Add bookmark for current directory
dt -bm add myproject

# Add bookmark for specific path
dt -bm add myproject /path/to/directory

# Remove bookmark
dt -bm remove myproject

Help and Version

# Show help
dtree -h
dtree --help

# Show version
dtree --version

Navigation Priority

When you run dt <name>, dtree resolves in this order:

1. Bookmark - If bookmark exists, jump to it
2. Path - If valid path, navigate to it
3. Error - Show error message

Keyboard Shortcuts

Tree Navigation

File Viewing (Split View)

Fullscreen Viewer

Visual Selection Mode (Fullscreen Viewer)

Search (Tree Search)

Fuzzy Search: Start query with / for fuzzy matching (e.g., /fuz finds "fuzzy.rs")

Bookmarks

File Operations

Other

Mouse Support

* Scroll speed configurable via mouse_scroll_lines in config.toml (default: 5 lines per scroll)

Key Features

🔍 Intelligent Search

• Two-phase search: Quick local search + deep background search
• Fuzzy matching: Start query with / for fuzzy mode
• Async: Non-blocking UI during search
• Ranked results: Best matches first with relevance scores

🔖 Powerful Bookmarks

• Multi-character names: Use descriptive names like myproject-backend
• CLI management: Add, remove, list from command line
• Direct navigation: dt myproject jumps instantly
• Filter mode: Type to filter bookmarks by name or path
• Safe deletion: Two-phase deletion prevents accidents

📄 Advanced File Viewer

• Syntax highlighting: 100+ languages supported
• Line numbers: Toggle with l key
• Search within files: Press / in fullscreen mode, navigate with n/N
• Tail mode: View last 10,000 lines of large files (perfect for logs)
• Visual selection mode: Vim-style line selection with V key
  • Select lines with j/k keyboard navigation
  • Use mouse scroll to expand selection
  • Copy to clipboard with y
  • Visual feedback with highlighted selection and cursor
• Text selection: Shift+Mouse drag for quick selection

🎨 Customization

Configuration file: ~/.config/dtree/config.toml

[appearance]
split_position = 50
show_icons = true
enable_syntax_highlighting = true
syntax_theme = "base16-ocean.dark"

[appearance.colors]
selected_color = "cyan"
directory_color = "blue"
file_color = "white"

[behavior]
max_file_lines = 10000
wrap_lines = true           # Wrap long lines (true) or truncate (false)
mouse_scroll_lines = 5      # Number of lines to scroll with mouse wheel (default: 5)
editor = "nvim"
hex_editor = "hexyl"
file_manager = "ranger"

📦 Binary File Support

• Auto-detection: Checks for NULL bytes
• Hex editor integration: Press e to view in hex editor
• Supported types: Executables, images, archives, videos, PDFs, databases

Screenshots & Demos