Giter Club home page Giter Club logo

screenfetch's Introduction

screenFetch - The Bash Screenshot Information Tool

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?

Arch Linux

  1. Install screenfetch from the official repositories or screenfetch-git from the AUR. That's it!

Mageia

  1. Install screenfetch from the official repositories with urpmi or rpmdrake. e.g.: urpmi screenfetch

Mac

  1. Run brew install screenfetch after installing Homebrew

Gentoo or Sabayon

  1. Emerge screenfetch from portage using emerge screenfetch
  2. Sabayon users can install screenfetch from entropy using equo install screenfetch

Ubuntu (>14.04) and Debian (stable/testing/unstable)

  1. Install: apt-get install screenfetch
  2. There is also a PPA for Ubuntu located at https://launchpad.net/%7Edjcj/+archive/ubuntu/screenfetch

FreeBSD

  1. screenfetch can be installed by using the ports system.

Fedora (21 or later)

  1. Install it with yum running: yum install screenfetch

Others

  1. Download the latest source at https://github.com/KittyKatt/screenFetch
  2. In a terminal, make the file executable by doing the following: chmod +x /path/to/screenfetch/screenfetch-dev
  3. Then, either keep it there, or move it to somewhere in your $PATH to make it available without having to use the full path to the script.

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"'
  -n                 Do not display ASCII distribution logo.
  -N                 Strip all color from output.
  -t                 Truncate output based on terminal width (Experimental!).
  -p                 Output in portrait mode, with logo above info.
  -s(m)              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
                     informations 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.
  -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 [email protected] or you can connect to Rizon and reach me at irc://irc.rizon.net/screenFetch

screenfetch's People

Contributors

algmyr avatar benwaffle avatar causes- avatar cgoldberg avatar crahan avatar darealshinji avatar felixonmars avatar forostm avatar hsiktas avatar iggyvolz avatar jadematrix avatar jxthrx avatar kaelanduck avatar kittykatt avatar ktgee avatar kwpolska avatar maman avatar mxtm avatar neuschaefer avatar osiux avatar panaino avatar rnhmjoj avatar spaghetti2514 avatar v0idpwn avatar valeriangalliat avatar vpooley avatar wille avatar woodruffw avatar x11tete11x avatar zanthas avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.