About System Info

A TypeScript/Node.js library to display comprehensive system information with customizable output.

• 📊 Comprehensive: 30+ system metrics including CPU, GPU, network, containers, and more
• 🌍 Cross-platform: Works on Linux, macOS, and Windows, and Android
• 🎨 Customizable: Configure colors, emojis, and display order
• 🔌 Two Modes: Use as CLI tool or import as API
• 🚀 Cached: Intelligent caching system for quick repeated access
• 💾 TypeScript: Full type definitions included

Installation

npx about-system

npm install -g about-system
about-system

bun x about-system

Examples

👤 deck 🏠 steamdeck 📁 90% 💾 2/14GB 🔝 6% cursor ⏱️ 1d 7h 18m 🌎 174.194.193.230 📍 San Jose 🔗 http://230.sub-174-194-193.myvzw.com 👮 Verizon Business ⚡ SteamOS 📈 AMD Custom APU 0405 💻 Jupiter 🔧 6.11.11-valve12-1-neptune-611-g517a46b477e1 🐚 fish 🚀 npm pip docker nvim bun 📦 docker-node

👤 u0_a365 🏠 localhost 📁 54% 💾 1/5GB 🔝 1% fish ⏱️ 4d 9h 19m 🌎 174.194.193.230 🌐 192.168.42.229 📍 San Jose 🔗 http://230.sub-174-194-193.myvzw.com 👮 Verizon Business ⚡ Android 13 📈 Kryo-4XX-Silver 💻 SM-G781U 🔧 4.19.113-27223811 🐚 nu 🚀 apt npm pip hx nvim

CLI Usage

Basic Usage

# Show all system information
about-system

# Show specific fields
about-system cpu,ram_used,disk_used

# Output as JSON
about-system --json

# Get help
about-system --help

Installation as Shell Greeting

# Install as shell greeting (runs on terminal startup)
about-system --install

Configuration

# View current settings
about-system --settings-show

# Reset settings to defaults
about-system --settings-reset

# Set specific configuration values
about-system --set display.show_emojis false
about-system --set colors.user blue
about-system --set emojis.cpu "🚀 "
about-system --set labels.cpu "Processor"

# Clear cache
about-system --refresh

API Usage

You can import and use individual system info functions:

import { infoFunctions, getSystemInfo } from "about-system";

// Create a context with cache
const cache = {};
const context = { cache };

// Use individual functions
const cpu = infoFunctions.cpu(context);
const ram = infoFunctions.ram_used(context);
const uptime = infoFunctions.uptime();

// Build custom monitoring tools
async function getBasicInfo() {
  return {
    user: infoFunctions.user(),
    hostname: infoFunctions.hostname(),
    uptime: infoFunctions.uptime(),
  };
}

Available Info Blocks

| Block | Description | Example Output | | --------------- | -------------------------- | ------------------------------ | | user | Current username | 👤 username | | hostname | System hostname | 🏠 hostname | | ip | Public IP address | 🌎 192.168.1.1 | | iplocal | Local IP addresses | 🌐 192.168.1.100 | | city | Location based on IP | 📍 San Francisco | | domain | Reverse DNS hostname | 🔗 http://example.com | | isp | Internet service provider | 👮 Verizon Business | | os | Operating system | ⚡ Ubuntu 22.04 | | cpu | CPU information | 📈 Intel Core i7-8700K | | gpu | Graphics card | 🎮 NVIDIA GeForce RTX 3080 | | disk_used | Disk usage percentage | 📁 75% | | ram_used | Memory usage | 💾 8/16GB | | top_process | Highest CPU process | 🔝 15% chrome | | uptime | System uptime | ⏱️ 2d 5h 30m | | device | Device model | 💻 MacBook Pro | | kernel | Kernel version | 🔧 5.15.0-56-generic | | shell | Current shell | 🐚 fish | | pacman | Available package managers | 🚀 apt npm pip docker | | ports | Open network ports | 🔌 80http 443https 22ssh | | containers | Running Docker containers | 📦 nginx redis postgres |

Configuration

The script uses a JSON settings file located at:

• Linux/macOS: ~/.config/systeminfo-settings.json
• Windows: %APPDATA%\systeminfo-settings.json

Settings Commands

# Show current settings
about-system --settings-show

# Reset to defaults
about-system --settings-reset

