OSHI

Oshi is a free JNA-based (native) operating system information library for Java. It doesn't require any additional native DLLs and aims to provide a cross-platform implementation to retrieve system information, such as version, memory, CPU, disk, battery, displays, etc.

Essentials

• Find Oshi on Maven Central
• Download Oshi 2.1 (Read UPGRADING.md if upgrading from version 1.x.)
• Download Oshi 2.2-SNAPSHOT
• Dependencies:
  • Java Native Access (JNA)
  • Simple Logging Facade for Java (SLF4J)
• View the API
• View the Site

Where are we?

Oshi is a young project. While we've developed a strong core of features on major Operating Systems, we'd like you to contribute ports, and help implement more methods, and suggest new features. Read the project intro.

Current supported platforms

• Windows
• Linux
• Mac OS X

Current supported features

Operating Systems

• Manufacturer (GNU/Linux, Microsoft, Apple)
• OS (Linux Distribution, Windows, Mac OS X)
• OS Version (Version number, Codename, Build)

Hardware

• How much physical/available (free+reclaimable) RAM
• How many Physical (core) and Logical (core * thread) CPUs
• CPU uptime, load % and tick counters
• Battery state (% capacity, time remaining)
• File stores (usable and total space)
• Connected displays (with EDID info)

Sample Output

Here's sample tests output:

For Windows:

Microsoft Windows 7
Intel(R) Core(TM)2 Duo CPU T7300  @ 2.00GHz
 1 physical CPU(s)
 2 logical CPU(s)
Identifier: Intel64 Family 6 Model 42 Stepping 7
Serial Num: 09203-891-5001202-52183
Memory: 532.1 MB/2.0 GB
Uptime: 12 days, 11:00:17
CPU ticks @ 0 sec:[26579029, 0, 21746695, 549739287]
CPU ticks @ 1 sec:[26579060, 0, 21746695, 549740254]
User: 3.1% Nice: 0.0% System: 0.0% Idle: 96.9%
CPU load: 3.3% (counting ticks)
CPU load: 3.2% (OS MXBean)
CPU load average: N/A
CPU load per processor: 3.8% 4.0%
Power: 2:42 remaining
 System Battery @ 97.0%
File System:
 Floppy Disk Drive (A:) (Floppy Disk Drive) 1.1 MB of 1.4 MB free (82.4%)
 Local Disk (C:) (Local Disk) 27.3 GB of 64.0 GB free (42.7%)
 D:\ (CD Drive) 0 bytes of 0 bytes free 
 MobileBackups on 'psf' (W:) (Network Drive) 0 bytes of 697.5 GB free (0.0%)
 MacData on 'psf' (X:) (Network Drive) 3.4 GB of 4.4 GB free (77.4%)
 Home on 'psf' (Y:) (Network Drive) 121.7 GB of 697.5 GB free (17.4%)
 Host on 'psf' (Z:) (Network Drive) 121.7 GB of 697.5 GB free (17.4%)
Displays:
 Display 0:
  Manuf. ID=DEL, Product ID=4014, Analog, Serial=BENG, ManufDate=3/2006, EDID v1.3
  38 x 30 cm (15.0 x 11.8 in)
  Preferred Timing: Clock 108MHz, Active Pixels 1280x1024 
  Serial Number: DC32363EBENG
  Monitor Name: DELL 1907FP
  Range Limits: Field Rate 56-76 Hz vertical, 30-81 Hz horizontal, Max clock: 140 MHz
 Display 1:
  Manuf. ID=DEL, Product ID=4026, Analog, Serial=RFN7, ManufDate=10/2007, EDID v1.3
  38 x 30 cm (15.0 x 11.8 in)
  Preferred Timing: Clock 108MHz, Active Pixels 1280x1024 
  Serial Number: FP1827AFRFN7
  Monitor Name: DELL 1908FP
  Range Limits: Field Rate 56-76 Hz vertical, 30-81 Hz horizontal, Max clock: 140 MHz

For Linux:

GNU/Linux Fedora 20 (Heisenbug)
Intel(R) Core(TM) i7-3720QM CPU @ 2.60GHz
 4 physical CPU(s)
 8 logical CPU(s)
Identifier: Intel64 Family 6 Model 42 Stepping 7
Serial Num: CN123456789098
Memory: 21.0 GB/31.0 GB
Uptime: 12 days, 11:00:17
CPU ticks @ 0 sec:[967282, 15484, 195343, 124216619]
CPU ticks @ 1 sec:[967308, 15484, 195346, 124216790]
User: 13.0% Nice: 0.0% System: 1.5% Idle: 85.5%
CPU load: 14.5% (counting ticks)
CPU load: 14.3% (OS MXBean)
CPU load average: 1.13
CPU load per processor: 21.4% 4.9% 19.5% 4.0% 27.5% 4.6% 19.9% 4.8%
Power: 2:42 remaining
 BAT0 @ 97.0%
