# magnusja/libaums

Open source library to access USB Mass Storage devices on Android without rooting your device

Repository: https://github.com/magnusja/libaums
Canonical: https://ross.abutalabs.com/products/libaums
Language: Kotlin
License: Apache-2.0
License Family: permissive
Topics: mass-storage-device, android, java, usb, usb-otg, fat32, files, usb-drive, usb-flash, mass-storage, android-library, usb-host, android-usb-host, kotlin, kotlin-android, kotlin-library, libaums, on-the-go, storage, android-things
Last push: 2026-08-09T10:52:18+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 96, release rhythm 8, longevity 100
- inputs: {"age_days": 4613, "days_push": 24, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1362, forks 296 (observed 2026-08-28T04:04:30.310473+00:00)

## What it is
An open-source Android library (Java/Kotlin) that lets apps access USB mass storage devices such as pen drives, external HDDs, and card readers via the Android USB Host API without root. It implements the SCSI command set and FAT32 file system, with optional HTTP server and storage provider modules.

## Use cases
- read files from a USB flash drive on Android
- access an external hard disk from an Android app without root
- browse a FAT32 USB stick connected via OTG
- list partitions and free space on a USB mass storage device
- serve files from a USB drive over HTTP on Android
- integrate USB card reader support into an Android app

## When to choose
- your Android app needs to read or write USB mass storage devices without rooting
- you need FAT32 support over the Android USB Host API
- you want a JVM/Android library with Java and Kotlin APIs for USB drives

## When to avoid
- you need file systems other than FAT32 (e.g., exFAT, NTFS)
- your target is not Android or you cannot use the USB Host API
- you only need access to built-in device storage rather than USB drives

## Facets
- artifact type: library
- maturity: active
- function: file-system, sdk, developer-tools
- domain: android-tools, files, hardware, developer-tools
- platform: jvm
- tags: usb-mass-storage, usb-host-api, fat32, usb-otg, no-root, scsi, android-library, android

## Member repositories
- magnusja/libaums (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:30.310473+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:41:31.086470+00:00, confidence not recorded.
  - readme: https://github.com/magnusja/libaums (fetched 2026-08-28T04:04:30.310473+00:00, sha ad75c6dd4b77)
- Data as of 2026-08-30T08:39:29.467469+00:00.