🧠 infors

A fast, minimal, and customizable system information tool built in Rust — your alternative to Neofetch, for real power users.

💬 Feedback & Issues

Found a bug? Got a feature idea?
Head over to the issues!

📚 Table of Contents

• 🧠 infors - A fast, minimal, and customizable system information tool built in Rust — your alternative to Neofetch, for real power users.
  • 💬 Feedback & Issues
  • 📚 Table of Contents
  • 📸 Screenshots
  • 🚀 Features
  • ▨ Packaging Status
  • 📦 Installation
    • Install on Arch Linux (via AUR)
    • Install on Debian / Ubuntu (via .deb)
    • Install on Fedora / RHEL (via .rpm)
    • Install on Windows (via .zip)
    • Install from crates.io
    • 🛠️ Manual Installation (Build from Source)
  • 📥 Using Piped Input
  • ⚙️ Configuration
    • flags section
    • modules array
    • How to Edit
  • 🎯 Roadmap
  • 🤝 Contributing
  • ☕ Support infors
  • 📄 License
  • 💡 Inspiration

📸 Screenshots

🚀 Features

• ⚡ Blazing fast startup thanks to Rust
• 🎨 Customizable output layout with colorized terminal output
• 🧩 Modular design — enable or disable components via config
• 💾 Smart defaults but easily extendable
• 📦 Detects installed packages, shell, GPU, DE/WM, and more
• 🖼️ Custom ASCII art support and override via config
• 🎨 Supports theme-based color profiles (ascii_colors=distro, etc.)
• 🔌 Single JSONC config: ~/.config/infors/config.jsonc
• 🧵 Accepts piped ASCII input — use fortune | cowsay | infors for dynamic text logos

📦 Installation

Install on Arch Linux (via AUR)

If you're on Arch Linux or an Arch-based distribution (like Manjaro), you can install infors from the AUR using an AUR helper like yay:

yay -S infors

or

git clone https://aur.archlinux.org/infors.git
cd infors
makepkg -si

Install on Debian / Ubuntu (via .deb)

COMING SOOON

Install on Fedora / RHEL (via .rpm)

COMING SOOON

Install on Windows (via .zip)

If you're on Windows, download the latest .zip from the GitHub Releases:

Install from crates.io

Make sure you have Rust & Cargo installed:

cargo install infors

After that, just run:

infors

If you hit issues with PATH, try adding ~/.cargo/bin to your shell:

export PATH="$HOME/.cargo/bin:$PATH"

🛠️ Manual Installation (Build from Source)

git clone https://github.com/artificialxdev/infors.git
cd infors
cargo build --release

Add to PATH:

cp target/release/infors~/.local/bin/

Then run:

infors

📥 Using Piped Input

infors can accept piped input to use as the ASCII logo.

This allows you to create dynamic, fun logos on the fly using other command-line tools.

Examples:

echo "Rustacean" | infors

fortune | cowsay | infors

infors will detect piped input via stdin and render the ASCII art above your system information.

If no piped input is provided, it will fall back to your configured or auto-detected ASCII art.

⚙️ Configuration

On first run, infors writes a single config.jsonc file to your configuration directory:

# Linux
~/.config/infors/config.jsonc

# Windows
C:\Users\<username>\AppData\Roaming\infors\config.jsonc

The file uses JSON with comments (JSONC), so you can keep inline explanations next to your settings. It combines the previous trio of files into a single document with clear sections:

• flags — Display and formatting toggles.
• modules (alias layout) — Output order, headings, and custom rows.
• (optional) logo — Override ASCII art source or padding. Omitted keys fall back to defaults.

flags section

The flags object fine-tunes how each block is rendered. Values shown below match the generated defaults; unset keys fall back to the same defaults internally.

ℹ️ Piped input (for example fortune | cowsay | infors) replaces the ASCII logo regardless of ascii_distro or custom_ascii_path.

Here is a compact example that shortens durations and hides temperature and refresh-rate extras:

{
  "flags": {
    "uptime_shorthand": "tiny",
    "cpu_show_temp": false,
    "refresh_rate": false,
    "package_managers": "on"
  }
}

logo section (optional)

Use the logo object to point to custom ASCII art or adjust how the bundled ASCII art is padded. When type is "file" the source path behaves just like custom_ascii_path.

{
  "logo": {
    "type": "file",
    "source": "~/.config/infors/branding/about.txt",
    "padding": { "top": 2, "right": 6, "left": 0 }
  }
}

modules array

The modules array (also accepted as layout) controls rendering order. Entries can be a literal string ("break" inserts an empty spacer) or an object describing a module. Objects accept a type (collector name such as titles, distro, os_age, uptime, etc.) and optional properties like key for the label or format for custom text.

{
  "modules": [
    "break",
    { "type": "custom", "format": "== System ==" },
    { "type": "titles", "key": "User" },
    { "type": "distro", "key": "Distro" },
    { "type": "cpu", "key": "CPU" },
    { "type": "memory", "key": "Memory" },
    { "type": "colors", "key": "" }
  ]
}

Rearrange, duplicate, or remove entries to customize your output. Insert "break" wherever you want an empty spacer line.

How to Edit

• Open config.jsonc in your favorite text editor.
• Read the inline comments for a full explanation of every option.
• Change values as you like, save, and re-run infors to see your changes.

For advanced details, see the comments in config.jsonc or check the wiki (if available).

CLI overrides

Need a temporary tweak for screenshots or testing? infors now mirrors most flags settings on the CLI so you can adjust the output without touching config.jsonc.

• --config <path> loads an alternate JSONC file. --no-config ignores files altogether and runs with the built-in defaults.
• ASCII controls: --ascii_distro <name>, --ascii_colors <list>, --custom_ascii_path <file>, and --color-blocks <glyph>.
• Formatting knobs: --battery-display, --disk-display, --disk-subtitle, --memory-unit, --packages, --uptime, --os-age, --distro-display, --cpu-temp-unit.
• Layout helpers: --only cpu,memory,shell renders just the listed modules; --hide gpu removes modules from the current layout.
• Boolean toggles come in pairs—use --cpu-speed / --no-cpu-speed, --shell-path / --no-shell-path, --memory-percent / --no-memory-percent, etc., for quick on/off control of individual fields.

Run infors --help to see the complete list of overrides.

🎯 Roadmap

🤝 Contributing

1. Fork the repo
2. Create your branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m 'feat: add my feature')
4. Push to the branch (git push origin feature/my-feature)
5. Create a Pull Request

We welcome clean PRs and documented modules! ✨

📄 License

MIT License © ArtificialXDev

💡 Inspiration

• Neofetch
• Fastfetch
• Rust — the foundation of infors