# literal = Do not resolve the target at all (like 'ln -s')

;LinkCreationMode=literal

# application (e.g. Ranger's rifle or xdg-open). If not specified, 'lira',

# Clifm's builtin opener, will be used.

;Opener=

complete -c clifm -l no-welcome-message -d 'Disable the welcome message'

complete -c clifm -l only-dirs -d 'List only directories and symbolic links to directories'

complete -c clifm -l open -r -d 'Open FILE (via Lira) and exit'

complete -c clifm -l pager-view -r -d 'How to list files in the pager' -x -a 'auto long short'

complete -c clifm -l physical-size -r -d 'Same as --no-apparent-size'

complete -c clifm -l preview -r -d 'Display a preview of FILE (via shotgun) and exit'

'--no-welcome-message[disable the welcome message]'

'--only-dirs[list only directories and symbolic links to directories]'

'--open=[open FILE and exit]:filename:_files'

'--pager-view=[how to list files in the pager: auto (default), long, short]:pager_view:->pager_views'

'--physical-size[same as --no-apparent-size]'

'--preview=[display a preview of FILE and exit]:filename:_files'

.sp

\fB8.\fR Builtin expansions

.sp

.sp

\fB10.\fR Shotgun, a builtin files previewer

.sp

list only up to \fINUM\fR files. Use \-1 or \'unset\' to remove this limit (default). See the \fImf\fR command for a more detailed description.

.TP

\fB\-\-mimelist\-file\fR=\fI\,FILE\/\fR

.TP

\fB\-\-mnt\-udisks2\fR

use \fIudisks2\fR instead of \fIudevil\fR (default), for the \fImedia\fR command

list directories only

.TP

\fB\-\-open\fR=\fI\,FILE\/\fR

.TP

\fB\-\-opener\fR=\fI\,APPLICATION\/\fR

use APPLICATION (e.g.: \fIrifle\fR or \fIxdg\-open\fR) as files opener/launcher (instead of \fILira\fR, \fBclifm\fR's default opener).

List only up to NUM files (valid range: >= 0). Use \fIunset\fR to list all files (default). An indicator (listed_files/total_files) will be printed below the list of files whenever some file is excluded from the current list (e.g. 20/310). Note however that though some files are excluded, all of them are loaded anyway, so that you can still perform any valid operation on them. For example, even if only 10 files are listed, you can still search for ALL symbolic links in the corresponding directory using the appropriate command: \fI/*\ \-l\fR.

.TP

.B mm, mime \fR[\fIopen FILE\fR] [\fIinfo FILE\fR] [\fIedit\fR [\fIAPP\fR]] [\fIimport\fR]

.sp

Use the \fIopen\fR subcommand to open a file with the default associated application. Note that, since \fIopen\fR is the default action, it can be omitted. For example: \fImm file.pdf\fR. The same can be achieved more easily via the \fIopen\fI command: \fIopen file.pdf\fR (or using the short command, \fIo file.pdf\fR). Or, even shorter, just \fIfile.pdf\fR.

.sp

The \fIinfo\fR option prints MIME information about FILE: its MIME type, and, if any, the application associated to this filename or to the file's MIME type.

.sp

.sp

Finally, via the \fIimport\fR option \fBclifm\fR will try to import MIME associations from the system looking for \fImimeapps.list\fR files in those paths specified by the Freedesktop specification (see \fIhttps://specifications.freedesktop.org/mime\-apps\-spec/mime\-apps\-spec\-latest.html\fR). If at least one MIME association is successfuly imported, it will be stored as \fImimelist.clifm.XXXXXX\fR (where XXXXXX is a random six digits alphanumerical string). You can add these new associations to your mimelist file using the \fImime edit\fR command.

.TP

.sp

Without arguments (or via the \fIlist\fR subcommand), \fInet\fR lists the configuration for each remote available in the configuration file.

.sp

.sp

If not already mounted, the \fIm\fR, \fImount\fR option mounts the specified remote using the mount command and the mounpoint specified in the confifuration file and automatically cd into the corresponding mountpoint. Example: \fInet m smb_work\fR. Since \fImount\fR is the default action, it can be omitted: \fInet smb_work\fR.

.sp

.B o, open \fIELN/FILE\fR [\fIAPPLICATION\fR]

open FILE, which can be either a directory, in which case it works just like the \fIcd\fR command (see above), a regular file, or a symbolic link to either of the two. For example: \fIo\ 12\fR, \fIo\ filename\fR, \fIo\ /path/to/filename\fR.

.sp

.sp

If you want to run the program in the background, simply add the ampersand character, as usual: \fIo\ 12\ &\fR, \fIo\ 12&\fR, \fIo12&\fR or (if auto\-open is enabled) just \fI12&\fR.

.sp

Use the \fIpc\fR command to edit files permissions.

.TP

.B opener \fR[\fIdefault\fR] [\fIAPPLICATION\fR]

.TP

.B ow \fIELN/FILE\fR [\fIAPPLICATION\fR]

If APPLICATION is specified, open ELN/FILE with APPLICATION. In case you need to add parameters to APPLICATION, it is recommended to quote the expression: \fIow FILE "APP ARG..."\fR.

.TP

In addition to completions and expansions, an \fIauto\-suggestions system\fR is also available. See the \fBAUTO\-SUGGESTIONS\fR section below.

.TP

\fILira\fR is controlled via the \fImime\fR command. File associations are stored in the MIME list file.

.TP

\fB.*=rifle\fR

.TP

.TP

\fBclifm \-\-open /path/to/my_file.jpg

clifm \-\-open /path/to/my_dir

.TP

\fB3. Customization

.TP

.TP

You can set an alternative configuration file via the \fI\-\-shotgun\-file\fR command line switch:

# shellcheck source=/dev/null

. "$CLIFM_PLUGINS_HELPER"

\'echo "/tmp" > "$CLIFM_BUS"\' tells \fBclifm\fR to change the current directory to \fI/tmp\fR

The number of terminal lines

.TP

.B CLIFM_MIMETYPES_FILE

.TP

Except when running in \fBstealth mode\fR, \fBclifm\fR sets the following environment variables:

.TP

###################################

# Configuration File for Lira #

###################################

#-----------------------------

# Description

#-----------------------------

# This configuration file allows the user to define how different files are

# Commented and blank lines are ignored.

# Lines starting with either '#' or ';' are comments.