https://github.com/nighty3098/mfetch
🛠️ A simple fetch tool for Linux written in bash
https://github.com/nighty3098/mfetch
cli fetch mfetch neofetch neofetch-like
Last synced: 9 months ago
JSON representation
🛠️ A simple fetch tool for Linux written in bash
- Host: GitHub
- URL: https://github.com/nighty3098/mfetch
- Owner: Nighty3098
- License: mit
- Created: 2024-08-15T14:39:49.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-04T09:31:21.000Z (10 months ago)
- Last Synced: 2025-09-04T11:33:07.814Z (10 months ago)
- Topics: cli, fetch, mfetch, neofetch, neofetch-like
- Language: Shell
- Size: 8.93 MB
- Stars: 9
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
:herb: System Fetch Tool :herb:
📋 About
- [`🌟 Features`](#-features)
- [`📥 Installation`](#-installation)
- [`🚀 Usage`](#-usage)
- [`🎨 Customization`](#-customization)
- [`🐧 Supported Systems`](#-supported-systems)
- [`🤝 Contributing`](#-contributing)
## 🖼️ Gallery
## 🌟 Features
- **Elegant ASCII Art** - Displays your distro's logo in beautiful colors
- **Comprehensive System Info** - Shows CPU, memory, OS, kernel, uptime and more
- **Nerd Font Icons** - Uses beautiful icons for visual appeal
- **Fully Customizable** - Show only the info you want
- **Responsive Design** - Automatically centers output in your terminal
- **Colorful Output** - 8-color scheme with both foreground and background options
- **Cross-Platform** - Works on Linux and macOS
## 📥 Installation
1. **Prerequisites**:
- Bash 4.0+
- Nerd Fonts installed (for icons)
- Basic GNU tools (lsb_release, free, uptime, etc.)
2. **Installation Options**:
**Git Clone**:
```bash
git clone https://github.com/Nighty3098/mfetch
cd mfetch
bash install.sh
```
## 🚀 Usage
Basic usage:
```bash
mfetch
```
Show specific sections:
```bash
mfetch --cpu --memory --os
```
Show only logo:
```bash
mfetch --logo
```
Show help:
```bash
mfetch --help
```
### Available Options:
| Option | Description |
|--------------|--------------------------------------|
| `--user` | Show user@hostname |
| `--os` | Show OS information |
| `--kernel` | Show kernel version |
| `--uptime` | Show system uptime |
| `--shell` | Show current shell |
| `--wm` | Show window manager |
| `--memory` | Show memory usage |
| `--cpu` | Show CPU information |
| `--colors` | Show color palette |
| `--logo` | Show only ASCII logo |
| `--help` | Show help message |
## 🎨 Customization
### Color Schemes
The application uses the current terminal theme. You can change this in the application code:
```bash
# Foreground Colors
BLACK="\e[1;30m"
RED="\e[1;31m"
GREEN="\e[1;32m"
YELLOW="\e[1;33m"
BLUE="\e[1;34m"
MAGENTA="\e[1;35m"
CYAN="\e[1;36m"
WHITE="\e[1;37m"
# Background Colors
BLACK_BG="\e[7;30m"
RED_BG="\e[7;31m"
...
```
### Adding New Distro Logos
To add support for a new Linux distribution, add a new case to the `raw_ascii_art()` function:
```bash
"Your Distro Name from 'lsb_release -d | cut -f2'")
echo -e "${COLOR_BG} ${RESET_BG}"
echo -e "${COLOR_BG} ASCII ART ${RESET_BG}"
...
;;
```
## 🐧 Supported Systems
The script automatically detects and displays appropriate ASCII art for:
- Arch Linux
- Debian
- Ubuntu
- openSUSE
- Alpine Linux
- Manjaro
- EndeavourOS
- Bedrock Linux
- macOS (multiple versions)
- Plus a generic fallback logo
## 🤝 Contributing
Contributions are welcome! Here's how to help:
1. **Report Bugs**: Open an issue describing the problem
2. **Suggest Features**: Propose new functionality
3. **Add Distro Support**: Submit ASCII art for new distributions
4. **Improve Code**: Submit pull requests for optimizations
### Development Guidelines:
- Maintain consistent coding style
- Keep ASCII art to 6 lines × 16 characters
- Test changes on multiple systems
- Document new features
## 📜 License
MIT License - see [LICENSE](LICENSE) for details.
---
**Enjoy your system insights in style!** ✨