# Set individual values
about-system --set display.show_emojis false
about-system --set colors.user blue
about-system --set emojis.cpu "🚀 "
about-system --set labels.hostname "Computer"
about-system --set cache.enabled true

# Clear cache
about-system --cache-clear

Example Settings

{
  "version": "1.0.0",
  "display_order": [
    ["user", "hostname", "os", "device", "kernel", "cpu", "gpu"],
    [
      "disk_used",
      "ram_used",
      "top_process",
      "uptime",
      "temperature",
      "battery"
    ],
    ["ip", "iplocal", "city", "domain", "isp"],
    ["shell", "pacman", "services_running", "containers"]
  ],
  "colors": {
    "user": "red",
    "hostname": "orange",
    "disk_used": "purple",
    "ram_used": "yellow",
    "uptime": "cyan",
    "ip": "green",
    "os": "blue",
    "cpu": "orange",
    "shell": "orange"
  },
  "emojis": {
    "user": "👤 ",
    "hostname": "🏠 ",
    "cpu": "📈 ",
    "gpu": "🎮 ",
    "disk_used": "📁 ",
    "ram_used": "💾 ",
    "ip": "🌎 ",
    "shell": "🐚 "
  },
  "labels": {
    "user": "User",
    "hostname": "Host",
    "cpu": "CPU",
    "gpu": "GPU",
    "disk_used": "Disk",
    "ram_used": "RAM",
    "ip": "IP",
    "shell": "Shell"
  },
  "display": {
    "show_emojis": true,
    "single_line": false,
    "line_wrap_length": 100
  },
  "network": {
    "show_offline_message": true
  },
  "advanced": {
    "debug": false
  }
}

Customization Options

Colors

Available color options for each info block:

• red, orange, yellow, green, blue, cyan, purple, magenta, gray, lightblue
• Use multicolor for ports to get a rainbow effect

about-system --set colors.user blue
about-system --set colors.hostname green

Emojis

Customize the emoji displayed for each info block. Emojis can be toggled on/off globally with display.show_emojis or individually customized:

# Toggle emojis on/off
about-system --set display.show_emojis false

# Customize individual emojis
about-system --set emojis.cpu "🚀 "
about-system --set emojis.hostname "🖥️ "
about-system --set emojis.battery "🔋 "

Labels

Customize the text labels for each info block:

about-system --set labels.cpu "Processor"
about-system --set labels.hostname "Computer"
about-system --set labels.ram_used "Memory"

Platform-Specific Features

Windows

• Detects Windows-specific package managers (choco, winget, scoop)
• Uses wmic for system information
• Supports PowerShell and Command Prompt integration

Linux

• Detects Linux package managers (apt, yum, pacman, etc.)
• Reads from /proc and /sys filesystems
• Supports various shells (bash, zsh, fish, nushell)

macOS

• Detects macOS-specific tools
• Uses system_profiler for hardware info
• Supports zsh and bash integration

Cache System

The script implements intelligent caching to improve performance:

• IP Info: 5 minutes (network requests are expensive)
• System Info: 24 hours (rarely changes)
• Process Info: 5 seconds (changes frequently)
• Disk/RAM: 1 minute (moderate change frequency)

Shell Integration

The --install flag automatically configures the script as a shell greeting:

• Bash: Adds to ~/.bashrc
• Zsh: Adds to ~/.zshrc
• Fish: Adds to ~/.config/fish/config.fish
• NuShell: Adds to ~/.config/nushell/config.nu
• PowerShell: Provides instructions for profile setup

Documentation

JSDoc Comments

All API functions include comprehensive JSDoc documentation:

import { infoFunctions } from "about-system/api";

// Hover over any function in your IDE to see:
// - Function description
// - Parameter details
// - Return type information
// - Usage examples
// - Platform-specific notes

infoFunctions.cpu(context); // IDE shows full documentation

Features:

• ✅ Every function documented with JSDoc
• ✅ Parameter and return type descriptions
• ✅ Real-world usage examples
• ✅ Platform compatibility notes
• ✅ IDE autocomplete support

TypeScript Support

Full TypeScript definitions with:

• Complete SystemInfo interface
• All 30+ field types documented
• Platform-specific type unions
• Exported helper types

import type {
  SystemInfo, // Main info object
  Platform, // Platform type
  SystemInfoOptions, // Config options
  InfoContext, // Context for functions
} from "about-system/types";

Links

• Repository
• Issues