Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ICTREE(1)		    General Commands Manual		     ICTREE(1)

NAME
       ictree -	like tree but interactive

SYNOPSIS
       ictree [OPTION...]  [FILE]

DESCRIPTION
       ictree is a terminal-based program that takes a list of contents	of di-
       rectories  and  displays	 them in a pager similar to less where you can
       fold/unfold directories and quickly jump	between	them.

       It is useful to browse locate, find or any other	program	output that is
       a list of paths.

EXAMPLES
       Find something with locate and pipe output into ictree:

	      locate something | ictree

       The same	applies	to any program that can	produce	a list of paths.   For
       example,	one can	use find with ictree to	view 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

       ictree supports vi-like search functionality.  Extended regular expres-
       sions  are supported.  If a pattern contains / character, the search is
       performed by full paths of items	instead	of their short	names  in  the
       list.

COMMANDS
       All the commands	for moving in the pager	resemble less and vi commands.

   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 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 (using this com-
	      mand requires xsel or wl-copy installed, depending on which dis-
	      play server is used)

       o      Write selected item to standard output and exit

       q, <Esc>
	      Quit

       ^Z     Suspend ictree

CUSTOM COMMANDS
       It's possible to	define custom commands in the configuration file  (see
       FILES) to open a	selected path in other programs.

       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.

       Note: unlike Vim, it's impossible to use	more than one character	 in  a
       mapping.

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
	      Configuration   file.    If  $XDG_CONFIG_PATH  is	 not  defined,
	      $HOME/.config is used instead.

SEE ALSO
       tree(1),	find(1), locate(1), less(1)

AUTHOR
       Written by Nikita Ivanov.

								     ICTREE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ictree&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help