File System:
 / (Local Disk) 52.8 GB of 60.9 GB free (86.7%)
 Home (Mount Point) 134.5 GB of 697.5 GB free (19.3%)
 MacData (Mount Point) 3.4 GB of 4.4 GB free (77.4%)
 MobileBackups (Mount Point) 0 bytes of 697.5 GB free (0.0%)
Displays:
 Display 0:
  Manuf. ID=SAM, Product ID=2ad, Analog, Serial=HA19, ManufDate=3/2008, EDID v1.3
  41 x 27 cm (16.1 x 10.6 in)
  Preferred Timing: Clock 106MHz, Active Pixels 3840x2880 
  Range Limits: Field Rate 56-75 Hz vertical, 30-81 Hz horizontal, Max clock: 140 MHz
  Monitor Name: SyncMaster
  Serial Number: H9FQ345476
 Display 1:
  Manuf. ID=SAM, Product ID=226, Analog, Serial=HA19, ManufDate=4/2007, EDID v1.3
  41 x 26 cm (16.1 x 10.2 in)
  Preferred Timing: Clock 106MHz, Active Pixels 3840x2880 
  Range Limits: Field Rate 56-75 Hz vertical, 30-81 Hz horizontal, Max clock: 140 MHz
  Monitor Name: SyncMaster
  Serial Number: HMCP431880

For Mac OS X:

Apple Mac OS X 10.11.1 (El Capitan) build 15B42
Intel(R) Core(TM) i7-2820QM CPU @ 2.30GHz
 2 physical CPU(s)
 4 logical CPU(s)
Identifier: Intel64 Family 6 Model 42 Stepping 7
Serial Num: C02FG3HIJK45
Memory: 17.3 MB/4 GB
Uptime: 12 days, 11:00:17
CPU ticks @ 0 sec:[15973594, 0, 21796209, 286595204]
CPU ticks @ 1 sec:[15973619, 0, 21796271, 286595920]
User: 3.1% Nice: 0.0% System: 7.7% Idle: 89.2%
CPU load: 11.3% (counting ticks)
CPU load: 11.4% (OS MXBean)
CPU load average: 1.48
CPU load per processor: 25.2% 1.9% 17.3% 1.9% 
Power: 2:42 remaining
 InternalBattery-0 @ 96.0%
File System:
 Data (Network Drive) 15.7 GB of 1.8 TiB free (0.8%)
 MacData (Volume) 3.4 GB of 4.4 GB free (77.4%)
 Macintosh HD (/) (Local Disk) 134.4 GB of 697.5 GB free (19.3%)
 MobileBackups (Network Drive) 0 bytes of 697.5 GB free (0.0%)
 Time Machine Backups (Local Disk) 134.4 GB of 697.5 GB free (19.3%)
Displays:
 Display 0:
  Manuf. ID=A, Product ID=9cb6, Analog, Serial=00000000, ManufDate=6/2009, EDID v1.3
  33 x 21 cm (13.0 x 8.3 in)
  Preferred Timing: Clock 119MHz, Active Pixels 3840x1440 
  Manufacturer Data: 000000010006103000000000000000000A20
  Unspecified Text: LTN158MT07
  Monitor Name: Color LCD
 Display 1:
  Manuf. ID=A, Product ID=9227, Analog, Serial=162C0C25, ManufDate=11/2012, EDID v1.4
  60 x 34 cm (23.6 x 13.4 in)
  Preferred Timing: Clock 241MHz, Active Pixels 2560x3840 
  Preferred Timing: Clock 74MHz, Active Pixels 1280x3840 
  Serial Number: C02JM2PFF1GC
  Monitor Name: Thunderbolt

How is this different from ...

• Sigar:
  • Sigar uses JNI which requires a native DLL to be installed. Oshi uses JNA and doesn't require a native DLL to be installed.
  • Sigar is licensed under Apache 2.0 license. Oshi is distributed under the EPL license.
  • The last stable release of Sigar (1.6.4) was in 2010. Oshi is under active development as-of 2016.
• OperatingSystemMXBean
  • The com.sun.management MXBean may not be availabile in non-Oracle JVMs.
  • The MXBean has very few methods that address system-wide statistics.
  • Oshi provides significantly more information than the OperatingSystemMXBean

License

This project is licensed under the Eclipse Public License 1.0.