ICTREE(1)

💅 ICTREE(1) — like tree but interactive

okay bestie, so this is from the General Commands Manual section, page ICTREE(1), and it's genuinely one of those tools that makes you go "wait why didn't I know about this sooner" 🫶

---

✨ NAME ✨

ictree — it's tree, but make it interactive 💅

🌸 SYNOPSIS 🌸

ictree [OPTION...]  [FILE]

🦋 DESCRIPTION 🦋

so ictree is this terminal-based program that takes a list of the contents of directories and shows them in a pager — think less, but ✨glowed up✨ — where you can fold/unfold directories and jump between them super fast. it's giving file-explorer energy but make it terminal 🎀

it's lowkey perfect for browsing locate, find, or literally any other program's output that happens to be a list of paths. slay.

🍓 EXAMPLES 🍓

find something with locate and pipe that output straight into ictree:

locate something | ictree

same deal applies to any program that can produce a list of paths. for example, you can use find with ictree to view the current working directory in a nice tree-like format:

find | ictree

ictree can also take a file that contains paths as its first argument:

locate something > list.txt
ictree list.txt

also!! ictree supports vi-like search functionality. extended regular expressions are supported, no cap. and if a pattern contains the / character, the search is performed by the full paths of items instead of their short names in the list. iykyk 🔥

👑 COMMANDS 👑

all the commands for moving around in the pager resemble less and vi commands. classic icons.

🌈 MOVING

• j, Down — move cursor down 1 line
• k, Up — move cursor up 1 line
• l, Right — scroll right
• h, Left — scroll left
• ^E, Mouse Wheel Down — scroll down one line
• ^Y, Mouse Wheel Up — scroll up one line
• ^D — scroll down half-window
• ^U — scroll up half-window
• ^F — scroll down one window
• ^B — scroll up one window
• g — move cursor to the top
• G — move cursor to the bottom
• z — put cursor at the center of window
• p — go to parent item

💜 OTHERS

• Enter, Mouse Left Button — fold/unfold the selected item
• Space — fold selected item and move cursor down 1 line
• c — go to parent item and fold it
• / — search forward for pattern
• ? — search backward for pattern
• n — repeat previous search
• N — repeat previous search in reverse direction
• y — copy selected item into X or Wayland clipboard. heads up: using this command requires xsel or wl-copy installed, depending on which display server is used 🫶
• o — write selected item to standard output and exit
• q, Esc — quit
• ^Z — suspend ictree

🧚 CUSTOM COMMANDS 🧚

it's totally possible to define custom commands in the configuration file (peep FILES below) to open a selected path in other programs. main character customization behavior, honestly.

examples:

# open selected path in vim by pressing e
map e vim $f

# open selected path in a pager
# defined in $PAGER environment variable
map i $PAGER $f

when a custom command is invoked, ictree simply runs a program with /bin/sh and sets $f variable to whatever a user has selected. easy.

note: unlike Vim, it's impossible to use more than one character in a mapping. one key, one vibe. periodt. 💀

⭐ OPTIONS ⭐

• --fold, -f — fold directories by default
• --separator=<C>, -s <C> — set directory separator to C. / is the default value
• --help, -h — print a help message and exit
• --version, -v — display version information and exit

🎀 FILES 🎀

• $XDG_CONFIG_PATH/ictree/config — the configuration file. if $XDG_CONFIG_PATH is not defined, $HOME/.config is used instead 🫶

🔥 SEE ALSO 🔥

tree(1), find(1), locate(1), less(1) — the whole friend group, love that for them 💖

🌟 AUTHOR 🌟

written by Nikita Ivanov. iconic behavior, honestly.

---

okay that's the whole page bestie!! this is ICTREE(1) from the General Commands Manual, and you've officially reached the end of the vibes 🌸 no cap, go fold some directories 💅✨