NEOWOFETCH(1)

📦
version 1.99.0 · 3 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

🌈 NEOWOFETCH(1) — User Commands 💖

okay bestie, welcome to the neowofetch(1) manual, section 1, User Commands. it's giving "i know my system better than you know your skincare routine." let's go 🫶

✨ NAME ✨

Neowofetch — a highly customizable system info script. literally that's it, that's the whole vibe. 💅

🦋 SYNOPSIS 🦋

neowofetch func_name --option "value" --option "value"

that's the shape of it: function name first, then however many --option "value" pairs your heart desires.

👑 DESCRIPTION 👑

Neowofetch is a CLI system information tool written in BASH. it displays information about your system next to an image, your OS logo, or any ASCII file of your choice. no cap, that's the whole flex. 🌸

NOTE: Every launch flag has a config option. yes, every single one. so if you'd rather set it once and never think about it again, you absolutely can. iykyk.

💅 OPTIONS 💅

🍓 INFO:

  • func_name — drop a function name (the second part of info() from the config) and neowofetch will quickly show only that function's information</u>. short, sweet, one-line slay.

Example: neowofetch uptime --uptime_shorthand tiny

Example: neowofetch uptime disk wm memory

This can be used in bars and scripts like so:

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

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

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

info=("${info[@]##*: }")
  • --disable infoname — lets you yeet an info line out of the output entirely. infoname is the function name from the print_info() function inside the config file. For example: info "Memory" memory would be --disable memory. bye felicia 👋
NOTE: You can supply multiple args. eg. neowofetch --disable cpu gpu
  • --title_fqdn on/off — hide/show the Fully Qualified Domain Name in the title. your title, your rules.
  • --package_managers on/off — hide/show Package Manager names. (on, tiny, off) tiny is the little baby version, iconic.
  • --package_separate on/off — whether to separate system/user modes for supported package managers. keep them in their own little lanes ✨
  • --package_minimal — reduce the output of the packages list by not showing programming language package managers or Steam games. sorry gamers, not today 🎮
  • --os_arch on/off — hide/show OS architecture.
  • --speed_type type — change the type of cpu speed to display. Possible values: current, 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. decimals are so extra, sometimes.
NOTE: This flag is not supported in systems with CPU speed less than 1 GHz.
  • --cpu_brand on/off — enable/disable the CPU brand in the output.
  • --cpu_cores type — whether or not to display the number of CPU cores. Possible values: 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. pick your unit, pick your destiny.
NOTE: This only works on Linux and BSD.
NOTE: For FreeBSD and NetBSD-based systems, you need to enable the coretemp kernel module. This only supports newer Intel processors.
  • --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. windows stays uninvited 😭
  • --gpu_brand on/off — enable/disable the GPU brand in the 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 the Desktop Environment version.
  • --gtk_shorthand on/off — shorten the 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 the $SHELL path.
  • --shell_version on/off — enable/disable showing the $SHELL version.
  • --editor_path on/off — enable/disable showing the $EDITOR path.
  • --editor_version on/off — enable/disable showing the $EDITOR version.
  • --disk_show value — which disks to display. Possible values: /, /dev/sdXX, /path/to/mount point
NOTE: Multiple values can be given. (--disk_show '/' '/dev/sdc1')
  • --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, etc)
    • 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).
  • --ip_interface value — Interface(s) to use for local IP.
  • --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. give them each their own moment 💜
  • --memory_percent on/off — display memory percentage.
  • --memory_unit (k/m/g/t)ib — memory output unit.
  • --memory_precision integer — change memory output precision. (???0, default=2)
  • --music_player player-name — manually specify a player to use. Available values are listed in the config file.

🎀 TEXT FORMATTING:

  • --colors x x x x x x — changes the text colors in this order: title, @, underline, subtitle, colon, info. six little slots, six little moods.
  • --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. make it weird, make it yours 💅

🌈 COLOR BLOCKS:

  • --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.

🦋 BARS:

  • --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.
  • --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

🌸 IMAGE BACKEND:

  • --backend backend — which image backend to use. Possible values: 'ascii', 'caca', 'catimg', 'chafa', 'jp2a', 'iterm2', 'off', 'sixel', 'tycat', 'w3m', 'kitty', 'viu'
  • --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 the 'ascii' backend.

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

  • --caca source — shortcut to use the 'caca' backend.
  • --catimg source — shortcut to use the 'catimg' backend.
  • --chafa source — shortcut to use the 'chafa' backend.
  • --iterm2 source — shortcut to use the 'iterm2' backend.
  • --jp2a source — shortcut to use the 'jp2a' backend.
  • --kitty source — shortcut to use the 'kitty' backend.
  • --pot source — shortcut to use the 'pot' backend.
  • --pixterm source — shortcut to use the 'pixterm' backend.
  • --sixel source — shortcut to use the 'sixel' backend.
  • --termpix source — shortcut to use the 'termpix' backend.
  • --tycat source — shortcut to use the 'tycat' backend.
  • --w3m source — shortcut to use the 'w3m' backend.
  • --ueberzug source — shortcut to use the 'ueberzug' backend.
  • --viu source — shortcut to use the 'viu' backend.
  • --off — shortcut to use the 'off' backend (disable ascii art). art? gone. cancelled. 🙈
