clifmrc

		###########################################
		#                  CLIFM                  #
		#      The Command-Line File Manager      #
		###########################################

# This is Clifm's main configuration file.

# Lines starting with either '#' or ';' are commented out (ignored).
# Options starting with ';' show default values and are commented out.
# To override a default, uncomment the corresponding option (remove
# the leading ';') and set it to a supported value.


#=====================================#
#          1. INTERFACE               #
#=====================================#

# Show hidden files (i.e., files starting with a dot).
# Supported values: true, false, first, last.
# If 'true', hidden files are sorted according to the value of the Sort
# option (see below).
;ShowHiddenFiles=false

# Files listed in a '.hidden' file in the current directory are hidden when
# hidden files are not shown (i.e., when ShowHiddenFiles is set to false).
# Both plain filenames and wildcards are supported for specifying hidden files.
;ReadDotHidden=false

# Specify how to group directories. Supported values:
# first = Group directories before files
# last  = Group directories after files
# false = Do not group directories
;GroupDirs=first

# Regular expression to filter files from the file list.
# For example: "!.*~$" to exclude backup files (ending with ~), or "^\." to
# list only hidden files. File type filters are also supported, such as
# "=d" to list directories only, or "!=l" to exclude symbolic links.
# Run 'help file-filters' for more information.
;Filter=""

# Display the number of files inside each directory next to the directory
# name. This feature may slow down performance when, for example, listing
# files on a remote server: the file counter can be disabled here, via
# the --no-file-counter option, or using the 'fc' command while in the
# program itself.
# Note: This option requires Classify (see below) to be set to true.
;FileCounter=true

# When colors are enabled, append directory indicator to directories. When
# colors are disabled (via the --no-color option), append file type
# indicator to filenames instead:
# '/' for directories
# '@' for symbolic links
# '=' for sockets
# '|' for FIFO/pipes
# '*' for for executable files
# '+' for block special files
# '-' for character special files
# '?' for unknown file types
# Bear in mind that when running in light mode the check for executable
# files is not performed, and thereby no indicator is added to executable
# files.
# Note: Disabling this option also disables the file counter.
;Classify=true

# Dereference symbolic links when listing files
;FollowSymlinks=true

# Colorize symbolic links according to their target. A link indicator
# (by default '@') is prefixed to the file name.
# The color of this indicator can be customized in the color scheme file
# (InterfaceColors field) using the 'lc' code.
;ColorizeSymlinksAsTarget=false

# Control the use of the file list pager. Supported values are:
# 0/false = Disable the pager.
# 1/true  = Run the pager when the file list does not fit on the screen.
# >1      = Run the pager when the number of files in the current directory
#           is greater than or equal to this value (e.g., 1000).
;Pager=false

# Pager listing mode. Supported values:
# auto  = Use the current listing mode
# long  = List files in long view
# short = List files in short view
;PagerView=auto

# File listing layout: 0 = vertical (like ls), 1 = horizontal.
;ListingMode=0

# Sort methods: none, name, version, extension, type, blocks, size
# links, atime, btime, ctime, mtime, inode, owner, and group.
;Sort=version

# Invert sort order. You can also use the --sort-reverse option
# or the 'st rev' command.
;SortReverse=false

# Sort filenames starting with the specified characters first.
# Multiple values are allowed (e.g., 'PrioritySortChar=._#')
# Leave empty to unset this option (no priority character).
# Supported values are ASCII characters from SPACE to TILDE.
# Tip: A common value for this option is underscore (_).
# Note: This option takes precedence over SkipNonAlnumPrefix (see below).
;PrioritySortChar=

# Display extended file metadata next to filenames (long listing format).
;LongViewMode=false

# Specify which properties to display for each filename in long view mode:
# f       = File counter (for directories)
# B       = File allocated blocks
# d       = Inode number
# l       = Number of hard links
# p|n     = Permissions: either symbolic (p) or numeric/octal (n)
# i|I     = User/group IDs: either as number (i) or name (I)
# G       = If i|I is set, don't print groups
# a|b|m|c = Last (a)ccess, (b)irth, (m)odification, or status (c)hange time
# s|S     = Size (either human readable (s) or bytes (S))
# x       = Extended attributes/capabilities/ACLs (marked as '@')
#           (requires p|n)
#
# A single dash ("-") disables all fields.
#
# Note that, exception made of 'x' and 'G', fields are displayed in the
# order specified here.
#
# Example: display only permissions (numeric) and size (human readable):
#PropFields="ns"
# or, to display file permissions, modification time, and size (in bytes):
#PropFields="pmS"
;PropFields="xfpIsm"

