OSHI is a free native (JNA or FFM) Operating System and Hardware Information library for Java. It does not require the installation of any additional native libraries and aims to provide a cross-platform implementation to retrieve system information, such as OS version, processes, memory and CPU usage, disks and partitions, devices, sensors, etc.

OSHI provides two native access implementations:

• JNA (oshi-core): Uses Java Native Access. Supports JDK 8+. JPMS module: com.github.oshi.
• FFM (oshi-core-ffm): Uses the JDK Foreign Function & Memory API. Requires JDK 25+. JPMS module: com.github.oshi.ffm.

• Windows
• macOS
• Linux (Android)
• UNIX (AIX, FreeBSD, OpenBSD, Solaris) — JNA only

• Computer System and firmware, baseboard
• Operating System and Version/Build
• Physical (core) and Logical (hyperthreaded) CPUs, processor groups, NUMA nodes
• System and per-processor load, usage tick counters, interrupts, uptime
• Process uptime, CPU, memory usage, user/group, command line args, thread details
• Physical and virtual memory used/available
• Mounted filesystems (type, usable and total space, options, reads and writes)
• Disk drives (model, serial, size, reads and writes) and partitions
• Network interfaces (IPs, bandwidth in/out), network parameters, TCP/UDP statistics
• Battery state (% capacity, time remaining, power usage stats)
• USB Devices
• Connected displays (with EDID info), graphics and audio cards
• Sensors (temperature, fan speeds, voltage) on some hardware
• Printers (name, status, driver)

• Javadocs — JNA | FFM
• FAQ
• Change Log
• Performance Considerations
• Major Version Breaking Changes
• Sample Output
• Applications and Projects using OSHI

Stable Release Versions

• JNA: oshi-core-7.0.1
• FFM: oshi-core-ffm-7.0.1

Current Development (SNAPSHOT) Versions

• JNA: oshi-core-7.0.2-SNAPSHOT
• FFM: oshi-core-ffm-7.0.2-SNAPSHOT

Legacy Versions

• JDK7: oshi-core-3.13.6
• JDK6: oshi-core-3.14.0

The oshi-core-ffm module provides a complete implementation using the JDK Foreign Function & Memory (FFM) API, with no dependency on JNA.

• Compatibility:
  • Requires JDK 25+.
  • Supports Windows, macOS, and Linux.
• Usage:
  • Use this dependency in place of oshi-core.
  • Import oshi.ffm.SystemInfo instead of oshi.SystemInfo as the entry-point.
  • API imports (oshi.hardware., oshi.software.os.) remain unchanged.
• Benefits:
  • Uses JDK-standard APIs for native access, improving long-term maintainability.
  • Potential performance improvements by eliminating JNA overhead. See the oshi-benchmark module for JMH comparisons.

The oshi-common module contains shared code used by both the JNA and FFM implementations, including API interfaces, abstract base classes, and a significant amount of default implementation logic that parses procfs, sysfs, and command-line output without any native calls.

• No native dependencies — does not require JNA, FFM, or --enable-native-access.
• Suitable for restricted JVM environments or use cases where full native access is unnecessary, such as Linux CPU and memory monitoring via /proc and /sys.
• Can be used standalone by extending the abstract base classes with your own platform-specific logic.

1. Include OSHI and its dependencies on your classpath.
   • We strongly recommend you add oshi-core as a dependency to your project dependency manager such as Maven or Gradle.
   • For Windows, consider the optional jLibreHardwareMonitor dependency if you need sensor information. Note the binary DLLs in this dependency are licensed under MPL 2.0.
   • For Android, you'll need to add the AAR artifact for JNA and exclude OSHI's transitive (JAR) dependency.
   • See the FAQ if you encounter NoClassDefFoundError or NoSuchMethodError problems.
2. Create a new instance of SystemInfo
3. Use the getters from SystemInfo to access hardware or operating system components, such as:

SystemInfo si = new SystemInfo(); // oshi.SystemInfo or oshi.ffm.SystemInfo
HardwareAbstractionLayer hal = si.getHardware();
CentralProcessor cpu = hal.getProcessor();

See SystemInfoTest.java for examples. To see sample output for your machine:

git clone https://github.com/oshi/oshi.git && cd oshi

./mvnw test-compile -pl oshi-core exec:java \
  -Dexec.mainClass="oshi.SystemInfoTest" \
  -Dexec.classpathScope="test"

Some settings are configurable in the oshi.properties file, which may also be manipulated using the GlobalConfig class or using Java System Properties. This should be done at startup, as configuration is not thread-safe and OSHI does not guarantee re-reading the configuration during operation.

The oshi-demo artifact includes several proof-of-concept examples of using OSHI to obtain information, including a basic Swing GUI.

You can run some of the demos using jbang:

# list all the aliases
jbang alias list oshi/oshi

# run the json demo
jbang json@oshi/oshi

#run the gui
jbang gui@oshi/oshi

The oshi-benchmark artifact (requires JDK 25+) provides JMH benchmarks comparing JNA and FFM implementations side by side. To run:

./oshi-benchmark/scripts/run-benchmarks.sh

• For bug reports, feature requests, or general questions about OSHI's longer term plans, please create an issue.
• For help integrating OSHI into your own project or maintainer code review of your PRs, tag @dbwiddis in issues or pull requests on your project site.
• For "how to" questions regarding the use of the API, consult examples in the oshi-demo project, create an issue, or search on Stack Overflow using the oshi tag, asking a new question if it hasn't been answered before.
• To say thanks to OSHI's primary maintainer, you can sponsor him or buy him a coffee.

Available as part of the Tidelift Subscription

The maintainers of OSHI and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. Learn more.

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.

OSHI originated as a platform-independent library that did not require additional software and had a license compatible with both open source and commercial products. We have developed a strong core of features on major Operating Systems, but we would love for you to help by:

• Testing! Our CI testing is limited to a few platforms. Download and test the program on various operating systems/versions and hardware and help identify gaps that our limited development and testing may have missed. Specific high priority testing needs include:
  • Windows systems with over 64 logical processors
  • Raspberry Pi
  • Less common Linux distributions
• Contributing code. See something that's not working right or could work better? Help us fix it! New contributors are welcome.
• Documenting implementation. Our Wiki is sparse and the oshi-demo artifact is a place to host proof-of-concept ideas. Want to help new users follow in your footsteps?
• Suggesting new features. Do you need OSHI to do something it doesn't currently do? Let us know.

• How to Contribute
• How to Release

Many thanks to the following companies for providing free support of Open Source projects including OSHI:

• SonarCloud for a range of code quality tools
• GitHub Actions, AppVeyor, and Cirrus CI for continuous integration testing
• CodeRabbit for automated AI code review
• The jProfile Java Profiler used to eliminate CPU bottlenecks

This project is licensed under the MIT License.