Metadata-Version: 2.1
Name: richfetch
Version: 0.1.0
Summary: A minimal and colorful fetch utility.
Home-page: https://github.com/Rizen54/richfetch/
Author: Satvik Pandey (Rizen54)
Author-email: psatvik54@proton.me
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: certifi==2024.8.30
Requires-Dist: charset-normalizer==3.4.0
Requires-Dist: idna==3.10
Requires-Dist: psutil==6.0.0
Requires-Dist: py-cpuinfo==9.0.0
Requires-Dist: requests==2.32.3
Requires-Dist: termcolor==2.5.0
Requires-Dist: urllib3==2.2.3

<div align="center">
<h1>richfetch</h1>

> A richly customisable fetch utility which provides a ton lot of information. Written in Python.

<img src="images/sample.png" alt="Sample Image" width="300">
</div>

## Capabilities:
`richfetch` displays the following info (in order):

- user@hostname
- os name
- cpu usage %age
- cpu temp
- WM name
- uptime
- ram used/total ram (ram usage %age)
- disk used/total disk (disk usage %age)
- local ip
- public ip (*do not forget to hide this when posting screenshots etc*)

`richfetch` uses [**nerdfonts**](https://www.nerdfonts.com/) to display the symbols. What I use is JetBrains Mono Nerd Font so I know it works. You can try different nerd fonts to see if your works.

## Installation
```bash
git clone https://github.com/Rizen54/richfetch
cd richfetch/
python3 -m pip install -r requirements.txt
chmod +x richfetch.py
sudo cp richfetch.py /usr/local/bin/richfetch
alias richfetch='python3 /usr/local/bin/richfetch'
```

Lastly, add this line to the end of your `.bashrc` or `.zshrc`:

```bash
alias richfetch='python3 /usr/local/bin/richfetch'
```

If you're like me and you use arch linux and install python modules from arch repo. You can do this:
`sudo pacman -Sy python-py-cpuinfo python-psutil python-requests python-termcolor`

## Special Features:
Short note: I'm very happy and proud of these.

- Dynamic colors for OS Symbol, RAM/DISK/CPU Usage and CPU Temp
- Have a separate emoji for each color in the color ribbon!
- Local and public IPs (Public IP is disabled by default, you can enable it by simply un-commenting a line)
- Nerd Fonts for logos instead of ASCII art (minimalism is they key.)
- The ease of customizing it.

## Stars
Please support me by giving a star to this repo.
> Small click for a man, giant star for another.
