mirror of
https://github.com/KittyKatt/screenFetch.git
synced 2026-01-07 22:13:56 -05:00
81 lines
4.5 KiB
Markdown
81 lines
4.5 KiB
Markdown
|
|
# screenFetch - The Bash Screenshot Information Tool
|
|
|
|
## Important!
|
|
|
|
Please see [this discussion](https://github.com/KittyKatt/screenFetch/discussions/805) on the current state of screenFetch.
|
|
|
|
## What is screenFetch?
|
|
|
|
screenFetch is a "Bash Screenshot Information Tool". This handy Bash
|
|
script can be used to generate one of those nifty terminal theme
|
|
information + ASCII distribution logos you see in everyone's screenshots
|
|
nowadays. It will auto-detect your distribution and display an ASCII
|
|
version of that distribution's logo and some valuable information to the
|
|
right. There are options to specify no ASCII art, colors, taking a
|
|
screenshot upon displaying info, and even customizing the screenshot
|
|
command! This script is very easy to add to and can easily be extended.
|
|
|
|
## How do I get screenFetch?
|
|
|
|
Please see [Installation](https://github.com/KittyKatt/screenFetch/wiki/Installation).
|
|
|
|
## Running screenfetch
|
|
|
|
To run screenFetch, open a terminal of some sort and type in the command `screenfetch`
|
|
or wherever you saved the script to. This will generate an ASCII logo with the
|
|
information printed to the side of the logo. There are some options that may be
|
|
specified on the command line, and those are shown below or by executing `screenfetch -h`:
|
|
|
|
-v Verbose output.
|
|
-o 'OPTIONS' Allows for setting script variables on the
|
|
command line. Must be in the following format...
|
|
'OPTION1="OPTIONARG1";OPTION2="OPTIONARG2"'
|
|
-d '+var;-var;var' Allows for setting what information is displayed
|
|
on the command line. You can add displays with +var,var. You
|
|
can delete displays with -var,var. Setting without + or - will
|
|
set display to that explicit combination. Add and delete statements
|
|
may be used in conjunction by placing a ; between them as so:
|
|
+var,var,var;-var,var.
|
|
-n Do not display ASCII distribution logo.
|
|
-N Strip all color from output.
|
|
-w Wrap long lines.
|
|
-t Truncate output based on terminal width (Experimental!).
|
|
-p Output in portrait mode, with logo above info.
|
|
-s [-u IMGHOST] Using this flag tells the script that you want it
|
|
to take a screenshot. Use the -m flag if you would like
|
|
to move it to a new location afterwards.
|
|
-c string You may change the outputted colors with -c. The format is
|
|
as follows: [0-9][0-9],[0-9][0-9]. The first argument controls the
|
|
ASCII logo colors and the label colors. The second argument
|
|
controls the colors of the information found. One argument may be
|
|
used without the other.
|
|
-a 'PATH' You can specify a custom ASCII art by passing the path
|
|
to a Bash script, defining `startline` and `fulloutput`
|
|
variables, and optionally `labelcolor` and `textcolor`.
|
|
See the `asciiText` function in the source code for more
|
|
information on the variables format.
|
|
-S 'COMMAND' Here you can specify a custom screenshot command for
|
|
the script to execute. Surrounding quotes are required.
|
|
-D 'DISTRO' Here you can specify your distribution for the script
|
|
to use. Surrounding quotes are required.
|
|
-A 'DISTRO' Here you can specify the distribution art that you want
|
|
displayed. This is for when you want your distro
|
|
detected but want to display a different logo.
|
|
-E Suppress output of errors.
|
|
-C Add custom (extra) lines.
|
|
For example:
|
|
screenfetch -C 'IP WAN=192.168.0.12,IP BRIDGED=10.1.1.10'
|
|
... will add two extra lines:
|
|
IP WAN: 192.168.0.12
|
|
IP BRIDGED: 10.1.1.10
|
|
-V, --version Display current script version.
|
|
-h, --help Display this help.
|
|
|
|
## Contact Me
|
|
|
|
If you would like to suggest something new, inform me of an issue in the
|
|
script, become part of the project, or talk to me about anything else,
|
|
you can either email me at `screenfetch@kittykatt.co` or you can connect
|
|
to Rizon and reach me at `irc://irc.rizon.net/screenFetch`
|