mfetch 0.3.0

📦 memory-focused system info tool written in Rust.
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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

<h1 align="center">📦 mfetch v0.0.3</h1>

<p align="center">
  <a href="https://github.com/xdearboy/mfetch/blob/master/LICENSE">
    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License" />
  </a>
  <a href="https://crates.io/crates/mfetch">
    <img src="https://img.shields.io/crates/v/mfetch.svg" alt="mfetch crate version" />
  </a>
  <a href="https://github.com/xdearboy/mfetch/stargazers">
    <img src="https://img.shields.io/github/stars/xdearboy/mfetch.svg" alt="GitHub stars" />
  </a>
  <a href="https://github.com/xdearboy/mfetch/network">
    <img src="https://img.shields.io/github/forks/xdearboy/mfetch.svg" alt="GitHub forks" />
  </a>
  <a href="https://aur.archlinux.org/packages/mfetch">
    <img src="https://img.shields.io/badge/AUR-mfetch-green.svg" alt="AUR package" />
  </a>
</p>

## Features

- lightweight and fast memory information tool written in rust
- colorful and easy-to-read terminal output using the colored crate
- displays total and available system memory from /proc/meminfo
- detailed info about memory modules (dimms) via dmidecode
- shows slot, size, speed, type, bank locator, ecc status, and configured voltage
- minimal dependencies and straightforward to build
- requires root privileges to access detailed hardware info via dmidecode

## Preview

```bash

  mfetch
  github.com/xdearboy/mfetch
  ──────────────────────────────

  memory
    total:       15.54 gb
    available:   9.02 gb
    usage:       ||||||......... 41.9%

  modules

    ○ slot dimm 1 (spd)
      🏭 maker:     crucial technology
      💎 dram:      micron technology
      🏷️  part:      bl8g32c16u4bl.m8fe
      ⏱️  timings:   19-19-19-43
      📦 size:      8 gb
      ⚡ speed:     3733 mt/s
      🔌 voltage:   1.2 v

    ○ slot dimm 1 (spd)
      🏭 maker:     crucial technology
      💎 dram:      micron technology
      🏷️  part:      bl8g32c16u4bl.m8fe
      ⏱️  timings:   19-19-19-43
      📦 size:      8 gb
      ⚡ speed:     3733 mt/s
      🔌 voltage:   1.2 v

```

### ⚠️ disclaimer: spd vs real-time timings

please note that `mfetch` displays **spd timings**, not the active (real-time) timings from your bios.

* **what does it mean?**: you are seeing the "factory passport" data burned into the ram chip by the manufacturer (crucial, micron, samsung, etc.).
* **why not real timings?**: active timings (like xmp, docp, or manual overclocking) are stored in the cpu's memory controller. accessing them requires complex, hardware-specific drivers that vary for every cpu generation.
* **the result**: if you tightened your timings in the bios, `mfetch` will still show the default factory profiles fetched from the spd eeprom.



### 🛠 enabling spd support
if the `modules` section is empty, your system lacks access to the i2c bus. follow these steps:

1. **load the drivers** (for ddr4/ddr5):
   ```bash
   sudo modprobe i2c-dev
   sudo modprobe ee1004

## Installation

Build from source:

```bash
cargo build --release
```
Or install via AUR (once package is added):

```bash
yay -S mfetch
```

## Usage
```bash
# Requires root privileges to see detailed memory module info
sudo mfetch
```

## License
MIT License. See LICENSE file for details.