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, <br > your distro's logo or any ascii art of your choice!

• Screenshots
• Features
• Dependencies
• Installation
• Post Install
• Usage
• Frequently Asked Questions
• Issues and Workarounds
• Thanks

• Supports Linux, Mac OS X, BSD (FreeBSD, OpenBSD & NetBSD) and Windows (Cygwin)
• Display a full color image, a file containing ascii art or your distro's logo in ascii next to the info.
• The script is fast. We use bash builtins wherever possible and only spawn external processes when necessary.
• Take a screenshot of your desktop on script finish.
• Customize which info is displayed, where it's displayed and when it's displayed.
  • See this wiki page

• Bash 4.0+
• xprop [1]
• procps-ng
  • Not required on OS X

• Displaying images: w3m-img [2] [3] or iTerm2 [4]
• Thumbnail creation: imagemagick

• Wallpaper: feh, nitrogen or gsettings
• Current Song: mpc or cmus
• Resolution: xorg-xdpyinfo
• Screenshot: scrot [5]

[1] See #79 about why this is now a required dependency.

[2] w3m-img is sometimes bundled together with w3m.

[3] Image support only works in certain terminal emulators. The script will fallback to ascii mode on<br > terminal emulators that don't support the xterm escape sequences we're using for image sizing.

[4] You can enable the iTerm2 image backend by using the launch flag --image_backend iterm2 or by<br > changing the config option $image_backend to iterm2.

[5] You can use the launch flag --scrot_cmd or change the config option $scrot_cmd to your screenshot<br > program's cmd and fetch will use it instead of scrot.

Those using a git version of fetch should check this page after<br > updating, this page lists any breaking changes that were made and<br > how you can workaround them.

https://github.com/dylanaraps/fetch/wiki/Following-HEAD

1. Install fetch-git from the aur.

1. Add the 3rd party repo
   • layman -o https://gist.githubusercontent.com/z1lt0id/24d45b15800b98975260/raw/2fdf6645cdc3c1ca0b0af83a7bf8f86598e386ae/fs0ciety.xml -f -a fs0ciety
2. Sync the repos
   • layman -S
3. To enable w3m and scrot support, enable the appropriate flags.
   • echo "x11-apps/fetch" >> /etc/portage/package.use
4. Install the package
   • emerge -a x11-apps/fetch

1. Install git and the git ports(8) driver
   • sudo prt-get depinst git
2. Add the 3rd party repo
   • sudo wget -O /etc/ports/arcetera.git https://git.io/vgNJ6
3. Sync the repos
   • sudo ports -u
4. Install the package
   • sudo prt-get depinst fetch

1. Download the latest source at https://github.com/dylanaraps/fetch
2. Run make install inside the script directory to install the script.
   • El Captain: PREFIX=/usr/local make install

NOTE: Fetch can be uninstalled easily using make uninstall.

NOTE: Fetch can also be run from any directory like a normal script,<br > you'll just be missing the ascii distro logos and automatic config file creation.

Fetch will by default create a config file at $HOME/.config/fetch/config and this file<br > contains all of the script's options/settings. The config file allows you to keep your<br > customizations between script versions and allows you to easily share your customizations<br > with other people.

You can launch the script without a config file by using the flag --config none and you can<br > specify a custom config location using --config path/to/config.

If your shell prompt's height is greater than 1 line high, you'll need to change a config<br > option to avoid issues with the top lines in the script output getting cut off. Set the variable<br > $prompt_height to your shell prompt's height in lines or use the launch flag --prompt_height.

In the config file there's a function that allows you to customize all of the info that<br > gets displayed.

Here's what you can do:

• Add new info lines
• Change the ordering of the info
• Remove unwanted info lines
• Use bash syntax to control when info gets displayed

See this wiki page that goes more in-depth about it:

https://github.com/dylanaraps/fetch/wiki/Customizing-Info

If you don't want to use the config file you can customize almost everything using launch flags!

Here's what my fetch alias looks like:

alias fetch2="fetch \
--block_range 1 8 \
--line_wrap off \
--bold off \
--uptime_shorthand on \
--gtk_shorthand on \
--colors 4 1 8 8 8 7 \
"

usage: fetch --option "value" --option "value"

Info:
--disable infoname          Allows you to disable an info line from appearing
                            in the output.
                            NOTE: You can supply multiple args. eg.
                            'fetch --disable cpu gpu disk shell'
--osx_buildversion on/off   Hide/Show Mac OS X build version.
--os_arch on/off            Hide/Show Windows architecture.
--speed_type type           Change the type of cpu speed to display.
                            Possible values: current, min, max, bios,
                            scaling_current, scaling_min, scaling_max
                            NOTE: This only support Linux with cpufreq.
