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 Alpine Linux, Antergos, Arch Linux (Old and Current Logos),
26 BLAG, BunsenLabs, CentOS, Chakra, Chapeau, Chrome OS, Chromium
27 OS, CrunchBang, CRUX, Debian, Deepin, Devuan, Dragora, elemen‐
28 tary OS, Evolve OS, Exherbo, Fedora, Frugalware, Fuduntu, Fun‐
29 too, Fux, Gentoo, gNewSense, Jiyuu Linux, Kali Linux, KaOS, KDE
30 neon, Kogaion, Korora, LinuxDeepin, Linux Mint, LMDE, Logos,
31 Mageia, Mandriva/Mandrake, Manjaro, Mer, Netrunner, NixOS, open‐
32 SUSE, Oracle Linux, Parabola GNU/Linux-libre, Pardus, Parrot
33 Security, PCLinuxOS, PeppermintOS, Qubes OS, Raspbian, Red Hat
34 Enterprise Linux, ROSA, Sabayon, SailfishOS, Scientific Linux,
35 Slackware, Solus, SparkyLinux, SteamOS, SUSE Linux Enterprise,
36 SwagArch, TinyCore, Trisquel, Ubuntu, Viperr and Void.
37 Other Supported Systems:
39 Dragonfly/Free/Open/Net BSD, Haiku, Mac OS X, Windows+Cygwin and
41 Windows+MSYS2.
42 Supported Desktop Managers:
44 KDE, GNOME, Unity, Xfce, LXDE, Cinnamon, MATE, Deepin, CDE,
46 RazorQt and Trinity.
47 Supported Window Managers:
49 2bwm, 9wm, Awesome, Beryl, Blackbox, Cinnamon, chromeos-wm, Com‐
51 piz, deepin-wm, dminiwm, dwm, dtwm, E16, E17, echinus, Emerald,
52 FluxBox, FLWM, FVWM, herbstluftwm, howm, IceWM, KWin, Metacity,
53 monsterwm, Musca, Gala, Mutter, Muffin, Notion, OpenBox, PekWM,
54 Ratpoison, Sawfish, ScrotWM, SpectrWM, StumpWM, subtle, sway,
55 TWin, WindowMaker, WMFS, wmii, Xfwm4, XMonad and i3.
56
59 -v Verbose output.
60 -o 'OPTIONS'
62 Allows for setting script variables on the command line. Must be
63 in the following format:
64 'OPTION1="OPTIONARG1";OPTION2="OPTIONARG2"'
65 -d '+var;-var;var'
67 Allows for setting what information is displayed on the command
68 line. You can add displays with +var,var. You can delete dis‐
69 plays with -var,var. Setting without + or - will set display to
70 that explicit combination. Add and delete statements may be used
71 in conjunction by placing a ; between them as so:
72 +var,var,var;-var,var.
73 -n Do not display ASCII distribution logo.
75 -L Display ASCII distribution logo only.
77 -N Strip all color from output.
79 -w Wrap long lines.
81 -t Truncate output based on terminal width (Experimental!).
83 -p Output in portrait mode, with logo above info.
85 -s [-u IMGHOST]
87 Using this flag tells the script that you want it to take a
88 screenshot. Use the -u flag if you would like to upload the
89 screenshots to one of the pre-configured locations. These
90 include: teknik, imgur, mediacrush and hmp.
91 -c string
93 You may change the outputted colors with -c. The format is as
94 follows: [0-9][0-9],[0-9][0-9]. The first argument controls the
95 ASCII logo colors and the label colors. The second argument con‐
96 trols the colors of the information found. One argument may be
97 used without the other.
98 -a 'PATH'
100 You can specify a custom ASCII art by passing the path to a Bash
101 script, defining startline and fulloutput variables, and option‐
102 ally labelcolor and textcolor. See the asciiText function in the
103 source code for more informations on the variables format.
104 -S 'COMMAND'
106 Here you can specify a custom screenshot command for the script
107 to execute. Surrounding quotes are required.
108 -D 'DISTRO'
110 Here you can specify your distribution for the script to use.
111 Surrounding quotes are required.
112 -A 'DISTRO'
114 Here you can specify the distribution art that you want dis‐
115 played. This is for when you want your distro detected but want
116 to display a different logo.
117 -E Suppress output of errors.
119 -V, --version
121 Display current script version.
122 -h, --help
124 Display this help.
125
128 http://github.com/KittyKatt/screenFetch
129
132 Created by and licensed to Brett Bohnenkamper <kittykatt@kittykatt.us>.
133 OS X porting done almost solely by shrx <https://github.com/shrx> and
134 John D. Duncan, III <https://github.com/JohnDDuncanIII>.
135 This manual page was written by djcj <djcj@gmx.de>
137
140 Report bugs to <https://github.com/KittyKatt/screenFetch/issues>
141
144 This is free software; you can redistribute it and/or modify it under
145 the terms of the GNU GPL version 3 or (at your option) any later ver‐
146 sion. There is NO warranty; not even MERCHANTABILITY or FITNESS FOR A
147 PARTICULAR PURPOSE.
1483.8.0 March 2017 SCREENFETCH(1)