1SCREENFETCH(1)                   User Commands                  SCREENFETCH(1)
2
3
4

NAME

6       screenFetch - The Bash Screenshot Information Tool
7
8

SYNOPSIS

10       screenfetch [OPTIONAL FLAGS]
11
12

DESCRIPTION

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
23       Supported GNU/Linux Distributions:
24
25              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
41       Other Supported Systems:
42
43              Dragonfly/Free/Open/Net BSD, Haiku, Mac OS X, Windows+Cygwin and
44              Windows+MSYS2.
45
46       Supported Desktop Managers:
47
48              KDE,  GNOME,  Unity,  Xfce,  LXDE,  Cinnamon, MATE, Deepin, CDE,
49              RazorQt and Trinity.
50
51       Supported Window Managers:
52
53              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
60

OPTIONS

62       -v     Verbose output.
63
64       -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
69       -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
77       -n     Do not display ASCII distribution logo.
78
79       -L     Display ASCII distribution logo only.
80
81       -N     Strip all color from output.
82
83       -w     Wrap long lines.
84
85       -t     Truncate output based on terminal width (Experimental!).
86
87       -p     Output in portrait mode, with logo above info.
88
89       -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
95       -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
102       -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
108       -S 'COMMAND'
109              Here you can specify a custom screenshot command for the  script
110              to execute. Surrounding quotes are required.
111
112       -D 'DISTRO'
113              Here  you  can  specify your distribution for the script to use.
114              Surrounding quotes are required.
115
116       -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
121       -E     Suppress output of errors.
122
123       -V, --version
124              Display current script version.
125
126       -h, --help
127              Display this help.
128
129

SEE ALSO

131       http://github.com/KittyKatt/screenFetch
132
133

AUTHOR

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
139       This manual page was written by djcj <djcj@gmx.de>
140
141

REPORTING BUGS

143       Report bugs to <https://github.com/KittyKatt/screenFetch/issues>
144
145
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.
151
152
153
1543.9.1                              Juni 2018                    SCREENFETCH(1)
Impressum