# Number of spaces between fields in long view. Possible values: 1 or 2.
;PropFieldsGap=1

# Style for printing timestamps in long view mode.
# Supported values: default, relative, iso, long-iso, full-iso, +FORMAT
# FORMAT is interpreted like in strftime(3).
# Defaults to "+%b %e %H:%M" for recent files (< 6 months) and "+%b %e  %Y"
# for older files.
# Examples:
;TimeStyle=full-iso
;TimeStyle=relative
;TimeStyle="+%F %T"

# If sorting by time in the file list, use the same timestamp in long view
# mode, regardless of the value set in PropFields.
;TimeFollowsSort=true

# Append an indicator ('a', 'b', 'c', or 'm') to the timestamp in long view
# mode to indicate the type of timestamp: access, birth, status change, or
# modification time, respectively. When using relative times, uppercase
# characters are used for improved visibility.
;TimestampMark=false

# Similar to TimeStyle, but specific to the 'p/pp' command.
# Supported values: default, iso, long-iso, full-iso, full-iso-nano, +FORMAT
# Nano-second precision is available using the %N modifier.
;PTimeStyle="+%Y-%m-%d %H:%M:%S.%N %z"

# Display recursive directory sizes (long view only).
;TotalSize=false

# Display apparent file sizes (logical size) instead of actual device
# usage (physical size).
;ApparentSize=true

# The light mode disables extra file-type checks to improve speed (no
# readability/executability/SUID/SGID/broken-symlink checks). The
# color-per-extension check is also disabled.
;LightMode=false

# Clear the terminal screen before listing files.
# Supported values: true, false, internal (restrict this behavior to
# internal commands only: shell commands will not clear the screen).
# Note: If set to 'internal', the current list of files will not be refreshed
# even if an external command creates, removes, or renames a file in the
# current directory.
;ClearScreen=true

# Maximum filename length for displayed files. If TruncateNames is enabled,
# names longer than MaxFilenameLen are truncated with a tilde (~).
# Set to -1, 'unset' (or leave empty) to disable the limit.
# Set to a percentage (e.g., 20%) to use that fraction of terminal columns.
# Note: if the computed value is below MinNameTruncate, MinNameTruncate is
# used instead.
;MaxFilenameLen=25%

# Truncate filenames longer than MaxFilenameLen.
;TruncateNames=true

# Minimum length at which a filename can be truncated.
;MinNameTruncate=20

# A comma separated list of workspace names in the format NUM=NAME.
# Example: "1=MAIN,2=EXTRA,3=GIT" or "1=α,2=β,3=γ"
;WorkspaceNames=""

# If set to true, settings changed in the current workspace (only via
# the command line or keyboard shortcuts) are kept private to that
# workspace and made persistent (for the current session only), even
# when switching workspaces.
;PrivateWorkspaceSettings=false

# Show disk usage of the filesystem where the current directory resides,
# in the format "FREE % (FREE/TOTAL) TYPE DEVICE".
;DiskUsage=false

# Print a map of the current position in the directory history list,
# showing previous, current, and next entries.
;DirhistMap=false

# Print the list of selected files after the file list. Since this
# list can become extensive, you can limit the number of printed
# entries using the MaxPrintSelfiles option below.
;PrintSelfiles=false

# Maximum number of selected files to be printed if PrinSelFiles is
# enabled. Supported values: -1 = no limit, 0 = auto (never print more
# than half terminal height), or any positive value.
;MaxPrintSelfiles=0

# Color schemes (or just themes) are stored in the colors directory
# ($XDG_DATA_DIRS/clifm/colors, usually /usr/local/share/clifm/colors
# or /usr/share/clifm/colors). You can place your custom themes in
# $HOME/.config/clifm/colors.
#
# Use the 'cs' command or the '--color-scheme' command-line option to set
# a theme.
#
# Run 'cs edit' to modify the current theme.
#
# Each theme includes color definitions, just as definitions for the
# prompt, the warning prompt, the dividing line, and the FZF window.
#
# Use TAB to list available themes: 'cs <TAB>'.
#
# For additional themes, visit https://github.com/leo-arch/clifm-colors.
#
# Defaults to 'default-256', or 'default' (16 colors) if 256-color support
# is not detected.
;ColorScheme=

