rewrite some of the README

This commit is contained in:
Michał Litwin 2021-06-09 17:16:36 +02:00
parent 5cd38bc202
commit 185d6d4cc1

View file

@ -1,26 +1,26 @@
# UwUFetch # UwUFetch
A meme system info tool for (almost) all your Linux/Unix-based systems, based on nyan/UwU trend on r/linuxmasterrace. A meme system info tool for (almost) all your Linux/Unix-based systems, based on the nyan/UwU trend on r/linuxmasterrace.
## Currently supported distros ## Currently supported distros
#### Full support (Both Ascii art + images are provided for the given distribution) ### Full support (Both ASCII art + images are provided for the given distribution)
Nyalpine, Nyarch Linuwu, Nyartix Linuwu, Debinyan, endOwO, Fedowa, GentOwO, GnUwU gUwUix, Miwint, Myanjawo, OwOpenSUSE, Pop OwOs, RaspNyan, Swackwawe, sOwOlus, UwUntu, and OwOid; Plus Nyandroid. Nyalpine, Nyarch Linuwu, Nyartix Linuwu, Debinyan, endOwO, Fedowa, GentOwO, GnUwU gUwUix, Miwint, Myanjawo, OwOpenSUSE, Pop OwOs, RaspNyan, Swackwawe, sOwOlus, UwUntu, and OwOid; Plus Nyandroid.
#### Partial support (Either no Ascii art, or no image is provided) ### Partial support (Either no ASCII art, or no image is provided)
KDE NeOwOn, nixOwOs; Plus FweeBSD, OwOpenBSD and macOwOS; Plus WinyandOwOws. KDE NeOwOn, nixOwOs; Plus FweeBSD, OwOpenBSD and macOwOS; Plus WinyandOwOws.
## Building and installation ## Building and installation
#### Requisites ### Requisites
[viu](https://github.com/atanunq/viu) to use images instead of ascii art. - [viu](https://github.com/atanunq/viu) to use images instead of ascii art (see [How to use images](#how-to-use-images) below)
[lshw](https://github.com/lyonel/lshw) to get gpu info. - [lshw](https://github.com/lyonel/lshw) to get GPU info.
##### Via package manager ### Via package manager
Right now, the package is only available on the AUR: Right now, the package is only available on the AUR:
@ -28,13 +28,13 @@ Right now, the package is only available on the AUR:
[![uwufetch-git](https://img.shields.io/aur/version/uwufetch-git?color=1793d1&label=uwufetch-git&logo=arch-linux&style=for-the-badge)](https://aur.archlinux.org/packages/uwufetch-git/) [![uwufetch-git](https://img.shields.io/aur/version/uwufetch-git?color=1793d1&label=uwufetch-git&logo=arch-linux&style=for-the-badge)](https://aur.archlinux.org/packages/uwufetch-git/)
##### Via source ### From source
Building requisites: Build requisites:
- Make - Make
- A C compiler - A C compiler
- `pandoc` to compile man pages - `pandoc` to compile man pages
To install UwUfetch from the source, type these commands in the terminal: To install UwUfetch from the source, type these commands in the terminal:
@ -43,7 +43,7 @@ git clone https://github.com/TheDarkBug/uwufetch.git
cd uwufetch cd uwufetch
make build make build
make man make man
sudo make install sudo make install # for termux, use `make termux`
``` ```
To uninstall: To uninstall:
@ -53,7 +53,7 @@ cd uwufetch
sudo make uninstall sudo make uninstall
``` ```
##### Make options: #### Available Make targets
```shell ```shell
make build # builds uwufetch make build # builds uwufetch
@ -69,17 +69,19 @@ make termux_uninstall # uninstall for termux
### How to use images ### How to use images
First at all you need `viu`, to install it follow the [guide](https://github.com/atanunq/viu#installation). First of all, you will need `viu`, which you can install by following the [guide](https://github.com/atanunq/viu#installation).
Images are working in almost every terminal, for a better experience i recommend [kitty](https://github.com/kovidgoyal/kitty)
`viu` supports [kitty](https://github.com/kovidgoyal/kitty) and [iTerm](https://iterm2.com/)'s image protocols.
If not supported by the current terminal, `viu` uses the fallback Unicode half-block mode (images will look "blocky"), that is the case in many terminal emulators (gnome-terminal, Konsole, etc.). See also: [viu's README](https://github.com/atanunq/viu#description).
### For copyright and logos info ### For copyright and logos info
<font size=2>[COPYRIGHT.md](https://github.com/TheDarkBug/uwufetch/tree/main/res/COPYRIGHT.md)</font> See [COPYRIGHT.md](https://github.com/TheDarkBug/uwufetch/tree/main/res/COPYRIGHT.md).
## License ## License
This program is provided under the [GPL-3.0 License](https://github.com/TheDarkBug/uwufetch/LICENSE). This program is provided under the [GPL-3.0 License](https://github.com/TheDarkBug/uwufetch/LICENSE).
# Contributing ## Contributing
All kind of contribution are welcome, but before contributing please read [CONTRIBUTING.md](https://github.com/TheDarkBug/uwufetch/blob/main/CONTRIBUTING.md). All kinds of contributions are welcome, but before contributing please read [CONTRIBUTING.md](https://github.com/TheDarkBug/uwufetch/blob/main/CONTRIBUTING.md).