ponyfetch/README.md

56 lines
2.2 KiB
Markdown
Raw Normal View History

2022-12-02 19:51:10 +01:00
<div align="center">
<img
2022-12-02 20:06:27 +01:00
src="https://i.postimg.cc/bwmFtxyp/fd-1.png" style="height: 220px; width: 340px;"
2022-12-02 19:51:10 +01:00
/>
</div>
<p align="center">
<img src="https://img.shields.io/github/contributors/Atsukoro1/ponyfetch?color=blue&style=for-the-badge"/>
<img src="https://img.shields.io/github/issues/Atsukoro1/ponyfetch?style=for-the-badge"/>
<img src="https://img.shields.io/badge/Made%20with-Rust-blue?style=for-the-badge"/>
</p>
2022-12-02 20:06:27 +01:00
<p align="center">
2022-12-02 20:21:43 +01:00
A cross-platform command-line interface (CLI) tool written in Rust</br> to display system information in an aesthetically pleasing and entertaining manner.
2022-12-02 20:06:27 +01:00
</p>
2022-12-02 20:45:21 +01:00
## ✨ Demo
`Ponyfetch` provides an aesthetically pleasing, colorful display of important system information, complete with charming ponies.
<img src="https://i.postimg.cc/MK6Fy3tP/konecne.gif" style="height: 300px; width: 570px;" alt="demo">
## ⚡ Installing
If you don't want to compile this tool by yourself, it's possible to just download current already prebuilt build [right here](https://github.com/Atsukoro1/ponyfetch/releases).
## 🔨 Compiling
Make sure you have [rust compiler and build tools](https://www.rust-lang.org/tools/install) installed.
I've made it easy for you, just cd into project folder and run this shell script.
- 🐧 On Linux
```sh
chmod +x ./install.sh && sudo ./install.sh
```
- 🖥️ On Windows
2022-12-02 20:57:30 +01:00
```txt
2022-12-02 20:45:21 +01:00
(WIP) Ponyfetch is still not available on Windows
```
- 🍎 On Mac
2022-12-02 20:57:30 +01:00
```txt
2022-12-02 20:45:21 +01:00
(WIP) Ponyfetch was never tested on Mac and it's stability can't be guaranteed.
```
2022-12-02 20:57:30 +01:00
## 📚 Contributing
#### 🐎 Adding new ponies
If you wish to add new ponies to the project, please adhere to the following guidelines in order to maintain the project's structural integrity and functionality. The two main distinguishing features of these ponies are their size and style (e.g. Hat or Wings). Refer to the current pony ASCII art to determine the size of your new pony. If your pony is larger than the others, use the format `<ponyname>_large`. If the size is the same as an existing pony, find a visible difference between your pony and the current one, and name it `<ponyname>_<difference>_large`. If you still don't know, open an issue and discuss it with members of our team.
- 🖥️ Modifying & Adding code