Skip to content

Latest commit

 

History

History
113 lines (76 loc) · 4.27 KB

README.md

File metadata and controls

113 lines (76 loc) · 4.27 KB

zeptofetch 🚀

The Ultra-Minimal System Information Fetch Tool

GitHub License GitHub Stars Linux Support

Key Features • Installation • Configuration • Benchmarks • Contributing

🎯 Overview

zeptofetch is a fast, minimalist system information retrieval tool designed for users who appreciate performance and simplicity. With its microscopic footprint, zero external dependencies and a modular codebase, zeptofetch provides the fastest way to display essential system information while maintaining elegant output formatting. The source code is organized into easily modifiable components, making it simple to customize the information displayed or add new features.

📸 Preview

zeptofetch Preview

Example output on Bazzite Linux with the stock color scheme.

The line beneath the username and hostname (--------------) is now dynamically "adjusted" to match the exact length since the release of zeptofetch v1.0-rc2

✨ Key Features

  • Microscopic Footprint: Entire binary weighs less than 50KB
  • Zero Dependencies: Completely self-contained implementation
  • Native Performance: Leverages CPU-specific optimizations*
  • Instant Display: Sub-20ms information retrieval
  • Customizable Output: Easy color scheme modification
  • Resource Efficient: Minimal CPU and memory usage

🛠 Installation

Pre-built Binaries

Download the pre-built binary from the releases page.

*These are compiled with -mtune=generic for maximum compatibility across different CPU architectures. Before you want to benefit from CPU-specific optimizations which you can get by compiling from source, check out the benchmarks.

From Source

# Clone the repository
git clone https://github.com/Gur0v/zeptofetch
cd zeptofetch

# Build with optimal settings (includes CPU-specific optimizations)
make

# Install system-wide (optional)
sudo make install

🖥 Compatibility

System Requirements

  • Operating System: GNU/Linux & GNU Linux* (both are supported), FreeBSD (requires source patching)
  • Kernel Version: 4.19 or newer
  • Architecture: x86_64
  • Memory: < 1MB RAM

*Non-GNU Linux is supported (Void, Alpine, Gentoo, etc) but Android is NOT supported.

🎨 Configuration

Color Customization

Edit config.h to personalize your output appearance:

// Default color scheme
#define COLOR_RESET "\033[0m"     // Reset to terminal default
#define COLOR_1     "\033[1;34m"  // Bright blue (headers)
#define COLOR_2     "\033[1;37m"  // Bright white (values)
#define COLOR_3     "\033[1;38;5;208m"  // Bright orange (accents)

📊 Performance Benchmarks

Test Environment

  • System: Arch Linux, Alpine Linux Container (for Musl)
  • Kernel: 6.12.6-2-cachyos
  • Processor: AMD Ryzen 5 5600 (6C/12T @ 4.47 GHz)

Compilation Configurations

Config Distribution Avg Time Binary Size
1 From Source 10.2 ms 20K
2 Glibc Binary 10.1 ms 20K
3 Musl Binary 12.7 ms 16K
4 Static Binary 9.9 ms 68K

Benchmarks from zeptofetch v1.0-rc2

🤔 Why "Zepto"?

The name "Zepto" comes from the SI prefix for 10⁻²¹ (one sextillionth), reflecting our commitment to minimal resource usage:

  • ~83x smaller than fastfetch
  • ~23x smaller than neofetch

🤝 Contributing

While I'm not currently accepting direct code contributions, I always welcome:

  • Bug reports
  • Feature suggestions

Please use the GitHub issues system for all contributions.

📝 License

zeptofetch is licensed under the GPL-3.0 License.