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