SMARTie

SMARTie is a pure-python, 0-dependency library for getting basic disk information such as model, serial number, disk health, temperature, and SMART data. It supports both SCSI/ATA and NVMe devices.

Installation

SMARTie can be installed from PyPI using pip:

pip install smartie

If you want the CLI, you can install it with:

pip install smartie[cli]

Example Usage

The high-level interface is designed to be simple and easy to use. For example, to get the model, serial, and temperature of all devices:

for device in get_all_devices():
    with device:
        print(device.model, device.serial, device.temperature)

The low-level interface is by necessity more complex, but it provides a way to send raw SCSI/ATA commands to devices. For example, to get the raw SMART data from a device:

import ctypes

from smartie.scsi import structures
from smartie.device import get_device

with get_device('\\\\.\\PhysicalDrive0') as device:
    # The structure that will be populated with the response.
    inquiry = structures.InquiryResponse()

    response = device.issue_command(
        structures.Direction.FROM,
        structures.InquiryCommand(
            operation_code=structures.OperationCode.INQUIRY,
            allocation_length=ctypes.sizeof(inquiry)
        ),
        inquiry
    )

    if response:
      print(inquiry.product_identification)

… or to get the raw NVMe Identify data from a device:

import ctypes

from smartie.nvme import structures
from smartie.device import get_device

with get_device('/dev/nvme0') as device:
    # The structure that will be populated with the response.
    data = structures.NVMEIdentifyResponse()
    device.issue_admin_command(
        structures.NVMEAdminCommand(
            opcode=structures.NVMEAdminCommands.IDENTIFY,
            addr=ctypes.addressof(data),
            data_len=ctypes.sizeof(data),
            cdw10=1
        )
    )
    print(data.model_number)

Supported Platforms

OS	Device Discovery	SCSI/ATA Supported	NVME Supported
Linux	Yes	Yes	Yes
Windows	Yes	Yes	In-progress
OS X	Yes	In-progress	N/A