87 lines
3 KiB
Markdown
87 lines
3 KiB
Markdown
# UwUFetch
|
|
|
|
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
|
|
|
|
### 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.
|
|
|
|
### Partial support (Either no ASCII art, or no image is provided)
|
|
|
|
KDE NeOwOn, nixOwOs; Plus FweeBSD, OwOpenBSD and macOwOS; Plus WinyandOwOws.
|
|
|
|
## Building and installation
|
|
|
|
### Requisites
|
|
|
|
- [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.
|
|
|
|
### Via package manager
|
|
|
|
Right now, the package is only available on the AUR:
|
|
|
|
[](https://aur.archlinux.org/packages/uwufetch/)
|
|
|
|
[](https://aur.archlinux.org/packages/uwufetch-git/)
|
|
|
|
### From source
|
|
|
|
Build requisites:
|
|
|
|
- Make
|
|
- A C compiler
|
|
- `pandoc` to compile man pages
|
|
|
|
To install UwUfetch from the source, type these commands in the terminal:
|
|
|
|
```shell
|
|
git clone https://github.com/TheDarkBug/uwufetch.git
|
|
cd uwufetch
|
|
make build
|
|
make man
|
|
sudo make install # for termux, use `make termux`
|
|
```
|
|
|
|
To uninstall:
|
|
|
|
```shell
|
|
cd uwufetch
|
|
sudo make uninstall
|
|
```
|
|
|
|
#### Available Make targets
|
|
|
|
```shell
|
|
make build # builds uwufetch
|
|
make man # builds the manpage (requires pandoc)
|
|
make debug # use for debug
|
|
make install # installs uwufetch (needs root permissons)
|
|
make uninstall # uninstalls uwufetch (needs root permissons)
|
|
make termux # build and install for termux
|
|
make termux_uninstall # uninstall for termux
|
|
```
|
|
|
|
## Images and copyright info
|
|
|
|
### How to use images
|
|
|
|
First of all, you will need `viu`, which you can install by following the [guide](https://github.com/atanunq/viu#installation).
|
|
|
|
`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
|
|
|
|
See [COPYRIGHT.md](https://github.com/TheDarkBug/uwufetch/tree/main/res/COPYRIGHT.md).
|
|
|
|
## License
|
|
|
|
This program is provided under the [GPL-3.0 License](https://github.com/TheDarkBug/uwufetch/LICENSE).
|
|
|
|
## Contributing
|
|
|
|
All kinds of contributions are welcome, but before contributing please read [CONTRIBUTING.md](https://github.com/TheDarkBug/uwufetch/blob/main/CONTRIBUTING.md).
|