NOTE: source can be any of the following: 'auto', 'ascii', 'wallpaper', '/path/to/img', '/path/to/ascii', '/path/to/dir/'

⭐ ASCII:

  • --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: okay so this next bit is the ascii logo guest list and it is LONG, so buckle up bestie 💖 Every single one of these has ascii logos:

Ad??lie, aerOS, Afterglow, AIX, AlmaLinux, Alpine, Alter, Amazon, AmogOS, Anarchy, Android, Antergos, antiX, AOSC OS, Aperio GNU/Linux, Aperture, Apricity, Arch, ArchBox, Archcraft, archcraft_ascii, archcraft_minimal, ARCHlabs, ArchMerge, ArchStrike, ArcoLinux, Arkane, ArseLinux, Artix, Arya, Asahi, AsteroidOS, astOS, Astra Linux, Athena, azos, Bedrock, BigLinux, BigLinux_large, Bitrig, BlackArch, BlackMesa, blackPanther, BLAG, BlankOn, BlueLight, Bodhi, bonsai, BSD, BunsenLabs, CachyOS, Calculate, CalinixOS, Carbs, CBL-Mariner, CelOS, Center, CentOS, Chakra, ChaletOS, Chapeau, Chimera, ChonkySealOS, Chrom, Cleanjaro, Clear Linux OS, ClearOS, Clover, Cobalt, Condres, Container Linux by CoreOS, CRUX, Crystal Linux, Cucumber, CutefishOS, CuteOS, CyberOS, dahlia, DarkOs, Darwin, Debian, Deepin, DesaOS, Devuan, DietPi, digital UNIX, DracOS, DragonFly, Drauger, Droidian, Elementary, Elive, EncryptOS, EndeavourOS, Endless, Enso, EuroLinux, EvolutionOS, eweOS, Exherbo, Exodia Predator OS, Fedora, Fedora Kinoite, Fedora Sericea, Fedora Silverblue, Fedora_unicode, FemboyOS, Feren, Finnix, Floflis, FreeBSD, FreeMiNT, Frugalware, Funtoo, Furreto, GalliumOS, Garuda, Gentoo, GhostBSD, glaucus, gNewSense, GNOME, GNU, GoboLinux, GrapheneOS, Grombyang, Guix, Haiku, HamoniKR, HarDClanZ, Hash, Huayra, Hybrid, HydroOS, Hyperbola, iglunix, instantOS, Interix, IRIX, Ironclad, Itc, januslinux, Kaisen, Kali, KaOS, KDE, Kibojoe, Kogaion, Korora, KrassOS, KSLinux, Kubuntu, LainOS, LangitKetujuh, LaxerOS, LEDE, LibreELEC, Linspire, Linux, Linux Lite, Linux Mint, Linux Mint Old, LinuxFromScratch, Live Raizo, LMDE, Lubuntu, Lunar, mac, MacaroniOS, Mageia, Magix, MagpieOS, MainsailOS, Mandriva, Manjaro, MassOS, MatuusOS, Maui, Mauna, Meowix, Mer, Minix, MIRACLE LINUX, MX, Namib, NekOS, Neptune, NetBSD, Netrunner, Nitrux, NixOS, nixos_colorful, Nobara, NomadBSD, Nurunner, NuTyX, Obarun, OBRevenge, OmniOS, Open Source Media Center, OpenBSD, openEuler, OpenIndiana, openKylin, openmamba, OpenMandriva, OpenStage, openSUSE, openSUSE Leap, openSUSE Tumbleweed, OPNsense, Oracle, orchid, OS Elbrus, PacBSD, Panwah, Parabola, parch, Pardus, Parrot, Parsix, PCBSD, PCLinuxOS, pearOS, Pengwin, Pentoo, Peppermint, Peropesis, phyOS, PikaOS, Pisi, PNM Linux, Pop!_OS, Porteus, PostMarketOS, Profelis SambaBOX, Proxmox, PuffOS, Puppy, PureOS, Q4OS, Qubes, Qubyt, Quibian, Radix, Raspbian, ravynOS, Reborn OS, Red Star, Redcore, Redhat, Refracted Devuan, Regata, Regolith, RhaymOS, rocky, Rosa, Sabayon, sabotage, Sailfish, SalentOS, Salient OS, Salix, Sasanqua, Scientific, semc, Septor, Serene, SharkLinux, ShastraOS, Siduction, SkiffOS, Slackel, Slackware, SliTaz, SmartOS, Soda, Solus, Source Mage, Sparky, Star, SteamOS, Stock Linux, Sulin, SunOS, SwagArch, t2, Tails, Tatra, TeArch, TorizonCore, Trisquel, Twister, Ubuntu, Ubuntu Budgie, Ubuntu Cinnamon, Ubuntu Kylin, Ubuntu MATE, Ubuntu Studio, Ubuntu Sway, Ubuntu Touch, Ubuntu-GNOME, ubuntu_old02, Ultramarine Linux, unicodearch, Univalent, Univention, Uos, UrukOS, uwuntu, Vanilla, Venom, VNux, Void, VzLinux, wii-linux-ngx, Windows, Windows 10, Windows 11, Windows95, Wrt, Xenia, Xenia2, XFerience, Xray_OS, Xubuntu, yiffOS, Zorin

