twilroad/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

Maintainers

Details

github.com/twilroad/linfo

Homepage

Source

Installs: 1 782

Dependents: 3

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 73

v3.0.3 2017-11-22 07:49 UTC

Requires

  • php: >=5.3.0
  • ext-pcre: *

Suggests

  • ext-com: On Windows

GPL 899c8e3b887452d011810ab4819fdea4dbd64c73

healthlinuxsystemCPUspecs

This package is auto-updated.

Last update: 2024-11-26 23:15:46 UTC

README

Travis tests

Linfo is a:

  • Light themable Web UI and REST API displaying lots of system stats
  • Ncurses CLI view of WebUI
  • Extensible, easy (composer) to use PHP5 Library to get extensive system stats programmatically from your PHP app

Contributing

Interested in contributing? Check out Development Readme

web UI

Linfo WebUI Screenshot

ncurses preview

Linfo Ncurses Screenshot

See: Enabling ncurses

PHP library usage

composer require linfo/linfo
<?php
$linfo = new \Linfo\Linfo;
$parser = $linfo->getParser();

var_dump($parser->getCPU()); // and a whole lot more

Runs on

  • Linux
  • Windows
  • FreeBSD
  • NetBSD
  • OpenBSD
  • DragonflyBSD
  • Darwin/Mac OSX
  • Solaris
  • Minix

Information reported

  • CPU type/speed; Architecture
  • Mount point usage
  • Hard/optical/flash drives
  • Hardware Devices
  • Network devices and stats
  • Uptime/date booted
  • Hostname
  • Memory usage (physical and swap, if possible)
  • Temperatures/voltages/fan speeds
  • RAID arrays
  • Via included extensions:
    • Truecrypt mounts
    • DHCPD leases
    • Samba status
    • APC UPS status
    • Transmission torrents status
    • uTorrent torrents status
    • Soldat server status
    • CUPS printer status
    • IPMI
    • libvirt VMs
    • more

System requirements:

  • At least PHP 5.4
  • If you are using PHP 7.1, you might need to disable the opcache extension.
  • pcre extension

Windows

Linux

  • /proc and /sys mounted and readable by PHP
  • Tested with the 2.6.x/3.x kernels

FreeBSD

  • PHP able to execute usual programs under /bin, /usr/bin, /usr/local/bin, etc
  • Tested on 8.0-RELEASE, 10.2-RELEASE

NetBSD

  • PHP able to execute usual programs under /bin, /usr/bin, /usr/local/bin, /usr/pkg/bin, etc
  • Tested on NetBSD 5.0.2

OpenBSD

  • PHP able to execute usual programs under /bin, /usr/bin, /usr/local/bin, etc
  • Tested on OpenBSD 4.7, 5.7
  • Turn chroot of httpd/nginx/php-fpm off

Web UI Installation

  1. Extract tarball contents to somewhere under your web root
  2. Rename sample.config.inc.php to config.inc.php, after optionally changing values in it
  3. Visit page in web browser
  4. Pass URL to your friends to show off

URL arguments

  • ?out=xml - XML output (requires SimpleXML extension)
  • ?out=json - JSON output
  • ?out=jsonp&callback=functionName - JSON output with a function callback. (Look here: http://www.json-p.org/ )
  • ?out=php_array - PHP serialized associative array
  • ?out=html - Usual lightweight HTML (default)

Extensions

  • See a list of php files in src/Linfo/Extensions/
  • Open them and look at the comment at the top of the file for usage

Troubleshooting:

Set $settings['show_errors'] = true; in config.inc.php to yield useful error messages.

TODO:

  • Support for other Unix operating systems (Hurd, IRIX, AIX, HP UX, etc)
  • Support for strange operating systems: Haiku/BeOS
  • More superfluous features/extensions
  • Make ncurses mode rival htop (half kidding)

Meta

This project is dedicated to the memory of Eric Looper.