xplr

# Homebrew (macOS)
brew install xplr

# Cargo (Rust)
cargo install xplr

# APT (Debian/Ubuntu)
sudo apt install xplr

# Pacman (Arch Linux)
sudo pacman -S xplr

# From source
git clone https://github.com/sayonara-q/xplr.git
cd xplr
cargo install --path .

-- ~/.config/xplr/init.lua
-- Basic xplr configuration

-- Set default layout
xplr.config.layouts.builtin.default = {
  Horizontal = {
    config = { margin = 1, constraints = {} },
    splits = {
      { Vertical = { ratio = 30, splits = { 1 } } },
      { Vertical = { ratio = 70, splits = { 2 } } },
    }
  }
}

-- Configure key mappings
xplr.config.modes.builtin.default.key_bindings = {
  { on = "j", messages = { "FocusNextByRelativeIndexFromCursor", { ScrollDown = 1 } } },
  { on = "k", messages = { "FocusPreviousByRelativeIndexFromCursor", { ScrollUp = 1 } } },
  { on = "h", messages = { "Back" } },
  { on = "l", messages = { "Enter" } },
  { on = "q", messages = { "Quit" } },
  { on = "i", messages = { { BashExecSilently = "ls -lah" } } },
}

-- Disable mouse
xplr.config.general.mouse = false

-- Show icons
xplr.config.general.show_hidden = false

-- ~/.config/xplr/init.lua - Custom keybindings

xplr.config.modes.builtin.default.key_bindings = {
  -- Navigation
  { on = "j", messages = { "FocusNextByRelativeIndexFromCursor", { ScrollDown = 1 } } },
  { on = "k", messages = { "FocusPreviousByRelativeIndexFromCursor", { ScrollUp = 1 } } },
  { on = "h", messages = { "Back" } },
  { on = "l", messages = { "Enter" } },

  -- Selection
  { on = " ", messages = { "ToggleSelection" } },
  { on = "a", messages = { "SelectAll" } },
  { on = "u", messages = { "ClearSelection" } },

  -- File operations
  { on = "c", messages = { "CopyHere" } },
  { on = "m", messages = { "MoveHere" } },
  { on = "d", messages = { "Remove" } },

  -- Search and navigate
  { on = "/", messages = { "Search" } },
  { on = "?", messages = { "SearchRegex" } },

  -- Create
  { on = "n", messages = { "CreateFile" } },

  -- Quit
  { on = "q", messages = { "Quit" } },
  { on = "Q", messages = { "QuitWithoutChangingDirectory" } },
}

-- ~/.config/xplr/init.lua - Advanced configuration

-- Custom commands
xplr.config.commands.builtin.default:prepend({
  {
    messages = { { BashExec = "nvim '{{ SELECTION }}'" } },
    help = "Open in Neovim"
  }
})

-- Custom panel layout
xplr.config.layouts.builtin.default = {
  Horizontal = {
    config = { margin = 1, constraints = {} },
    splits = {
      { Vertical = { ratio = 25, splits = { 1 } } },
      { Vertical = { ratio = 75, splits = { 2, 3 } } },
    }
  }
}

-- Plugin loading
local home = os.getenv("HOME")
dofile(home .. "/.config/xplr/plugins/my-plugin/init.lua")

-- Theme customization
xplr.config.general.border = { type = "Rounded" }
xplr.config.general.selection.UI = "  "
xplr.config.general.focus_UI = "❯ "

-- Status bar configuration
xplr.config.general.logs = {
  error = { format = "[ERROR]", ui = { fg = "Red" } },
  warn = { format = "[WARN]", ui = { fg = "Yellow" } },
  info = { format = "[INFO]", ui = { fg = "Blue" } },
}

-- ~/.config/xplr/init.lua - Custom Lua functions

-- Custom function for directory statistics
function get_dir_stats(path)
  local count = 0
  for _ in io.popen("ls -1 '" .. path .. "' 2>/dev/null"):lines() do
    count = count + 1
  end
  return count
end

-- Custom function for file type coloring
function get_file_icon(filename)
  local ext = filename:match("%.([^%.]+)$")
  local icons = {
    lua = "🌙",
    rs = "🦀",
    py = "🐍",
    js = "⚡",
    json = "📋",
    md = "📝",
    txt = "📄",
    zip = "📦",
    pdf = "📕",
  }
  return icons[ext] or "📄"
end

-- Custom command that uses functions
xplr.config.commands.builtin.default:prepend({
  {
    messages = { { BashExec = "tree '{{ SELECTION }}' 2>/dev/null || find '{{ SELECTION }}' -type d | head -20" } },
    help = "Show directory tree"
  }
})