2021-10-22 21:53:29 +02:00
Usage: fastfetch <options>
Informative options:
2022-04-02 14:35:43 +02:00
-h,--help: shows this message and exits
-h,--help <command>: shows help for a specific command and exits
-v,--version: prints the version of fastfetch and exits
--list-logos: list available logos and exits
--list-modules: lists available modules and exits
--list-presets: list presets fastfetch knows about and exits. They can be loaded with --load-config. (+)
--list-features: list the supported features fastfetch was compiled with and exits. Mainly for development.
--print-logos: show available logos and exits
--print-config: prints the default config and exits
--print-structure: prints the default stucture and exits
2021-10-22 21:53:29 +02:00
General options:
2022-04-02 14:35:43 +02:00
-r,--recache <?value>: generate new cached values
--nocache <?value>: don't use cached values, but also don't overwrite existing ones
--load-config <file>: load a config file or a preset (+)
--multithreading <?value>: use multiple threads to detect values
--allow-slow-operations <?value>: allow operations that are usually very slow for more detailed output
2022-06-02 23:06:49 +02:00
--escape-bedrock <?value>: on bedrock linux, sets if it should escape the bedrock jail or not
2022-06-06 14:02:21 +02:00
--pipe <?value>: disable logo and all escape sequences
2021-10-22 21:53:29 +02:00
Logo options:
2022-04-02 14:35:43 +02:00
-l,--logo <logo>: set the logo to use. The type is specified by --logo-type. If default: the name of a builtin logo or a path to a file
2022-04-28 19:15:46 +02:00
--logo-type <type>: set the type of the logo given. Must be auto, builtin, file, raw, sixel, kitty or chafa.
2022-04-06 14:02:05 +02:00
--logo-width <width>: set the width of the logo (in characters), if it is an image
2022-04-30 11:25:22 +02:00
--logo-height <height>: set the height of the logo (in characters), if it is an image
2022-04-02 14:35:43 +02:00
--logo-color-[1-9] <color>: overwrite a color in the logo
--logo-padding <padding>: set the padding on the left and the right of the logo
--logo-padding-left <padding>: set the padding on the left of the logo
--logo-padding-right <padding>: set the padding on the right of the logo
--logo-print-remaining <?value>: weather to print the remaining logo, if it has more lines than modules to display
2022-04-06 14:54:39 +02:00
--sixel <file>: short for --logo-type sixel --logo <file>
2022-04-13 23:04:42 +02:00
--kitty <file>: short for --logo-type kitty --logo <file>
2022-04-28 19:15:46 +02:00
--chafa <file>: short for --logo-type chafa --logo <file>
2022-04-22 15:49:50 +02:00
--file <file>: short for --logo-type file --logo <file>
--raw <file>: short for --logo-type raw --logo <file>
2022-04-02 14:35:43 +02:00
Display options:
-s,--structure <structure>: sets the structure of the fetch. Must be a colon separated list of keys. Use "fastfetch --list-modules" to see the ones available.
-c,--color <color>: sets the color of the keys. Must be a linux console color code or the name of a color (+)
--separator <str>: sets the separator between key and value. Default is a colon with a space
--set <key=value>: hard set the value of a key
--show-errors <?value>: print occuring errors
--disable-linewrap <?value>: weather to disable linewrap during the run
--hide-cursor <?value>: weather to hide the cursor during the run
2021-10-22 21:53:29 +02:00
Format options: Provide the format string for custom output. Use fastfetch --help *-format for specific help.
2021-11-18 18:25:24 +01:00
--os-format <format>
--host-format <format>
--kernel-format <format>
--uptime-format <format>
--processes-format <format>
--packages-format <format>
--shell-format <format>
--resolution-format <format>
--de-format <format>
--wm-format <format>
--wm-theme-format <format>
--theme-format <format>
--icons-format <format>
--font-format <format>
--cursor-format <format>
--terminal-format <format>
--terminal-font-format <format>
--cpu-format <format>
2021-11-24 16:16:25 +08:00
--cpu-usage-format <format>
2021-11-18 18:25:24 +01:00
--gpu-format <format>
--memory-format <format>
--disk-format <format>
--battery-format <format>
--locale-format <format>
--local-ip-format <format>
2022-01-10 20:20:18 +01:00
--public-ip-format <format>
2022-02-13 23:51:13 +01:00
--player-format <format>
--song-format <format>
2022-02-25 13:30:37 +01:00
--datetime-format <format>
--time-format <format>
--date-format <format>
2022-06-01 00:04:58 +02:00
--vulkan-format <format>
2022-06-04 15:21:34 +02:00
--opengl-format <format>
2022-06-05 00:18:40 +02:00
--opencl-format <format>
2021-10-22 21:53:29 +02:00
Key options: Provide a custom key for an output
2021-11-18 18:25:24 +01:00
--os-key <key>
--host-key <key>
--kernel-key <key>
--uptime-key <key>
--processes-key <key>
--packages-key <key>
--shell-key <key>
--resolution-key <key>: takes the resolution index as argument
--de-key <key>
--wm-key <key>
--wm-theme-key <key>
--theme-key <key>
--icons-key <key>
--font-key <key>
--cursor-key <key>
--terminal-key <key>
--terminal-font-key <key>
--cpu-key <key>
2021-11-24 16:16:25 +08:00
--cpu-usage-key <key>
2021-11-18 18:25:24 +01:00
--gpu-key <key>: takes the gpu index as format argument
--memory-key <key>
--disk-key <key>: takes the mount path as format argument
--battery-key <key>: takes the battery index as format argument
--locale-key <key>
--local-ip-key <key>: takes the name of this network interface as format argument
2022-01-10 20:20:18 +01:00
--public-ip-key <key>
2022-02-13 23:51:13 +01:00
--player-key <key>
--song-key <key>
2022-02-25 13:30:37 +01:00
--datetime-key <key>
--time-key <key>
--date-key <key>
2022-06-01 00:04:58 +02:00
--vulkan-key <key>
2022-06-04 15:21:34 +02:00
--opengl-key <key>
2022-06-05 00:18:40 +02:00
--opencl-key <key>
2021-10-22 21:53:29 +02:00
2021-10-31 12:12:51 +01:00
Library options: Set the path of a library to load
2021-11-18 18:25:24 +01:00
--lib-PCI <path>
--lib-vulkan <path>
2022-01-05 14:40:57 +01:00
--lib-wayland <path>
--lib-xcb-randr <path>
--lib-xcb <path>
2021-11-18 18:25:24 +01:00
--lib-Xrandr <path>
2022-01-05 14:40:57 +01:00
--lib-X11 <path>
2021-11-18 18:25:24 +01:00
--lib-gio <path>
--lib-DConf <path>
2022-02-13 23:51:13 +01:00
--lib-DBus <path>
2021-11-18 18:25:24 +01:00
--lib-XFConf <path>
2022-05-23 19:30:02 +02:00
--lib-sqlite3 <path>
2022-05-24 13:36:33 +02:00
--lib-rpm <path>
2022-04-14 15:11:14 +02:00
--lib-imagemagick <path>
--lib-z <path>
2022-04-28 19:15:46 +02:00
--lib-chafa <path>
2022-06-04 15:21:34 +02:00
--lib-egl <path>
--lib-glx <path>
2022-06-04 19:30:26 +02:00
--lib-osmesa <path>
2022-06-05 00:18:40 +02:00
--lib-opencl <path>
2021-10-22 21:53:29 +02:00
Module specific options:
2021-11-18 18:25:24 +01:00
--separator-string <str>: Set the string printed by the separator module
2022-01-18 18:56:37 +01:00
--os-file <path>: Set the path to the file containing OS informations
2021-11-18 18:25:24 +01:00
--disk-folders <folders>: A colon separated list of folder paths for the disk output. Default is "/:/home"
--battery-dir <folder>: The directory where the battery folders are. Standard: /sys/class/power_supply/
--localip-show-ipv4 <?value>: Show ipv4 addresses in local ip module. Default is true
--localip-show-ipv6 <?value>: Show ipv6 addresses in local ip module. Default is false
--localip-show-loop <?value>: Show loop back addresses (127.0.0.1) in local ip module. Default is false
2022-01-12 19:16:49 +01:00
--public-ip-timeout: Time in milliseconds to wait for the public ip server to respond. Default is disabled (0)
2022-02-13 23:51:13 +01:00
--player-name: The name of the player to use
2022-06-04 15:21:34 +02:00
--gl <value>: Sets the opengl context creation library to use. Must be auto, egl, or glx. Default is auto
2021-10-22 21:53:29 +02:00
Parsing is not case sensitive. E.g. "--lib-PCI" is equal to "--Lib-Pci"
If a value starts with a ?, it is optional. "true" will be used if not set.
A (+) at the end indicates that more help can be printed with --help <option>
All options can be made permanent in $XDG_CONFIG_HOME/fastfetch/config.conf