goGoFetch/README.md
koru e2acd2f6dc
Update README.md, update stats, update ignore lists
- Update formatting for README.md
- Update stats using .gitattributes
- Remove obsolete entries from .gitignore
- Use Git LFS for binary files (images), require re-commit binary assets
2026-06-25 19:00:26 +03:00

87 lines
1.5 KiB
Markdown

# goGoFetch
Fetch tool for Linux written in Go with image support
![goGoFetch: screenshot](assets/screenshot.png "fetch")
## Usage
```sh
gogofetch
# show custom image
gogofetch -l path
# If the custom image is a GIF, it will animate and gogofetch will keep running until you stop it (Ctrl+C).
# to show custom image and set custom width:
gogofetch -l path -w 250
# place logo on the left (default) or right:
gogofetch -p left
gogofetch -p right
# help
gogofetch -h
```
> [Note!]
> Configuration file is created at `~/.config/gogofetch/config.toml`.
## Install
### Arch Linux
```sh
yay -S gogofetch-git
```
Also `chafa` is dependency for goGoFetch
### NixOS
```nix
# add to inputs
goGoFetch.url = "git+https://codeberg.org/nekohepott/goGoFetch";
# add to packages (system-wide or home-manager)
environment.systemPackages = [
inputs.goGoFetch.packages.${pkgs.system}.default
];
# or
home.packages = [
inputs.goGoFetch.packages.${pkgs.system}.default
];
```
```sh
# run rebuild and then you can run fetch
gogofetch
```
## Build
### Linux
```sh
git clone https://codeberg.org/nekohepott/goGoFetch && cd goGoFetch
go build -o gogofetch ./src
./gogofetch
```
### Nix Flake
Credits to `melvi` for Nix flake.
```sh
git clone https://codeberg.org/nekohepott/goGoFetch && cd goGoFetch
nix build
nix run --refresh git+https://codeberg.org/nekohepott/goGoFetch
```
## Screenshots
![goGoFetch: alacritty screenshot](assets/alacritty.png "alacritty")
![goGoFetch: foot screenshot](assets/foot.png "foot")
![goGoFetch: necrokall screenshot](assets/xterm.png "xterm")