leenfetch 0.2.4

Fast, minimal, customizable system info tool in Rust (Neofetch alternative)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

# leenfetch — User Commands

## NAME
leenfetch — a fast, customizable system information tool (Neofetch clone)

## SYNOPSIS
```
leenfetch [OPTIONS]
```

## DESCRIPTION
**leenfetch** is a modern, fast, and highly configurable system information tool written in Rust. It displays system information alongside a distribution logo or custom ASCII art, similar to Neofetch, and is designed for both terminal enthusiasts and new users.

Configuration is handled via human-friendly RON files, with detailed comments to guide users through all available options.

leenfetch can also accept **piped input** to render as ASCII art. This allows users to display custom text logos via standard input.

## OPTIONS
- `-v`, `--version`  
  Print version information and exit.
- `-h`, `--help`  
  Show a help message and exit.
- `-l`, `--list-options`  
  List all available configuration options and their possible values.
- `-i`, `--init`  
  Create default configuration files in the user config directory if they do not exist.
- `-r`, `--reinit`  
  Delete existing configuration files and regenerate them with default values.
- `--ascii_distro <DISTRO>`  
  Override the ASCII art distribution for this run (e.g., "arch", "ubuntu", "debian").
- `--ascii_colors <COLORS>`  
  Override the ASCII art color palette for this run (comma-separated list, e.g., "1,2,3,4,5,6,7").
- `--custom_ascii_path <PATH>`  
  Use a custom ASCII art file for this run.
- `terminal stdin`  
  Read ASCII logo content from standard input instead of using built-in or custom files.
  

## CONFIGURATION
leenfetch uses RON files for configuration, typically located at:
```
$XDG_CONFIG_HOME/leenfetch/
~/.config/leenfetch/
```

The main configuration files are:
- **flags.ron**: Controls display options, such as which fields to show, formatting, and output style.
- **toggles.ron**: Enables or disables specific modules (e.g., show/hide GPU, battery, song info, etc.).
- **layout.ron**: Controls the order and grouping of displayed information.

Each config file is heavily commented to explain all available options and their effects.

## EXAMPLES
- `leenfetch`  
  Display system information using the current configuration.
- `leenfetch --ascii_distro debian`  
  Show system info with Debian ASCII art, regardless of detected distro.
- `leenfetch --init`  
  Create default config files if missing.
- `leenfetch --reinit`  
  Delete and regenerate all config files.
- `echo "Rustacean" | leenfetch`  
  Display system info with a piped ASCII logo generated from the input text.
- `fortune | cowsay | leenfetch`  
  fortune generates a random quote.
  cowsay wraps it in a cow speech bubble (ASCII art).
  leenfetch takes piped input and displays it as an ASCII logo.


## ENVIRONMENT
- **XDG_CONFIG_HOME**: Specifies the base directory for user-specific configuration files. Defaults to `~/.config` if not set.

## FILES
- `~/.config/leenfetch/flags.ron`
- `~/.config/leenfetch/toggles.ron`
- `~/.config/leenfetch/layout.ron`

## BUGS
Please report bugs or feature requests at:  
https://github.com/drunkleen/leenfetch/issues

## AUTHOR
Written by DrunkLeen <snape@drunkleen.com>