--kernel_shorthand on/off   Shorten the output of kernel
--uptime_shorthand on/off   Shorten the output of uptime (tiny, on, off)
--gpu_shorthand on/off      Shorten the output of GPU
--gtk_shorthand on/off      Shorten output of gtk theme/icons
--gtk2 on/off               Enable/Disable gtk2 theme/icons output
--gtk3 on/off               Enable/Disable gtk3 theme/icons output
--shell_path on/off         Enable/Disable showing \$SHELL path
--shell_version on/off      Enable/Disable showing \$SHELL version
--battery_num num           Which battery to display, default value is 'all'
--battery_shorthand on/off  Whether or not each battery gets its own line/title
--ip_host url               Url to ping for public IP
--song_shorthand on/off     Print the Artist/Title on seperate lines
--birthday_shorthand on/off Shorten the output of birthday
--birthday_time on/off      Enable/Disable showing the time in birthday output

Text Colors:
--title_color num           Change the color of the title
--at_color num              Change the color of "@" in 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_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     Range of colors to print as blocks


Image:
--image type                Image source. Where and what image we display.
                            Possible values: wall, shuffle, ascii,
                            /path/to/img, off
--size px                   Size in pixels to make the image.
--image_backend w3m/iterm2  Which program to use to draw images.
--shuffle_dir path/to/dir   Which directory to shuffle for an image.
--image_position left/right Where to display the image: (Left/Right)
--crop_mode 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. This only works with w3m.
--yoffset px                How close the image will be to the top edge of the
                            window. This only works with w3m.
--gap num                   Gap between image and text.
                            NOTE: --gap can take a negative value which will
                            move the text closer to the left side.
--clean                     Remove all cropped images


Ascii:
--ascii value               Where to get the ascii from, Possible values:
                            distro, /path/to/ascii
--ascii_color num           Color to print the ascii art
--ascii_distro distro       Which Distro\'s ascii art to print


Stdout:
--stdout info info          Launch fetch in stdout mode which prints the info
                            in a plain-text format that you can use with
                            lemonbar etc.
--stdout_title on/off       Hide/Show the title in stdout mode.
--stdout_separator string   String to use as a separator in stdout mode.
--stdout_subtitles on/off   Hide/Show the subtitles in stdout mode.


Screenshot:
--scrot /path/to/img        Take a screenshot, if path is left empty the screen-
                            shot function will use \$scrot_dir and \$scrot_name.
--scrot_cmd cmd             Screenshot program to launch

Other:
--config /path/to/config    Specify a path to a custom config file
--config none               Launch the script without a config file
--help                      Print this text and exit

Launching the script with --ascii distro or setting ascii="distro" and image="ascii" <br > inside the config file will launch the script in "screenfetch mode". The script will<br > display your distro's ascii next to the info, exactly like screenfetch.

NOTE: If you don't have w3m-img or imagemagick installed screenfetch mode will be<br > used automatically

It's hard to add support for other wallpaper setters as they don't provide a way of <br > getting the current wallpaper from the cli.

If your wallpaper setter does provide a way of getting the current wallpaper or you<br > know where it's stored then adding support won't be a problem!<br >

There are a few ways to fix this.

• Disable line wrapping with line_wrap=off in the script or with the launch flag --line_wrap off
• The uptime and gtk info lines each have a shorthand option that makes their output smaller. You can <br > enable them by changing these variables or using these flags.

# Config options
uptime_shorthand="on"
gtk_shorthand="on"
gpu_shorthand="on"
birthday_shorthand="on"

# Launch flags
--uptime_shorthand on
--gtk_shorthand on
--gpu_shorthand on
--birthday_shorthand on

• Edit the config to make the subtitles shorter
• Resizing the terminal so that the lines don't wrap.

The easiest way to fix this is to change the value of --gap or $gap<br > to a negative value. For example --gap -10 will move the text 10 spaces to the left.

If your lspci | grep "VGA" output looks like this:

01:00.0 VGA compatible controller: NVIDIA Corporation Device 1401 (rev a1)

Instead of this:

01:00.0 VGA compatible controller: NVIDIA Corporation GM206 [GeForce GTX 960] (rev a1)

Then you're affected by the issue.

This is caused by your /usr/share/misc/pci.ids\* files being outdated and you can fix it<br > by running this command as root.

sudo update-pciids

Thanks to:

• Screenfetch:
  • I've used some snippets as a base for a few functions in this script.
  • I've used the ascii art from here.
• metakirby5: Providing great feedback as well as ideas for the script.
• @jrgz: Helping me test the Mac OS X version.
• @xDemonessx: Helping me test the Windows version.
• @tudurom: Helping me test everything.
• Everyone else who has helped test the script, given feedback or reported bugs.