# Enable the use of icons in the file list.
# By default, Nerdfonts are used as icon set, but emojis and icons-in-terminal
# are supported as well (requires recompilation). Consult our Wiki
# (https://github.com/leo-arch/clifm/wiki) for more information.
;Icons=false

# Number of spaces between icons and filenames (supported values: 0, 1, or 2).
;IconsGap=1


#=====================================#
#         2. COMMAND LINE             #
#=====================================#

# Quoting style used to expand ELNs (regular files only).
# Supported values: 'backslash' (default), 'single', or 'double' quotes.
# This option is particularly useful for shells that do not support
# backslashes as quoting mechanism, such as nushell or xonsh.
;QuotingStyle=backslash

# Enable fuzzy matching for filename/path completion and suggestions.
;FuzzyMatching=false

# Choose the fuzzy matching algorithm to use. Supported values:
# 1 = faster, but not Unicode aware
# 2 = slower, but Unicode aware (note that this algorithm will nonetheless
# fall back to the first one whenever the query string does not contain
# Unicode characters, minimizing thus the performance impact).
;FuzzyAlgorithm=2

# Set the tab completion mode. Supported values: standard, fzf, fnf, smenu.
# Defaults to 'fzf', 'fnf', or 'smenu' (in this order), if the corresponding
# binary is found in PATH. Othwerwise, the standard mode is used.
;TabCompletionMode=

# Enable file previews for tab completion (fzf mode only). Supported values:
# true, false, hidden (enabled, but hidden; toggle with Alt-p).
;FzfPreview=true

# Do not preview files exceeding the specified size.
# Supported size units: K, M, G, T (e.g., 100M).
# Supported size range: 1K-2047G.
# Set to -1 (or leave empty) to disable this feature (allow all file sizes).
;PreviewMaxSize=

# Enable auto-suggestions for commands, file paths, and options as you type.
;AutoSuggestions=true

# The following suggestion checks are performed in the order specified
# by SuggestionStrategy. Available checks include:
# a = Alias names
# c = Path completion
# e = ELNs
# f = Filenames in current directory
# h = Command history
# j = Jump database
# Use a single dash (-) to skip all of these checks.
;SuggestionStrategy=ehfjac

# Suggest filenames using the corresponding file type color (as defined in
# the color scheme file).
;SuggestFiletypeColor=false

# Provide a brief description for internal commands as part of the suggestions.
;SuggestCmdDesc=true

# Enable syntax highlighting for improved readability of commands as you type.
;SyntaxHighlighting=true

# Allow the execution of external shell commands within Clifm.
;ExternalCommands=true


#=====================================#
#           3. COMMANDS               #
#=====================================#

# Automatically list files after changing the current directory.
;AutoLs=true

# If enabled, a command name that is the name of a directory or a
# file, is executed as if it were the argument to the 'cd' or the
# 'open' commands respectively: 'DIR' is equivalent 'cd DIR' and
# 'FILE' to 'open FILE'.
;Autocd=true
;AutoOpen=true

# Execute autocommand files (.cfm.in and .cfm.out) found in the current
# directory. For more information consult the manpage.
;ReadAutocmdFiles=false

# Inform about autocommand options set for the current directory.
# Supported values:
# none   = No message is displayed.
# mini   = Minimal message with no option details.
# short  = List of autocommand options without their values.
# long   = Like 'short', but includes the value of each option (multiple
#          matching autocommands are merged into a single line).
# full   = Like 'long', but multiple autocommands are printed on separate
#          lines. Also, a 'T' is appended to mark temporary autocommands
#          (i.e., set via the 'auto' command).
# prompt = Display a small notification (a gray 'A') in the prompt.
#          The color code used for this notification is 'ac' (see the color
#          scheme file).
#          If Notifications is set to false for the current prompt (see the
#          prompts file), nothing is printed (you can use the '\y' prompt
#          code in the prompts file to manually set this notification).
;InformAutocmd=prompt

# Run in read-only mode (internal commands able to modify the filesystem
# are disabled). Consult the manpage for the list of affected commands.
;Readonly=false

# Make the 'r' command move files to the trash instead of permanently
# removing them.
;TrashAsRm=false

# If set to true, do not ask for confirmation before moving files to the trash.
;TrashForce=false

# If set to true, do not ask for confirmation before removing files with the
# 'r' command.
# Note: If set to false, you can still use the '-f' parameter to turn
# confirmation off for a single command. E.g., 'r -f FILE'.
;rmForce=false

