Skip to main content

A CLI tool that collects SMART data from disk devices, checks configurable health thresholds, optionally analyses results with an LLM, and tracks history in SQLite.

Project description

smartscan

GitHub Actions Workflow Status PyPI - Version PyPI - Version Docs

A CLI tool that runs smartctl on all disks, extracts key SMART health metrics, and stores historical results in SQLite for tracking changes over time.

Quick start

Install smartmontools to provide the smartctl command, then install smartscan:

uv tool install smartscan

Collect SMART data from all disks (requires root):

sudo smartscan collect

Query historical records, filter by name, or get JSON output:

smartscan query --since 2024-01-01
sudo smartscan collect "WDC"
sudo smartscan --json collect

Read the full documentation for shell completion, configuration reference, and advanced usage.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

smartscan-0.1.0.tar.gz (85.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

smartscan-0.1.0-py3-none-any.whl (20.8 kB view details)

Uploaded Python 3

File details

Details for the file smartscan-0.1.0.tar.gz.

File metadata

  • Download URL: smartscan-0.1.0.tar.gz
  • Upload date:
  • Size: 85.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for smartscan-0.1.0.tar.gz
Algorithm Hash digest
SHA256 84c4acdd0034e0c5af34b6bbb21937166bcc09c9a90aa639f487e9a1ba6c5adb
MD5 36e358de4b4b769c27b912b0b68b2887
BLAKE2b-256 20a9efd8c58abe0c4140fde84cf2a911c83360d943077efb77d61d309bf2d89d

See more details on using hashes here.

Provenance

The following attestation bundles were made for smartscan-0.1.0.tar.gz:

Publisher: publish-to-pypi.yaml on ak1ra-lab/smartscan

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file smartscan-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: smartscan-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 20.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for smartscan-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9206188134bc9353eb32402d6dffbc679fc7569ea78cafa759edc69f7c0a4c7a
MD5 a2d2726a83d61c673c5a12988e368108
BLAKE2b-256 e8e8aea111a28b44389aa15276767d75be060efdc54984eeed48191b2f2bce04

See more details on using hashes here.

Provenance

The following attestation bundles were made for smartscan-0.1.0-py3-none-any.whl:

Publisher: publish-to-pypi.yaml on ak1ra-lab/smartscan

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page