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

FreeBSD Manual Pages


home | help
NEOFETCH(1)			 User Commands			   NEOFETCH(1)

       Neofetch	- A fast, highly customizable system info script

       neofetch	func_name --option "value" --option "value"

       Neofetch	 is  a	CLI  system information	tool written in	BASH. Neofetch
       displays	information about your system next to an image,	your OS	 logo,
       or any ASCII file of your choice.

       NOTE: Every launch flag has a config option.

	      Specify  a  function name	(second	part of	info() from config) to
	      quickly display only that	function's information.

	      Example: neofetch	uptime --uptime_shorthand tiny

	      Example: neofetch	uptime disk wm memory

	      This can be used in bars and scripts like	so:

	      memory="$(neofetch memory)"; memory="${memory##*:	}"

	      For multiple outputs at once (each line of info in an array):

	      IFS=$'\n'	read -d	"" -ra info < <(neofetch memory	uptime wm)

	      info=("${info[@]##*: }")

       --disable infoname
	      Allows you to disable an info line from appearing	in the output.
	      'infoname' is the	function name from the 'print_info()' function
	      inside the config	file.  For  example:  'info  "Memory"  memory'
	      would be '--disable memory'

	      NOTE:  You can supply multiple args. eg. 'neofetch --disable cpu

       --title_fqdn on/off
	      Hide/Show	Fully Qualified	Domain Name in title.

       --package_managers on/off
	      Hide/Show	Package	Manager	names .	(on, tiny, off)

       --os_arch on/off
	      Hide/Show	OS architecture.

       --speed_type type
	      Change the type of cpu speed to display.	Possible values:  cur-
	      rent, min, max, bios, scaling_current, scaling_min, scaling_max

	      NOTE: This only supports Linux with cpufreq.

       --speed_shorthand on/off
	      Whether or not to	show decimals in CPU speed.

       NOTE: This flag is not supported	in systems with	CPU speed less than
	      1	GHz.

       --cpu_brand on/off
	      Enable/Disable CPU brand in output.

       --cpu_cores type
	      Whether  or not to display the number of CPU cores Possible val-
	      ues: logical, physical, off

	      NOTE: 'physical' doesn't work on BSD.

       --cpu_speed on/off
	      Hide/Show	cpu speed.

       --cpu_temp C/F/off
	      Hide/Show	cpu temperature.

	      NOTE: This only works on Linux and BSD.

       NOTE: For FreeBSD and NetBSD-based systems, you need to enable
	      coretemp kernel module. This only	supports newer	Intel  proces-

       --distro_shorthand on/off
	      Shorten the output of distro (on,	tiny, off)

	      NOTE: This option	won't work in Windows (Cygwin)

       --kernel_shorthand on/off
	      Shorten the output of kernel

	      NOTE: This option	won't work in BSDs (except PacBSD and PC-BSD)

       --uptime_shorthand on/off
	      Shorten the output of uptime (on,	tiny, off)

       --refresh_rate on/off
	      Whether  to display the refresh rate of each monitor Unsupported
	      on Windows

       --gpu_brand on/off
	      Enable/Disable GPU brand in output. (AMD/NVIDIA/Intel)

       --gpu_type type
	      Which GPU	to display. (all, dedicated, integrated)

	      NOTE: This only supports Linux.

       --de_version on/off
	      Show/Hide	Desktop	Environment version

       --gtk_shorthand on/off
	      Shorten output of	gtk theme/icons

       --gtk2 on/off
	      Enable/Disable gtk2 theme/font/icons output

       --gtk3 on/off
	      Enable/Disable gtk3 theme/font/icons output

       --shell_path on/off
	      Enable/Disable showing $SHELL path

       --shell_version on/off
	      Enable/Disable showing $SHELL version

       --disk_show value
	      Which disks to  display.	 Possible  values:  '/',  '/dev/sdXX',
	      '/path/to/mount point'

	      NOTE:   Multiple	 values	  can	be   given.  (--disk_show  '/'

       --disk_subtitle type
	      What information to append to the	Disk subtitle.	 Takes:	 name,
	      mount, dir, none

	      'name' shows the disk's name (sda1, sda2,	etc)

	      'mount' shows the	disk's mount point (/, /mnt/Local Disk,	etc)

	      'dir'  shows  the	 basename of the disks's path. (/, Local Disk,

	      'none' shows only	'Disk' or the configured title.

       --disk_percent on/off
	      Hide/Show	disk percent.

       --ip_host url
	      URL to query for public IP

       --ip_timeout int
	      Public IP	timeout	(in seconds).

       --song_format format
	      Print the	song data in a specific	format (see config file).

       --song_shorthand	on/off
	      Print the	Artist/Album/Title on separate lines.

       --memory_percent	on/off
	      Display memory percentage.

       --music_player player-name
	      Manually specify a player	to use.	 Available values  are	listed
	      in the config file

       --colors	x x x x	x x
	      Changes the text colors in this order: title, @, underline, sub-
	      title, colon, info

       --underline on/off
	      Enable/Disable the underline.

       --underline_char	char
	      Character	to use when underlining	title

       --bold on/off
	      Enable/Disable bold text

       --separator string
	      Changes the default ':' separator	to the specified string.

       --color_blocks on/off
	      Enable/Disable the color blocks

       --col_offset auto/num
	      Left-padding of color blocks

       --block_width num
	      Width of color blocks in spaces

       --block_height num
	      Height of	color blocks in	lines

       --block_range num num
	      Range of colors to print as blocks

       --bar_char 'elapsed char' 'total	char'
	      Characters to use	when drawing bars.

       --bar_border on/off
	      Whether or not to	surround the bar with '[]'

       --bar_length num
	      Length in	spaces to make the bars.

       --bar_colors num	num
	      Colors to	make the bar.  Set in this order: elapsed, total

       --cpu_display mode
	      Bar mode.	 Possible values: bar, infobar,	barinfo, off

       --memory_display	mode
	      Bar mode.	 Possible values: bar, infobar,	barinfo, off

       --battery_display mode
	      Bar mode.	 Possible values: bar, infobar,	barinfo, off

       --disk_display mode
	      Bar mode.	 Possible values: bar, infobar,	barinfo, off

       --backend backend
	      Which image backend to use.  Possible values:  'ascii',  'caca',
	      'chafa',	'jp2a',	 'iterm2',  'off',  'sixel',  'tycat',	'w3m',

       --source	source
	      Which image or ascii file	 to  use.   Possible  values:  'auto',
	      'ascii',	  'wallpaper',	  '/path/to/img',    '/path/to/ascii',
	      '/path/to/dir/', 'command	output'	[ascii]

       --ascii source
	      Shortcut to use 'ascii' backend.

	      NEW: neofetch --ascii "$(fortune | cowsay	-W 30)"

       --caca source
	      Shortcut to use 'caca' backend.

       --chafa source
	      Shortcut to use 'chafa' backend.

       --iterm2	source
	      Shortcut to use 'iterm2' backend.

       --jp2a source
	      Shortcut to use 'jp2a' backend.

       --kitty source
	      Shortcut to use 'kitty' backend.

       --pixterm source
	      Shortcut to use 'pixterm'	backend.

       --sixel source
	      Shortcut to use 'sixel' backend.

       --termpix source
	      Shortcut to use 'termpix'	backend.

       --tycat source
	      Shortcut to use 'tycat' backend.

       --w3m source
	      Shortcut to use 'w3m' backend.

       --off  Shortcut to use 'off' backend (Disable ascii art).

	      NOTE: 'source; can be any	of  the	 following:  'auto',  'ascii',
	      'wallpaper', '/path/to/img', '/path/to/ascii', '/path/to/dir/'

       --ascii_colors x	x x x x	x
	      Colors to	print the ascii	art

       --ascii_distro distro
	      Which Distro's ascii art to print

       NOTE: AIX, Alpine, AlterLinux, Anarchy, Android,	Antergos, antiX,
	      "AOSC  OS", "AOSC	OS/Retro", Apricity, ArcoLinux,	ArchBox, ARCH-
	      labs, ArchStrike,	XFerience, ArchMerge, Arch, Artix, Arya,  Bed-
	      rock,  Bitrig, BlackArch,	BLAG, BlankOn, BlueLight, bonsai, BSD,
	      BunsenLabs, Calculate, Carbs, CentOS, Chakra, ChaletOS, Chapeau,
	      Chrom,  Cleanjaro,  ClearOS,  Clear_Linux, Clover, Condres, Con-
	      tainer_Linux, CRUX, Cucumber, Debian,  Deepin,  DesaOS,  Devuan,
	      DracOS,  DragonFly,  Drauger,  Elementary, EndeavourOS, Endless,
	      EuroLinux, Exherbo, Fedora, Feren,  FreeBSD,  FreeMiNT,  Frugal-
	      ware,  Funtoo, GalliumOS,	Gentoo,	Pentoo,	gNewSense, GNOME, GNU,
	      GoboLinux, Grombyang, Guix,  Haiku,  Huayra,  Hyperbola,	janus,
	      Kali,   KaOS,   KDE_neon,	 Kibojoe,  Kogaion,  Korora,  KSLinux,
	      Kubuntu, LEDE, LFS, Linux_Lite,  LMDE,  Lubuntu,	Lunar,	macos,
	      Mageia,  MagpieOS,  Mandriva,  Manjaro,  Maui,  Mer, Minix, Lin-
	      uxMint, MX_Linux,	Namib,	Neptune,  NetBSD,  Netrunner,  Nitrux,
	      NixOS,  Nurunner,	 NuTyX,	OBRevenge, OpenBSD, OpenIndiana, open-
	      mamba, OpenMandriva, OpenStage, OpenWrt, osmc,  Oracle,  OS  El-
	      brus,  PacBSD,  Parabola,	Pardus,	Parrot,	Parsix,	TrueOS,	PCLin-
	      uxOS, Peppermint,	popos, Porteus,	PostMarketOS, Proxmox,	Puppy,
	      PureOS,  Qubes,  Radix,  Raspbian,  Reborn_OS, Redstar, Redcore,
	      Redhat, Refracted_Devuan,	Regata,	Rosa, sabotage,	Sabayon, Sail-
	      fish,  SalentOS,	Scientific,  Septor,  SereneLinux, SharkLinux,
	      Siduction,  Slackware,  SliTaz,  SmartOS,	 Solus,	  Source_Mage,
	      Sparky,  Star,  SteamOS,	SunOS, openSUSE_Leap, openSUSE_Tumble-
	      weed,  openSUSE,	SwagArch,  Tails,   Trisquel,	Ubuntu-Budgie,
	      Ubuntu-GNOME,  Ubuntu-MATE,  Ubuntu-Studio, Ubuntu, Venom, Void,
	      Obarun, windows10, Windows7, Xubuntu, Zorin, and IRIX have ascii

	      NOTE:  Arch, Ubuntu, Redhat, and Dragonfly have 'old' logo vari-

	      NOTE: Use	'{distro name}_old' to use the old logos.

	      NOTE: Ubuntu has flavor variants.

       NOTE: Change this to Lubuntu, Kubuntu, Xubuntu, Ubuntu-GNOME,
	      Ubuntu-Studio, Ubuntu-Mate  or Ubuntu-Budgie to use the flavors.

       NOTE: Arcolinux,	Dragonfly, Fedora, Alpine, Arch, Ubuntu,
	      CRUX, Debian, Gentoo, FreeBSD,  Mac,  NixOS,  OpenBSD,  android,
	      Antrix,  CentOS,	Cleanjaro, ElementaryOS, GUIX, Hyperbola, Man-
	      jaro, MXLinux,  NetBSD,  Parabola,  POP_OS,  PureOS,  Slackware,
	      SunOS,  LinuxLite,  OpenSUSE,  Raspbian,	postmarketOS, and Void
	      have a smaller logo variant.

	      NOTE: Use	'{distro name}_small' to use the small variants.

       --ascii_bold on/off
	      Whether or not to	bold the ascii logo.

       -L, --logo
	      Hide the info text and only show the ascii logo.

       --loop Redraw the image constantly until	Ctrl+C is used.	This fixes is-
	      sues in some terminals emulators when using image	mode.

       --size 00px | --size 00%
	      How to size the image.  Possible values: auto, 00px, 00%,	none

       --crop_mode mode
	      Which crop mode to use Takes the values: normal, fit, fill

       --crop_offset value
	      Change the crop offset for normal	mode.  Possible	values:	north-
	      west, north, northeast, west, center,  east,  southwest,	south,

       --xoffset px
	      How close	the image will be to the left edge of the window. This
	      only works with w3m.

       --yoffset px
	      How close	the image will be to the top edge of the window.  This
	      only works with w3m.

       --bg_color color
	      Background color to display behind transparent image.  This only
	      works with w3m.

       --gap num
	      Gap between image	and text.

       NOTE: --gap can take a negative value which will	move the text
	      closer to	the left side.

	      Delete cached files and thumbnails.

       --config	/path/to/config
	      Specify a	path to	a custom config	file

       --config	none
	      Launch the script	without	a config file

	      Don't create the user config file.

	      Print the	default	config file to stdout.

	      Turn off all colors and disables any ASCII/image backend.

       --help Print this text and exit

	      Show neofetch version

       -v     Display error messages.

       -vv    Display a	verbose	log for	error reporting.

	      Generate a manpage for  Neofetch	in  your  PWD.	(Requires  GNU

       Report bugs to

Neofetch 7.1.0			   Aug 2020			   NEOFETCH(1)


Want to link to this manual page? Use this URL:

home | help