Coder Social home page Coder Social logo

vfetch's Introduction

vfetch

A simple fetch tool for Linux written in Python.

Dependencies

  • python - For obvious reasons.
  • distro - Python library for getting the machine's Linux distribution.
  • pyxdg - Python library used to get the $XDG_CONFIG_HOME file path.
  • wmctrl-python3 - Python library for the wmctrl tool for X used to get the window manager.

Installation

Download the repository and add a symbolic link to the vfetch.py script in your /usr/bin/ directory:

$ git clone https://github.com/Lorago/vfetch.git
$ sudo ln -s /path/to/vfetch/vfetch.py /usr/bin/vfetch

You can then run the script with a simple

$ vfetch

Configuration

The default configuration is located in the same folder as the vfetch.py file, and is called vfetch.conf. This file should not be removed, moved, or edited. To configure the script, make a copy of the configuration to $XDG_CONFIG_HOME/vfetch/vfetch.conf, which will usually be ~/.config/vfetch/vfetch.conf. If the script does not find a file in this directory it will use the default configuration file. By default the vfetch output will look similar to this:

Options

Note that all option values that are not integers or booleans (true or false) need to be surrounded by quotation marks as the configuration file is a JSON file.

alignMode

The alignMode option sets the data align mode for the output. Acceptable values are spaces and center.

alignSpace

The alignSpace option sets the shortest space between the data names and values when the alignMode is set to spaces. Acceptable values are positive integers.

colorIndex

The colorIndex option sets the index of the terminal color (from 0 to 15) to use for the data names. Acceptable values are 0-15.

displayAscii

The displayAscii option sets whether to display an ascii image at the top left corner of the output. Acceptable values are true and false.

asciiImage

The asciiImage option sets the file path for the ascii image used if the displayAscii option is set to true. Acceptable values are file paths to text files.

iconMode

The iconMode option sets whether to replace the data names with NERD Font icons. Acceptable values are true and false.

lowercase

The lowercase option sets whether to lowercase all text. Acceptable values are true and false.

removeLinux

The removeLinux option sets whether to remove the text Linux (case-independent) from the OS data. Acceptable values are true and false.

kernelFullName

The kernelFullName options sets whether to display the full kernel name or to cut off at the first - (e.g. 5.8.4-arch1-1 becomes 5.8.4). Acceptable values are true and false.

displayArchitecture

The displayArchitecture option sets whether to display the current system architecture after the OS name (e.g. arch linux x86_64 becomes arch linux). Acceptable values are true and false.

displayPackageManager

The displayPackageManager option sets whether to display the package manager in parentheses after the number of packages. Acceptable values are true and false.

data

The data option sets what data to display and in what order. Values are separated by commas. Acceptable values are os, kernel, uptime, packages, wm, shell, terminal, battery, and usage.

offset

The offset option sets the offset of the data from the edge or the ascii image (in both the x- and y-directions). Acceptable values are two different positive integer values (one for the offset in the x-direction, and one for the offset in the y-direction).

vfetch's People

Contributors

amchik avatar dwivedi-ritik avatar lorago avatar samporapeli avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

vfetch's Issues

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.