like??? that's the whole roster, it's giving phone book 😭 iconic of them tbh.

NOTE: the vintage girlies ✨ arch, dragonfly, Fedora, LangitKetujuh, nixos, redhat, Ubuntu have 'old' logo variants — use {distro}_old to use them. throwback era fr.
NOTE: the tiny cuties 🎀 alpine, android, arch, arcolinux, artix, CalinixOS, centos, cleanjaro, crux, debian, dragonfly, elementary, endeavouros, fedora, freebsd, garuda, gentoo, guix, haiku, hyperbola, kali, Linux, linuxlite, linuxmint, mac, mageia, MainsailOS, manjaro, mx, netbsd, nixos, openbsd, opensuse, orchid, parabola, popos, postmarketos, pureos, Raspbian, rocky, slackware, sunos, ubuntu, venom, void have 'small' logo variants — use {distro}_small to use them. > NOTE: Fedora has immutable spins with unique logos (except Onyx). > > NOTE: Change this to Silverblue, Kinoite, Sericea, or CoreOS to use the spins.
  • --ascii_bold on/off — Whether or not to bold the ascii logo. thick letters or nah, your call 💅
  • -L, --logo — Hide the info text and only show the ascii logo. just the art, no commentary. main character energy only.

🖼️ IMAGE

  • --loop — Redraw the image constantly until Ctrl+C is used. This fixes issues in some terminals emulators when using image mode. (yes you'll have to Ctrl+C out, that's the deal bestie ✨)
  • --size 00px | --size 00% — How to size the image. Possible values: auto, 00px, 00%, none.
  • --catimg_size 1/2 — Change the resolution of catimg. pick your pixel density 🌸
  • --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: northwest, north, northeast, west, center, east, southwest, south, southeast.
  • --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. personal space matters 🫶
NOTE: --gap can take a negative value which will move the text closer to the left side.
  • --clean — Delete cached files and thumbnails. digital declutter, we love a clean slate 🧚

🍓 OTHER

  • --config /path/to/config — Specify a path to a custom config file.
  • --config none — Launch the script without a config file.
  • --no_config — Don't create the user config file.
  • --print_config — Print the default config file to stdout.
  • --stdout=on — Turn off all colors and disables any ASCII/image backend.
  • --stdout=off — Enable the colored output and ASCII/image backend.
  • --stdout=auto — Let the program decide basing on the output type (default behavior).
  • --stdout — Equivalent to --stdout=on, for backward compatibility.
  • --help — Print this text and exit.
  • --version — Show neowofetch version.
  • -v — Display error messages.
  • -vv — Display a verbose log for error reporting.

👑 DEVELOPER

  • --gen-man — Generate a manpage for Neowofetch in your PWD. (Requires GNU help2man)

🐛 REPORTING BUGS

Found a bug? Not the slay. Report bugs to https://github.com/hykilpikonna/hyfetch/issues 💀

🌈 SEE ALSO

The full documentation for Neowofetch is maintained as a Texinfo manual. If the info and Neowofetch programs are properly installed at your site, the command

info Neowofetch

should give you access to the complete manual. go read it bestie, it's lowkey required reading 📚

and that's a wrap on the whole page!! this was Neowofetch 7.98.0, dated October 2024 — periodt, go touch some grass and then come back and run it again 💖✨🦋🌸👑

📦 where this page comes from