# fetch [[Features](#features)] [[Dependencies](#dependencies)] [[Installation](#installation)] [[Usage](#usage)] [[TODO](#todo)] [[Thanks](#thanks)] This is the home of my fetch script! This script gathers info
about your system and prints it to the terminal next to an image of your choice! ![1](http://i.imgur.com/bORHxT5.png) ## Features - **Supports Linux, Mac OS X and Windows (Cygwin)!** - If the script isn't working on your system open an issue. - **It's Fast** - The script makes heavy use of bash builtins and string manipulation. - **Display an image next to the info. (or not)** - The script can use your wallpaper, shuffle through a directory or just display an image. - **Highly Customizable** - You can customize almost everything. - See Usage below or lines 23-233 in script - **Take a screenshot at the end.** - It's disabled by default and you can specify the cmd to use with ```--scrotcmd cmd``` at launch or by changing the value of ```$scrotcmd``` in the script. - **Smart crop (or Waifu crop)** - See https://github.com/dylanaraps/fetch/wiki/What-is-Smart-Crop%3F ## Dependencies These are the script's required dependencies - Bash **4.0+** - For those of you on OS X not wanting to update bash, the script
also works with zsh. All you have to do is change the shebang at
the top to ```#!/bin/zsh```. - Text formatting, dynamic image size and padding: tput - Uptime detection: procps or procps-ng These are the script's optional dependencies: - Displaying Images: w3m - You may also need w3m-img - Image Cropping: ImageMagick - Display Wallpaper: feh - Current Song: mpc - Resolution Detection: xorg-xdpyinfo - Window manager detection: wmctrl - This is used as a fallback to parsing ```.xinitrc``` and ```$XDG_CURRENT_DESKTOP```. - Take a screenshot on script finish: scrot - You can change this to another program with a ```--scrotcmd``` and an in script option. ## Installation ### Arch 1. Install ```fetch-git``` from the aur. ### Others 1. Download the latest source at https://github.com/dylanaraps/fetch 2. Make the file executable using chmod. ```chmod +x /path/to/fetch``` 3. Move the script to somewhere in your $PATH or just run it from where it is. ## Usage **NOTE:** For the images to be sized correctly you need to set the ```$font_width``` variable. If you don't know your font width in pixels keep trying values until the image is sized correctly. You can also use the launch flag ```--font_width``` to set it on the fly. You can customize what info to print by editing the info array near the top of the script. The array looks like this: ```sh info=( "gettitle" "underline" "OS: getdistro" "Kernel: getkernel" "Uptime: getuptime" "Packages: getpackages" etc... ) ``` See these comments inside the script for more info: https://github.com/dylanaraps/fetch/blob/master/fetch#L29 ``` usage: ${0##*/} [--colors 1 2 3 4 5] [--kernel "\$\(uname -rs\)"] Info: --exclude "OS: getos" Disable an info line at launch --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 --uptime_shorthand on/off --v Shorten the output of uptime --packages string/cmd Manually set the package count --shell string/cmd Manually set the shell --winman string/cmd Manually set the window manager --use_wmctrl on/off Use wmctrl for a more accurate reading --gtk_shorthand on/off Shorten output of gtk theme/icons --cpu string/cmd Manually set the cpu name --memory string/cmd Manually set the memory --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 5 Change the color of text (title, subtitle, colon, underline, info) --title_color num Change the color of the title --subtitle_color num Change the color of the subtitle --colon_color num Change the color of the colons --underline_color num Change the color of the underlines --info_color num Change the color of the info Text Formatting: --underline on/off Enable/Disable title underline --underline_char char Character to use when underlineing title --line_wrap on/off Enable/Disable line wrapping --bold on/off Enable/Disable bold text --prompt_height num Set this to your prompt height to fix issues with the text going off screen at the top Color Blocks: --color_blocks on/off Enable/Disable the color blocks --block_width num Width of color blocks --block_range start end --v Range of colors to print as blocks Image: --image Image source. Where and what image we display. Possible values: wall, shuffle, /path/to/img, off --shuffledir Which directory to shuffle for an image. --font_width px Used to automatically size the image --image_position Where to display the image: (Left/Right) --split_size num Width of img/text splits A value of 2 makes each split half the terminal width and etc --crop_mode Which crop mode to use Takes the values: normal, fit, fill --crop_offset value Change the crop offset for normal mode. Possible values: northwest, north, northeast, west, center, east, southwest, south, southeast --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 to the top edge of the window --clean Remove all cropped images Screenshot: --scrot Take a screenshot --scrotdir Directory to save the scrot --scrotfile File name of scrot --scrotcmd Screenshot program to launch Other: --clear on/off Whether or not to clear the terminal before printing. --help Print this text and exit ``` ## TODO Here's what's on my todo list - Add Windows resolution detection - Cleanup of info array handling - Imagemagick optimizations - More info outputs. Now that it's easy to customize what's printed and everything is a function we can add optional support for pretty much anything. - Resolution (Done!) - GTK themes (Done!) - Terminal Font - GPU - IP - etc ### Thanks Thanks to: - metakirby5: Providing great feedback as well as ideas for the script. - Screenfetch: I've used some snippets as a base for a few functions in this script. - @jrgz: Helping me test the Mac OS X version. - @xDemonessx: Helping me test the Windows version.