readme: revamp and add links to wiki

This commit is contained in:
Kiëd Llaentenn
2019-04-05 15:02:36 -04:00
committed by GitHub
parent ec1a88d505
commit 1731e30e7d
+4 -86
View File
@@ -16,93 +16,11 @@ WinFetch curently supports Windows 10; Windows 7 and Windows 8 have not yet been
While WinFetch does work in the majority of cases, things may break occasionally. Please report all such bugs [here](https://github.com/lptstr/winfetch/issues/new).
## Features
Why you should use WinFetch:
<img src="https://lptstr.github.io/lptstr-images/screenshots/projects/winfetch/computant-hyper.png" alt="winfetch" align="right" height="230px" width="350">
1. **You don't have any other choices.**
2. **WinFetch is tiny.** The whole thing is ~13KB and 400 lines of pure PowerShell, counting comments. Compare that to Neofetch, which is about 280KB and 7,500 lines of code.
Why use Winfetch?
1. You don't have any other choices.
2. **WinFetch isn't bloated.** The whole thing is ~13KB and 400 lines of pure PowerShell, counting comments. Compare that to Neofetch, which is about 280KB and 7,500 lines of code.
3. **No need for the WSL, Cygwin, or MSYS2.** While you need to install the WSL (Windows Subsystem for Linux) to run Neofetch, all you need to use WinFetch is PowerShell 6 (or later), which you probably already have installed.
## Installation
Install WinFetch with [Scoop](https://scoop.sh):
- Make sure that you have the `extras` bucket installed:
```
$ scoop bucket list
main
java
...
extras
```
- Install the `winfetch` package:
```
$ scoop install winfetch
```
You should output like this:
```
Installing 'winfetch' (1.0.0) [64bit]
Loading v1.0.0 from cache
Checking hash of v1.0.0 ... ok.
Extracting dl.7z ... done.
Linking ~\scoop\apps\winfetch\current => ~\scoop\apps\winfetch\1.0.0
Creating shim for 'winfetch'.
'winfetch' (1.0.0) was installed successfully!
```
## Usage
For basic usage, just run `winfetch`:
```
$ winfetch
....,,:;+ccllll billg@MSDOS4
...,,+:; cllllllllllllllllll ------------
,cclllllllllll lllllllllllllllllll OS: Windows 10.0.17134
llllllllllllll lllllllllllllllllll Host: Blah Blaspire 2-12-1-8 BLA-HBLA
llllllllllllll lllllllllllllllllll Package Managers: Scoop & Chocolatey
llllllllllllll lllllllllllllllllll Packages: 512 pkgs of bloat installed
llllllllllllll lllllllllllllllllll Uptime: 30 days 7 hours 2 minutes
CPU: Intel(R) Core(TM) i2-8130U CPU @ 2048GHz
llllllllllllll lllllllllllllllllll GPU: Intel(R) UHD Graphics 620
llllllllllllll lllllllllllllllllll Memory: 1024KiB / 16384KiB
llllllllllllll lllllllllllllllllll Disk: 128MiB / 1024MiB (Windows)
llllllllllllll lllllllllllllllllll
llllllllllllll lllllllllllllllllll
`'ccllllllllll lllllllllllllllllll
`' \\*:: :ccllllllllllllllll
````''*::cll
``
```
###### DISCLAIMER: the true output of Winfetch looks nothing like the above.
#### Configuration
As of version v1.0.0, WinFetch supports custom configuration. Configuration is stored at `$env:XDG_CONFIG_HOME/winfetch/config` (or `~/.config/winfetch/config`).
To generate a default configuration that you can build on, just run:
```
winfetch -genconf
```
The default configuration looks like this:
```powershell
# ===== WINFETCH CONFIGURATION =====
# Add a '#' to any of the lines in
# this file to enable their output.
# $show_os = $false
# $show_computer = $false
# $show_uptime = $false
# $show_cpu = $false
# $show_gpu = $false
# $show_memory = $false
# $show_disk = $false
# $show_pkgs = $false
$show_pwsh = $false
$show_pkgmngr = $false
```
To disable an information field, just remove the # from that line:
```powershell
$show_os = $false # DISABLED
# $show_os = $false # ENABLED!
```
#### More: \[[Dependencies](https://github.com/lptstr/winfetch/wiki/Dependencies)\] \[[Installation](https://github.com/lptstr/winfetch/wiki/Installation)\] \[[Usage](https://github.com/lptstr/winfetch/wiki/Basic-Usage)\]