goGoFetch/README.md

92 lines
1.7 KiB
Markdown

# Fetch tool for linux written in Go with image support
![Fetch image](assets/screenshot.png "fetch")
# Install
you can get gogofetch on AUR!
```bash
yay -S gogofetch-git
```
also chafa is dependency for gogofetch
# Usage
basic usage:
```bash
gogofetch
```
to show custom image :
```bash
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:
```bash
gogofetch -l path -w 250
```
to place logo on the left (default) or right:
```bash
gogofetch -p left
gogofetch -p right
```
to show help message:
```bash
gogofetch -h
```
config file is created at `~/.config/gogofetch/config.toml`, all parameters are described in config file.
# Nix
credits to melvi for flake
to build with nix:
```bash
git clone https://codeberg.org/nekohepott/goGoFetch
cd goGoFetch
nix build
```
to run with nix:
```
nix run --refresh git+https://codeberg.org/nekohepott/goGoFetch
```
to install with nixos:
1. Add to inputs:
```
goGoFetch.url = "git+https://codeberg.org/nekohepott/goGoFetch";
```
2. 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
];
```
3. Run rebuild and then you can run fetch with *gogofetch* command
# Build
to build:
```
git clone https://codeberg.org/nekohepott/goGoFetch
cd goGoFetch
go build -o gogofetch ./src
```
and run:
```
./gogofetch
```
# Some screenshots
![alacritty](assets/alacritty.png "alacritty") alacritty
![foot](assets/foot.png "foot") foot
![necrokall](assets/xterm.png "xterm") xterm