Small, simple and efficient file system viewer for the console. It offers fast navigation, easy invocation of your common tools (Emacs/Vim/Xpdf/less/...) and instant access to your favorite shell. It also can use Linux inotify to update the file tree.
It should run in any modern UNIX-like with minimal effort. You just need to have installed ncursesw, glib and its development headers. Then just run:
make
Internally the file system hierarchy is represented in a N-ary tree in which each node represents a file and its associated information. Additionally a double-linked list is used to represent the lines from screen. The glib is used for its N-ary trees and double-linked lists. Also some string manipulation functions are used for commodity. The rest is standard POSIX code.
Usage: fm [-h|-d] [<tree_root>]
The root of the displayed tree is `tree_root'.
-h: show this help
-d: print on stderr inotify events debug info
Most commands are based in text navigation of Vim.
Moving the cursor:
* j: select next file.
* k: select previous file.
* l: open selected directory (open the directory twice to show dot files).
* h: close current/selected directory.
* Ctrl + f: move one page forward the cursor.
* Ctrl + b: move one page backward the cursor.
* Ctrl + d: move half page forward the cursor.
* Ctrl + u: move half page backward the cursor.
* gg: select first file.
* G: select last file.
* zz: center selected file on screen.
* H: select first line from screen.
* L: select last line from screen.
* }: selects next file without going deeper in the hierarchy.
* {: selects previous file without going deeper in the hierarchy.
* [[: selects parent directory.
* f + <letter>: selects next file that begins with <letter>.
* F + <letter>: selects previous file that begins with <letter>.
Running external programs:
* l: opens the selected file with text pager/PDF viewer/PS viewer/image viewer (based on the file name extension).
* s: spawns the shell in the current directory (Use Ctrl + d to return).
* Enter: starts the editor with selected file.
Miscellanea:
* q: quits fm.
* Ctrl + l: redraws the entire screen and reloads the content of the current working directory.
* Ctrl + g: prints info from the selected like `ls -l`.
* Esc: clear info window. Set command repetitions to one.
The default choices for the external programs are vim/xpdf/gv/display. They are configured from fm.h. Also the can be customized setting the environment variables PAGER and EDITOR from the shell. The commands h j k l can be repeated several times with just one keystroke if a number is given first, just like Vim commands repetitions. The cursor can also be moved with the arrows from the keyboard.
Version 1.1 finished, Linux inotify support added.
The program is under the GPLv3.
Send me an email if you have any question about the code, you found a bug or you have a feature request. Send it to:
jimenezrick@gmail.com
Last modified date: Thu Jul 2 18:36:33 CEST 2009