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

  
 
  

home | help
FAR2L(1)		  Linux fork of FAR Manager v2			FAR2L(1)

NAME
     far2l  -  Two-panel  file manager, with built-in terminal and other useful-
     ness'es.

SYNOPSIS
     far2l [OPTION] [-cd APATH -cd PPATH]]
     far2ledit [OPTION] [FILENAME]

DESCRIPTION
     far2l is a Linux fork of FAR Manager v2, directory browser/file manager for
     Unix-like operating systems.

OPTIONS
     -h     Display short help and exit.

     --version
	    Display the version of the program and exit.

     -a     Disable display of characters with codes 0 - 31 and 255.

     -ag    Disable display of pseudographics with codes > 127.

     -an    Disable display of pseudographics characters completely.

     -co    Forces FAR to load plugins from the cache only.

     -cd APATH|PPATH
	    Change panel's directory to specified  path.   APATH  -  path  to  a
	    folder  (or a file or an archive or command with prefix) for the ac-
	    tive panel.  PPATH - path to a folder (or a file or  an  archive  or
	    command with prefix) for the passive panel.

     -m     Do not load macros.

     -ma    Do not execute auto run macros.

     -u IDENTITY OR /PATH/NAME
	    Allows  to	specify  separate  settings  IDENTITY or FS location (it
	    override FARSETTINGS environment variable value).

     -v FILENAME
	    View the specified file.

     -v - COMMAND LINE
	     Executes given COMMAND LINE and opens viewer with its output.

     -e[LINE[:POS]] [FILENAME]
	     Edit the specified file with optional cursor position specification
	    or empty new file.

     -e[LINE[:POS]] - COMMAND LINE
	    Executes given command line and opens editor with its output.

     -set:PARAMETER=VALUE
	    Override the configuration parameter, see far:config for details.
	    Example: far2l -set:Language.Main=English -set:Screen.Clock=0 -set:XLat.Flags=0xff -set:System.FindFolders=false

BACKEND-SPECIFIC OPTIONS
     --tty  force using TTY backend only (disable GUI/TTY autodetection)

     --notty
	    don't fallback to TTY backend if GUI backend failed

     --norgb
	    don't use true (24-bit) colors

     --nodetect, --nodetect=[x|xi][f][w][a][k]
	    don't detect if TTY backend supports X11/Xi input and clipboard  in-
	    teraction  extensions  and/or disable detect f=FAR2l terminal exten-
	    sions, w=win32, a=apple iTerm2, k=kovidgoyal's  kitty  input  modes;
	    this  switch  without  parameters  disables  all this functionality,
	    forcing plain terminal mode for TTY backend.

     --mortal
	    terminate instead of going to background on getting SIGHUP	(default
	    if in Linux TTY)

     --immortal
	    go	to  background instead of terminating on getting SIGHUP (default
	    if not in Linux TTY)

     --x11  force GUI backend to  run  on  X11/Xwayland  (force  make  GDK_BACK-
	    END=x11)

     --wayland
	    force GUI backend to run on Wayland (force make GDK_BACKEND=wayland)

     --ee=N
	    ESC  expiration in msec (default is 100, 0 to disable) to avoid need
	    for double ESC presses (valid only in TTY mode without FAR2L  exten-
	    sions)

     --primary-selection
	    use  PRIMARY  selection instead of CLIPBOARD X11 selection (only for
	    GUI backend)

     --maximize
	    force maximize window upon launch (only for GUI backend)

     --nomaximize
	    dont maximize window upon launch even if  its  has	saved  maximized
	    state (only for GUI backend)

     --size=WxH
	    set initial window size in characters (only for GUI backend)

     --clipboard=SCRIPT
	    use  external  clipboard handler script that implements get/set text
	    clipboard data via its stdin/stdout

ENVIRONMENT
     FARSETTINGS
	    Override location of user settings and configuration files (see  op-
	    tion -u).

     FAR2L_ARGS
	    All  options  (except  -h and -u) also can be set via the FAR2L_ARGS
	    environment variable
	    (for example: export FAR2L_ARGS="--tty --nodetect" and then simple far2l to force start only TTY backend).

FULL HELP
     far2l historically has its own contextual help system that can be found via
     pressing F1 key wherever in its TUI.

LICENSE
     This program is distributed under the terms of the GNU General  Public  Li-
     cense  as	published by the Free Software Foundation. See the built-in help
     for details on the License and the lack of warranty.

AVAILABILITY
     The   latest   version    of    this    program	can    be    found    at
	  https://github.com/elfmz/far2l

SEE ALSO
     mc(1),  ed(1),  gpm(1),  terminfo(1),  view(1),  sh(1),  bash(1),	tcsh(1),
     zsh(1).

     Linux fork of FAR Manager v2 on the World Wide Web:
	  https://github.com/elfmz/far2l

AUTHORS
     Authors and contributors are listed in the copyright file.

BUGS
     If you want to report a problem with the program, please  create  bugreport
     at https://github.com/elfmz/far2l/issues.

     Provide  a  detailed description of the bug, the version of the program you
     are running.  If the program crashes, we would appreciate a stack trace.

FAR2L Version 2.8.0		   March 2026				FAR2L(1)

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

home | help