# Maximum number of filenames shown in confirmation prompts (e.g., when
# removing or trashing files). Supported values:
# none = Show no file list, only prompt for confirmation
# all  = List all filenames
# auto = The limit is set to half the terminal height (in lines)
# >0   = List at most this number of filenames
;MaxConfirmFiles=auto

# Warn about unsafe filenames when creating/renaming files ('n' and 'm'
# commands respectively). Supported values:
# false =  No check is performed
# basic =  Only basic checks are performed
# strict = Basic + disallow shell metacharacters
# posix  = Basic + allow only characters in the Portable Character Set
# Consult the manpage for details.
;SafeFilenames=basic

# Set the default command used for copying files. Supported values:
# 0 = 'cp -Rp'
# 1 = 'cp -Rp' (force: do not prompt before overwrite)
# 2 = 'advcp -gRp'
# 3 = 'advcp -gRp' (force)
# 4 = 'wcp'
# 5 = 'rsync -avP'
# Note: Options 2-5 include a progress bar.
;cpCmd=0

# Set the default command used for moving files. Supported values:
# 0 = 'mv'
# 1 = 'mv' (force: do not prompt before overwrite)
# 2 = 'advmv -g'
# 3 = 'advmv -g' (force)
# Note: Options 2 and 3 include a progress bar.
;mvCmd=0

# Define default responses for confirmation prompts using a comma-separated
# line of fields. Each field consists of two values separated by a colon (':').
#
# The left value specifies a confirmation prompt:
#  o = overwrite files (mostly 'c' and 'm' commands)
#  r = remove ('r' command)
#  t = trash ('t' command)
#  R = bulk rename ('br' command)
#  d = All confirmation prompts (excluding, if defined, the above ones)
#  D = All confirmation prompts (including the above ones, no matter their value)
#
# The right value holds the default answer for the corresponding prompt:
#  'y', 'n', or 'u' (unset - no default answer, wait for explicit input).
# The overwrite prompt ('o') accepts the following values:
#  'y': yes (overwrite the current file)                                                                                  
#  'n': no (do not overwrite the current file) [1]
#  'a': all (overwrite all existing files)
#  'o': none (do not overwrite any file) [1]
#  's': skip (skip the current file)
#  'k': skip all (skip all existing files)
#  'q': quit
# [1] Source  files  are copied/moved to unique destination names created by
# appending a dash (-) and a numeric suffix: e.g., a file named 'foo' is
# copied/moved to 'foo-1', or 'foo-2' if 'foo-1' already exists.
#
# If a value, left or right, is unset (or set to any other value), no default
# answer is used ('y' or 'n' is explicitly required, unless 'd' or 'D'
# are set to any valid value, in which case this value is used instead).
#
# For example, to set 'n' as the default answer for the 'r' command, unset for
# trash, and 'y' for everything else: "r:n,t:u,d:y".
;DefaultAnswer="o:o,r:n,t:y,R:n,d:y"

# Specify how the 'l' command creates symbolic links. Supported values:
# absolute = Make the target an absolute path
# relative = Make the target relative to the link location (like 'ln -rs')
# literal  = Do not resolve the target at all (like 'ln -s')
;LinkCreationMode=relative

# Choose the file opener for opening files with their default associated
# application (e.g., Ranger's rifle or xdg-open). If not specified, 'lira',
# Clifm's builtin opener, is used.
;Opener=

# Command used to launch a terminal emulator for opening a new Clifm instance
# (with the 'x' command).
;TerminalCmd="xterm -e"

# Set the file mode creation mask. Defaults to the value inherited from
# the shell (though 077 is recommended).
# This option is ignored in secure mode (umask is forcefully set to 077).
;Umask=077

# Choose the search strategy for the quick search function. Supported values:
# 0 = glob-only
# 1 = regex-only
# 2 = glob-regex (default)
;SearchStrategy=2

# Minimum rank for directories in the jump database. Directories with a rank
# below this value are removed. If set to 0, directories are retained
# indefinitely.
;MinJumpRank=10

# Maximum total rank allowed in the jump database. When exceeded, all ranks
# are reduced dynamically to ensure the total falls below this limit.
# Entries below MinJumpRank are deleted.
;MaxJumpTotalRank=100000

# Automatically remove non-existing directories from the jump database at
# startup. Note that this will also remove paths pointing to unmounted
# removable devices and remote filesystems.
;PurgeJumpDB=false

# Print the list of commands executed in the current directory (the list will
# be cleared after changing the directory).
;PrintDirCmds=false


#=====================================#
#        4. LOGS AND HISTORY          #
#=====================================#

