1SCREENFETCH(1) User Commands SCREENFETCH(1)
2
6 screenFetch - The Bash Screenshot Information Tool
7
10 screenfetch [OPTIONAL FLAGS]
11
14 This handy Bash script can be used to generate one of those nifty ter‐
15 minal theme information + ASCII distribution logos you see in every‐
16 one's screenshots nowadays. It will auto-detect your distribution and
17 display an ASCII version of that distribution's logo and some valuable
18 information to the right. There are options to specify no ASCII art,
19 colors, taking a screenshot upon displaying info, and even customizing
20 the screenshot command! This script is very easy to add to and can
21 easily be extended.
22 Supported GNU/Linux Distributions:
24 ALDOS, Alpine Linux, Amazon Linux, Antergos, Arch Linux (Old and
26 Current Logos), Artix Linux, blackPanther OS, BLAG, BunsenLabs,
27 CentOS, Chakra, Chapeau, Chrome OS, Chromium OS, CrunchBang,
28 CRUX, Debian, Deepin, DesaOS, Devuan, Dragora, elementary OS,
29 Evolve OS, Exherbo, Fedora, Frugalware, Fuduntu, Funtoo, Fux,
30 Gentoo, gNewSense, Guix System, Hyperbola GNU/Linux-libre, Jiyuu
31 Linux, Kali Linux, KaOS, KDE neon, Kogaion, Korora, LinuxDeepin,
32 Linux Mint, LMDE, Logos, Mageia, Mandriva/Mandrake, Manjaro,
33 Mer, Netrunner, NixOS, OBRevenge, openSUSE, OS Elbrus, Oracle
34 Linux, Parabola GNU/Linux-libre, Pardus, Parrot Security, PCLin‐
35 uxOS, PeppermintOS, Proxmox VE, PureOS, Qubes OS, Raspbian, Red
36 Hat Enterprise Linux, ROSA, Sabayon, SailfishOS, Scientific
37 Linux, Siduction, Slackware, Solus, Source Mage GNU/Linux,
38 SparkyLinux, SteamOS, SUSE Linux Enterprise, SwagArch, TinyCore,
39 Trisquel, Ubuntu, Viperr, Void and Zorin OS.
40 Other Supported Systems:
42 Dragonfly/Free/Open/Net BSD, Haiku, Mac OS X, Windows+Cygwin and
44 Windows+MSYS2.
45 Supported Desktop Managers:
47 KDE, GNOME, Unity, Xfce, LXDE, Cinnamon, MATE, Deepin, CDE,
49 RazorQt and Trinity.
50 Supported Window Managers:
52 2bwm, 9wm, Awesome, Beryl, Blackbox, Cinnamon, chromeos-wm, Com‐
54 piz, deepin-wm, dminiwm, dwm, dtwm, E16, E17, echinus, Emerald,
55 FluxBox, FLWM, FVWM, herbstluftwm, howm, IceWM, KWin, Metacity,
56 monsterwm, Musca, Gala, Mutter, Muffin, Notion, OpenBox, PekWM,
57 Ratpoison, Sawfish, ScrotWM, SpectrWM, StumpWM, subtle, sway,
58 TWin, WindowMaker, WMFS, wmii, Xfwm4, XMonad and i3.
59
62 -v Verbose output.
63 -o 'OPTIONS'
65 Allows for setting script variables on the command line. Must be
66 in the following format:
67 'OPTION1="OPTIONARG1";OPTION2="OPTIONARG2"'
68 -d '+var;-var;var'
70 Allows for setting what information is displayed on the command
71 line. You can add displays with +var,var. You can delete dis‐
72 plays with -var,var. Setting without + or - will set display to
73 that explicit combination. Add and delete statements may be used
74 in conjunction by placing a ; between them as so:
75 +var,var,var;-var,var.
76 -n Do not display ASCII distribution logo.
78 -L Display ASCII distribution logo only.
80 -N Strip all color from output.
82 -w Wrap long lines.
84 -t Truncate output based on terminal width (Experimental!).
86 -p Output in portrait mode, with logo above info.
88 -s [-u IMGHOST]
90 Using this flag tells the script that you want it to take a
91 screenshot. Use the -u flag if you would like to upload the
92 screenshots to one of the pre-configured locations. These
93 include: teknik, imgur, mediacrush and hmp.
94 -c string
96 You may change the outputted colors with -c. The format is as
97 follows: [0-9][0-9],[0-9][0-9]. The first argument controls the
98 ASCII logo colors and the label colors. The second argument con‐
99 trols the colors of the information found. One argument may be
100 used without the other.
101 -a 'PATH'
103 You can specify a custom ASCII art by passing the path to a Bash
104 script, defining startline and fulloutput variables, and option‐
105 ally labelcolor and textcolor. See the asciiText function in the
106 source code for more information on the variables format.
107 -S 'COMMAND'
109 Here you can specify a custom screenshot command for the script
110 to execute. Surrounding quotes are required.
111 -D 'DISTRO'
113 Here you can specify your distribution for the script to use.
114 Surrounding quotes are required.
115 -A 'DISTRO'
117 Here you can specify the distribution art that you want dis‐
118 played. This is for when you want your distro detected but want
119 to display a different logo.
120 -E Suppress output of errors.
122 -V, --version
124 Display current script version.
125 -h, --help
127 Display this help.
128
131 http://github.com/KittyKatt/screenFetch
132
135 Created by and licensed to Brett Bohnenkamper <kittykatt@kittykatt.us>.
136 OS X porting done almost solely by shrx <https://github.com/shrx> and
137 John D. Duncan, III <https://github.com/JohnDDuncanIII>.
138 This manual page was written by djcj <djcj@gmx.de>
140
143 Report bugs to <https://github.com/KittyKatt/screenFetch/issues>
144
147 This is free software; you can redistribute it and/or modify it under
148 the terms of the GNU GPL version 3 or (at your option) any later ver‐
149 sion. There is NO warranty; not even MERCHANTABILITY or FITNESS FOR A
150 PARTICULAR PURPOSE.
1513.9.1 Juni 2018 SCREENFETCH(1)