1 .Dd $Mdocdate: November 26 2021$
2 .Dt FM 1
3 .Os
4 .Sh NAME
5 .Nm fm
6 .Nd file manager
7 .Sh SYNOPSIS
8 .Nm
9 .Bk -words
10 .Op Fl hv
11 .Op Fl d Ar file
12 .Op Fl m Ar file
13 .Op Ar directories...
14 .Ek
15 .Sh DESCRIPTION
16 .Nm
17 is an utility designed to browse the filesystem via a tabbed interface.
18 .Pp
19 The arguments are as follows:
20 .Bl -tag -width 14m
21 .It Fl d Ar file
22 Write the last visited path to
23 .Ar file
24 before exiting.
25 .It Fl h , Fl -help
26 Print help message and exit.
27 .It Fl m Ar file
28 Write the path of all the marked entries to
29 .Ar file
30 upon exiting.
31 .It Fl v , Fl -version
32 Print program version and exit.
33 .El
34 .Pp
35 In its most basic usage,
36 .Nm
37 will gather a list of directory entries and present it on the screen.
38 There is always one
39 .Pq and only one
40 highlighted entry visible.
41 This is both the cursor location and the current selection.
42 .Pp
43 It's also possible to select all the entries to be processed and apply
44 the same command to all of them: this is called the mark.
45 Unlike simple selection, the effect of marks is not constrained by
46 visibility: marks are shared across all the tabs.
47 For such purpose,
48 .Nm
49 allows an arbitrary number fo entries to be marked, with the only
50 limitation that they must be all in the same directory.
51 .Pp
52 There are ten tabs in total, numbered from 0 to 9, but only one tab is
53 visible on the screen at any given moment.
54 The number associated with the current tab is visible on the right corner
55 of the screen.
56 It's possible to set the current working directory for the tabs at start
57 up by passing the desired paths as extra command-line arguments.
58 The tab at index 0 always starts at
59 .Ev $HOME .
60 If more than nine directories are specified, the extra ones will be
61 silently discarded.
62 Tabs for wich an invalid path was assigned will also start at
63 .Ev $HOME .
64 By default tabs starts at the current working directory.
65 .Sh KEYS
66 These commands are currently recognized
67 .Pq ^L refers to control-L and M-a to meta-a
68 .Pp
69 .Bl -tag -width 20m -compact
70 .It ?
71 Display
72 .Nm
73 manual page.
74 .It ^ | h | b
75 Go up to previous directory.
76 .It H
77 Go to home directory.
78 .It J | ^V | page down
79 Scroll down by one screen.
80 .It K | M-v | page up
81 Scroll up by one screen.
82 .It ^G
83 Do nothing.
84 .It j | n | ^N | down
85 Scroll down by one line.
86 .It k | p | ^P | up
87 Scroll up by one line.
88 .It l | f
89 Go to selected directory.
90 .It Y
91 Copy current path.
92 .It P
93 Paste path
94 .Pq goto previously copied path.
95 .It ^L
96 Refresh and redraw screen.
97 .It ^M
98 Spawn a shell
99 .It v
100 View file with a pager.
101 .It e
102 Edit file with an editor.
103 .It o
104 Open the file with an external application.
105 .It m
106 Toggle mark on the file at point.
107 .It M
108 Mark all files
109 .It t
110 Toggle marking.
111 .It q
112 Quit
113 .Nm .
114 .El
115 .Sh SEE ALSO
116 .Xr mc 1 ,
117 .Xr nnn 1 ,
118 .Xr noice 1 ,
119 .Xr ranger 1 ,
120 .Xr rover 1 ,
121 .Xr vifm 1
122 .Sh HISTORY
123 .Nm
124 was forked from
125 .Xr rover 1 .
126 .Sh CAVEATS
127 .Nm
128 never asks for confirmation before overwriting existing files.
129 Please be careful.