"desc":"Show this message, or help for a specific command",
"arg":{
"type":"command",
"optional":true
}
},
{
"short":"v",
"long":"version",
"desc":"Show the full version of fastfetch"
},
{
"long":"version-raw",
"desc":"Show the raw version string (major.minor.patch)"
},
{
"long":"list-config-paths",
"desc":"List search paths of config files"
},
{
"long":"list-data-paths",
"desc":"List search paths of presets and logos"
},
{
"long":"list-logos",
"desc":"List available logos"
},
{
"long":"list-modules",
"desc":"List available modules"
},
{
"long":"list-presets",
"desc":"List presets fastfetch knows about",
"remark":"Presets can be loaded with \"--config <preset-name>\""
},
{
"long":"list-features",
"desc":"List the supported features fastfetch was compiled with",
"remark":"Mainly for development"
},
{
"long":"print-logos",
"desc":"Print available logos"
},
{
"long":"print-structure",
"desc":"Print the default structure"
}
],
"Config":[
{
"short":"c",
"long":"config",
"desc":"Specify the config file or preset to be loaded",
"remark":"The file will be searched in the order of \"fastfetch --list-config-paths\". If \"none\", disable further config loading. Refer to https://github.com/fastfetch-cli/fastfetch/wiki/Configuration for more info",
"arg":{
"type":"config"
}
},
{
"long":"gen-config",
"desc":"Generate a config file to specified path with options specified in the command line (if any)",
"remark":"Defaults to \"~/.config/fastfetch/config.jsonc\". Will Print the generated config if <path> is \"-\"",
"arg":{
"type":"path",
"optional":true
}
},
{
"long":"gen-config-force",
"desc":"Generate a config file to specified path. Overwrite the existing one",
"remark":"Defaults to \"~/.config/fastfetch/config.jsonc\"",
"arg":{
"type":"path",
"optional":true
}
}
],
"pseudo":[
{
"long":"thread",
"desc":"Use separate threads to send HTTP requests",
"arg":{
"type":"bool",
"optional":true,
"default":true
}
},
{
"long":"escape-bedrock",
"desc":"On Bedrock Linux, whether to escape the bedrock jail",
"remark":"Linux only",
"arg":{
"type":"bool",
"optional":true,
"default":true
}
},
{
"long":"wmi-timeout",
"desc":"Set the timeout (ms) for WMI queries",
"remark":"Windows only",
"arg":{
"type":"num",
"default":5000
}
},
{
"long":"processing-timeout",
"desc":"Set the timeout (ms) when waiting for child processes",
"arg":{
"type":"num",
"default":1000
}
},
{
"long":"ds-force-drm",
"desc":"Set if only DRM should be used to detect displays",
"remark":"Use this option if you encountered problems with other detection method. Linux only",
"arg":{
"type":"bool",
"optional":true,
"default":false
}
}
],
"Logo":[
{
"short":"l",
"long":"logo",
"desc":"Set the logo source",
"remark":"Should be the name of a builtin logo, or a path to an image file",
"arg":{
"type":"logo"
}
},
{
"long":"logo-type",
"desc":"Set the type of the logo given in \"--logo\"",
"arg":{
"type":"enum",
"enum":{
"auto":"If something is given, first try builtin, then file. Otherwise detect logo",
"builtin":"Builtin ascii art",
"small":"Builtin ascii art, small version",
"file":"Text file, printed with color code replacement",
"file-raw":"Text file, printed as is",
"data":"Text data, printed with color code replacement",
"data-raw":"Text data, printed as is",
"sixel":"Image file, printed as sixel codes",
"kitty":"Image file, printed as kitty graphics protocol",
"kitty_direct":"Image file, tell the terminal emulator to read image data from the specified file (Supported by kitty and wezterm)",
"iterm":"Image file, printed as iterm graphics protocol",
"chafa":"Image file, printed as ascii art using libchafa",
"raw":"Image file, printed as raw binary string",
"none":"Disable logo printing"
}
}
},
{
"long":"logo-width",
"desc":"Set the width of the logo (in characters), if it is an image",
"remark":"Required for iTerm image protocol",
"arg":{
"type":"num"
}
},
{
"long":"logo-height",
"desc":"Set the height of the logo (in characters), if it is an image",
"remark":"Required for iTerm image protocol",
"arg":{
"type":"num"
}
},
{
"long":"logo-preserve-aspect-ratio",
"desc":"Set if the logo should fill the specified width and height as much as possible without stretching",
"remark":"Supported by iTerm image protocol only",
"arg":{
"type":"bool",
"optional":true,
"default":false
}
},
{
"long":"logo-color-<1-9>",
"desc":"Overwrite a color in the logo",
"arg":{
"type":"color"
}
},
{
"long":"logo-padding",
"desc":"Set the padding on the left and the right of the logo",
"arg":{
"type":"num"
}
},
{
"long":"logo-padding-left",
"desc":"Set the padding on the left of the logo",
"arg":{
"type":"num"
}
},
{
"long":"logo-padding-right",
"desc":"Set the padding on the right of the logo",
"arg":{
"type":"num"
}
},
{
"long":"logo-padding-top",
"desc":"Set the padding on the top of the logo",
"arg":{
"type":"num"
}
},
{
"long":"logo-print-remaining",
"desc":"Whether to print the remaining logo, if it has more lines than modules to display",
"arg":{
"type":"bool",
"optional":true,
"default":true
}
},
{
"long":"logo-separate",
"desc":"If true, print modules at bottom of the logo",
"arg":{
"type":"bool",
"optional":true,
"default":false
}
},
{
"long":"logo-recache",
"desc":"If true, regenerate image logo cache",
"arg":{
"type":"bool",
"optional":true,
"default":false
}
},
{
"long":"file",
"desc":"Short for --logo-type file --logo <path>",
"remark":"See \"--help logo-type\" for more info",
"arg":{
"type":"path"
}
},
{
"long":"file-raw",
"desc":"Short for --logo-type file-raw --logo <path>",
"remark":"See \"--help logo-type\" for more info",
"arg":{
"type":"path"
}
},
{
"long":"data",
"desc":"Short for --logo-type data --logo <data>",
"remark":"See \"--help logo-type\" for more info",
"arg":{
"type":"data"
}
},
{
"long":"data-raw",
"desc":"Short for --logo-type data-raw --logo <data>",
"remark":"See \"--help logo-type\" for more info",
"arg":{
"type":"data"
}
},
{
"long":"raw",
"desc":"Short for --logo-type raw --logo <path>",
"remark":"See \"--help logo-type\" for more info",
"arg":{
"type":"path"
}
},
{
"long":"sixel",
"desc":"Short for --logo-type sixel --logo <path>",
"remark":"See \"--help logo-type\" for more info",
"arg":{
"type":"path"
}
},
{
"long":"kitty",
"desc":"Short for --logo-type kitty --logo <path>",
"remark":"See \"--help logo-type\" for more info",
"arg":{
"type":"path"
}
},
{
"long":"kitty-direct",
"desc":"Short for --logo-type kitty-direct --logo <path>",
"remark":"See \"--help logo-type\" for more info",
"arg":{
"type":"path"
}
},
{
"long":"iterm",
"desc":"Short for --logo-type iterm --logo <path>",
"remark":"See \"--help logo-type\" for more info",
"arg":{
"type":"path"
}
},
{
"long":"chafa",
"desc":"Short for --logo-type chafa --logo <path>",
"remark":"See \"--help logo-type\" for more info",
"arg":{
"type":"path"
}
},
{
"long":"chafa-fg-only",
"desc":"Produce character-cell output using foreground colors only",
"remark":"See chafa document for detail",
"arg":{
"type":"bool",
"optional":true,
"default":false
}
},
{
"long":"chafa-symbols",
"desc":"Specify character symbols to employ in final output",
"remark":"See chafa document for detail",
"arg":{
"type":"str"
}
},
{
"long":"chafa-canvas-mode",
"desc":"Determine how colors are used in the output",
"remark":"This value maps the int value of enum ChafaCanvasMode. See chafa document for detail",
"arg":{
"type":"enum",
"enum":{
"TRUECOLOR":"Truecolor",
"INDEXED_256":"256 colors",
"INDEXED_240":"256 colors, but avoid using the lower 16 whose values vary between terminal environments",
"INDEXED_16":"16 colors using the aixterm ANSI extension",
"FGBG_BGFG":"Default foreground and background colors, plus inversion",
"FGBG":"Default foreground and background colors. No ANSI codes will be used",
"INDEXED_8":"8 colors, compatible with original ANSI X3.64",
"INDEXED_16_8":"16 FG colors (8 of which enabled with bold/bright) and 8 BG colors"
}
}
},
{
"long":"chafa-color-space",
"desc":"Set color space used for quantization",
"remark":"This value maps the int value of enum ChafaColorSpace. See chafa document for detail",
"arg":{
"type":"enum",
"enum":{
"RGB":"RGB color space. Fast but imprecise",
"DIN99D":"DIN99d color space. Slower, but good perceptual color precision"
}
}
},
{
"long":"chafa-dither-mode",
"desc":"Set output dither mode (No effect with 24-bit color)",
"remark":"This value maps the int value of enum ChafaDitherMode. See chafa document for detail",
"arg":{
"type":"enum",
"enum":{
"NONE":"No dithering",
"ORDERED":"Ordered dithering (Bayer or similar)",
"DIFFUSION":"Error diffusion dithering (Floyd-Steinberg or similar)"
}
}
}
],
"Display":[
{
"short":"s",
"long":"structure",
"desc":"Set the structure of the fetch",
"remark":"Must be a colon separated list of keys. Use \"fastfetch --list-modules\" to see the ones available",
"arg":{
"type":"structure",
"default":"\"fastfetch --print-structure\""
}
},
{
"long":"stat",
"desc":"Show time usage (in ms) for individual modules",
"arg":{
"type":"bool",
"optional":true,
"default":false
}
},
{
"long":"pipe",
"desc":"Disable logo and all escape sequences",
"arg":{
"type":"bool",
"optional":true,
"default":"Auto detection based on isatty(1)"
}
},
{
"long":"color-keys",
"desc":"Set the color of the keys",
"arg":{
"type":"color"
}
},
{
"long":"color-title",
"desc":"Set the color of the title",
"arg":{
"type":"color"
}
},
{
"long":"color",
"desc":"Set the color of both the keys and title",
"remark":"Shortcut of \"--color-keys <color>\" and \"--color-title <color>\"",
"arg":{
"type":"color"
}
},
{
"long":"key-width",
"desc":"Align the width of keys to <num> characters",
"arg":{
"type":"num"
}
},
{
"long":"bright-color",
"desc":"Set if the keys, title and ASCII logo should be printed in bright color",
"arg":{
"type":"bool",
"optional":true,
"default":true
}
},
{
"long":"separator",
"desc":"Set the separator between key and value",
"arg":{
"type":"str",
"default":": "
}
},
{
"long":"set",
"desc":"Hard set the value of a key",
"arg":{
"type":"key=value"
}
},
{
"long":"set-keyless",
"desc":"Hard set the value of a key, but don't print the key or the separator",
"arg":{
"type":"key=value"
}
},
{
"long":"show-errors",
"desc":"Print occurring errors",
"arg":{
"type":"bool",
"optional":true,
"default":false
}
},
{
"long":"disable-linewrap",
"desc":"Whether to disable line wrap during the run",
"arg":{
"type":"bool",
"optional":true,
"default":true
}
},
{
"long":"hide-cursor",
"desc":"Whether to hide the cursor during the run",