158 lines
4.8 KiB
Markdown
158 lines
4.8 KiB
Markdown
# fetch.sh
|
|
### Check the releases page
|
|
|
|
https://github.com/dylanaraps/fetch.sh
|
|
|
|
|
|
This is the home of my fetch script! This script gathers info <br\>
|
|
about your system and prints it to the terminal.
|
|
|
|
I've spent the past few days rewriting this and it now supports <br\>
|
|
other distros as well as a ton of new features and bug fixes.
|
|
|
|
If you're having any issues or have any ideas, please open an issue! <br\>
|
|
I can't test on many other distros and I want this to work <br\>
|
|
for as many people as possible.
|
|
|
|
|
|
|
|
|
|
## Dependencies
|
|
|
|
These are the script's required dependencies
|
|
|
|
- Text formatting, dynamic image size and padding: tput
|
|
|
|
These are the script's optional dependencies:
|
|
|
|
- Displaying Images: w3m
|
|
- Image Cropping: ImageMagick
|
|
- Display Wallpaper: feh
|
|
- Current Song: mpc
|
|
|
|
|
|
## Usage
|
|
|
|
The script now supports dynamic image sizing and padding,
|
|
<br\> they're enabled by default and there's a variable you
|
|
<br\> need to set for it to work correctly.
|
|
|
|
You can either change the variable $fontwidth inside of the
|
|
<br\> script or launch it with "--fontwidth num".
|
|
|
|
Once you set the var the script will scale the image and padding
|
|
<br\> to fit your terminal window.
|
|
|
|
You can disable this by changing the var "$img_auto" or by launching
|
|
<br\> the script with "--size px".
|
|
|
|
Please report any bugs or issues you're having with this as I can't
|
|
<br\> test with many configurations.
|
|
|
|
|
|
```
|
|
usage: scrot.sh [--colors 1 2 4 5] [--kernel "$(uname -rs)"]
|
|
|
|
Info:
|
|
--title string Change the title at the top
|
|
--distro string/cmd Manually set the distro
|
|
--kernel string/cmd Manually set the kernel
|
|
--uptime string/cmd Manually set the uptime
|
|
--packages string/cmd Manually set the package count
|
|
--shell string/cmd Manually set the shell
|
|
--winman string/cmd Manually set the window manager
|
|
--cpu string/cmd Manually set the cpu name
|
|
--memory string/cmd Manually set the memory
|
|
--speed string/cmd Manually set the cpu speed
|
|
--speed_type Change the type of cpu speed to get
|
|
Possible values: current, min, max
|
|
--song string/cmd Manually set the current song
|
|
|
|
Text Colors:
|
|
--colors 1 2 3 4 Change the color of text
|
|
(title, subtitle, colon, info)
|
|
--titlecol num Change the color of the title
|
|
--subtitlecol num Change the color of the subtitle
|
|
--coloncol num Change the color of the colons
|
|
--infocol num Change the color of the info
|
|
|
|
Text Formatting:
|
|
--nowrap Disable line wrapping
|
|
--nobold Disable bold text
|
|
|
|
Color Blocks:
|
|
--printcols start end Range of colors to print as blocks
|
|
--blockwidth num Width of color blocks"
|
|
--nopal Disable the color blocks
|
|
|
|
Image:
|
|
--image Image to display with the script
|
|
The image gets priority over other
|
|
images: (wallpaper, \$img)
|
|
|
|
--fontwidth Used to automatically size the image
|
|
--size px Change the size of the image
|
|
--cropoffset value Change the crop offset. Possible values:
|
|
northwest, north, northeast, west, center
|
|
east, southwest, south, southeast
|
|
--padding num How many spaces to pad the text
|
|
to the right
|
|
--xoffset px How close the image will be
|
|
to the left edge of the window
|
|
--yoffset px How close the image will be
|
|
to the top edge of the window
|
|
|
|
--gap num Gap between image and text right side
|
|
--noimg Disable all images
|
|
--nowall Disable the wallpaper function
|
|
and fallback to \$img
|
|
--clean Remove all cropped images
|
|
|
|
Other:
|
|
--help Print this text and exit
|
|
```
|
|
|
|
|
|
## TODO
|
|
|
|
Here's what's on my todo list
|
|
|
|
- Add an easy way to define info prefixes at launch.
|
|
- Finish adding an option to smart crop images with plain color backgrounds.
|
|
<br/>What this means is that your solid bg waifu wallpaper will be cropped around
|
|
<br/>your waifu no matter where she is in the image.
|
|
- Cleanup
|
|
|
|
|
|
## Customization
|
|
|
|
I launch fetch using a shell function and a ton of flags. Here's how it looks:
|
|
|
|
```sh
|
|
fetch () {
|
|
fetch.sh \
|
|
--printcols 1 7 \
|
|
--cpu "AMD FX-6300" \
|
|
--uptime "$(uptime -p | sed -e 's/minutes/mins/')" \
|
|
--title "dylan's pc" \
|
|
--nowrap \
|
|
--nobold \
|
|
$@
|
|
}
|
|
```
|
|
|
|
Notice how you can even pass commands? This allows you to easily use custom
|
|
<br/> commands or even just bare strings to change the info.
|
|
|
|
|
|
## Screenshots
|
|
|
|
#### The color script is now builtin.
|
|
|
|
|
|
#### You can now customize the color of everything.
|
|
|
|
|
|
#### You can now disable all images with a flag.
|
|
|