# Display user alerts (errors, warnings, and notices) using desktop notifications.
# Supported values:
# kitty  = Use the Kitty Notifications Protocol (requires the Kitty terminal or a
#          terminal supporting this protocol).
# system = Use the system notifications daemon.
# false  = Print alerts before the prompt (no desktop notification is displayed).
;DesktopNotifications=false

# Log errors and warnings.
;LogMsgs=false
# Log commands entered in the command line.
;LogCmds=false
# Keep only the last MaxLog lines in the log files.
;MaxLog=1000

# A regular expression to filter out specific command lines from being added to
# the history list. Set this line to the empty string to disable history filters.
;HistIgnore="^[q,Q]$|^quit$|^exit$|^ .*|^#.*|^[0-9]+$|^\.+$"

# Limit the size of the command history file to MaxHistory entries.
;MaxHistory=1000

# Same as HistIgnore, but for the directory history list.
;DirhistIgnore=""

# Limit the size of the directory history file to MaxDirhist entries.
;MaxDirhist=100


#=====================================#
#             5. MISC                 #
#=====================================#

# Ignore case distinctions in filenames and paths.
;IgnoreCase=true

# Use the faster built-in magic check; fall back to libmagic if no result
# is found.
;FastMagic=true

# When sorting files by 'version' or 'name', skip non-alphanumeric characters.
# For example, '__file' is sorted as 'file'.
# This also affects hidden files: if set to false, '.hidden' will appear
# before 'afile'; if set to true, it will appear after 'gfile' (unless
# ShowHiddenFiles is set to 'first' or 'last').
;SkipNonAlnumPrefix=true

# Set a custom starting path. If not specified, it defaults to the current
# working directory. If set, this option overrides RestoreLastPath.
;StartingPath=

# Start Clifm in the last visited directory (and in the last used
# workspace). This option is overriden by StartingPath (if set).
;RestoreLastPath=true

# Set the readline editing mode: 0 for vi and 1 for emacs (default).
;RlEditMode=1

# Set the terminal window title.
# Supported values:
# auto =  Set only if the terminal supports it.
# true =  Always (regarless of terminal support).
# false = Never.
;TermTitle=auto

# Save the last visited directory to $XDG_CONFIG_HOME/clifm/.last, allowing
# it to be accessed by the corresponding shell function upon program exit.
# To enable this feature consult the manpage.
;CdOnQuit=false

# Share the Selection Box among different profiles.
;ShareSelbox=false

# Print a usage tip at startup.
;Tips=true

# Just a kind welcome message at startup.
;WelcomeMessage=true

# Set a custom welcome message.
# Use escape codes to add colors: e.g., "\e[34mWelcome!\e[0m".
# An ending new line character is appended automatically.
;WelcomeMessageStr=""

# Print Clifm's logo screen at startup.
;SplashScreen=false


#=====================================#
#            6. ALIASES               #
#=====================================#

# Bind '?' to the interactive help plugin. Use the 'actions' command to
# display a list of available plugins.
#alias ?='ih'
# Bind 'b' to the directory history navigation plugin.
#alias b='dh'
# Replace the builtin deselect command (ds) with the fzfdesel plugin.
#alias ds='**'
# You can use this alias to quickly change to the current virtual directory.
#alias vtd='cd $CLIFM_VIRTUAL_DIR'
# Replace the builtin bulk rename function (br) with vidir(1).
#br='vidir'


#=====================================#
#         7. PROMPT COMMANDS          #
#=====================================#

# Specify commands to be executed before each prompt is displayed. For example:
#promptcmd /usr/local/share/clifm/plugins/git_status.sh
#promptcmd date | awk '{print $1", "$2,$3", "$4}'


#=====================================#
#         8. AUTOCOMMANDS             #
#=====================================#

# Control Clifm's settings on a per-directory basis. For more information
# consult the manpage.

# Remote file systems are slow: let's speed this up by enabling the light
# mode and disabling the file counter.
#autocmd /media/remotes/** lm=1,fc=0

# Just a friendly reminder when entering the ~/important directory.
#autocmd ~/important !printf "Keep your fingers outta here!\n" && read -n1

# Plenty of images and videos? Launch the files previewer plugin.
#autocmd ~/Downloads !/usr/local/share/clifm/plugins/fzfnav.sh

# Use the nord color scheme and disable hidden files in the ~/Documents
# directory.
#autocmd ~/Documents/** cs=nord,hf=0

# I want files in the third workspace to be listed in long view.
#autocmd @ws3 lv=1