Skip to content

A ultra-minimal system fetch tool that displays your username, hostname, OS, kernel, shell, window manager, and terminal in a sleek ASCII format for Linux.

License

Notifications You must be signed in to change notification settings

Gur0v/zeptofetch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

zeptofetch 🚀

The Ultra-Minimal System Information Fetch Tool

GitHub License GitHub Stars Linux Support

Key FeaturesInstallationConfigurationBenchmarksContributing

🎯 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.

About

A ultra-minimal system fetch tool that displays your username, hostname, OS, kernel, shell, window manager, and terminal in a sleek ASCII format for Linux.

Resources

License

Stars

Watchers

Forks

Packages

No packages published