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