o o /---o /---/---o o---/ \---\---o o \---o o

Cyme

List system USB buses and devices; a modern lsusb that attempts to maintain compatibility with, but also add new features. Includes a macOS system_profiler SPUSBDataType parser module and libusb tool for non-macOS systems/gathering more verbose information.

The project started as a quick replacement for the barely working lsusb script and is my yearly Rust project to keep up to date! It is currently in flux as I build the foundations, learn about custom serde Deserializers and newer Rust features.

The name comes from the technical term for the type of blossom on a Apple tree: cyme - it is Apple related and also looks like a USB device tree 😃🌸.

cli tree output

Features

Compatible with lsusb using --lsusb argument. Supports all arguments including --verbose output using libusb.
Filters like lsusb but that also work when printing --tree. Adds --filter_name, --filter_serial and option to hide empty --hide-buses/--hide-hubs.
Improved --tree mode.
Modern terminal features with coloured output, utf-8 characters and icons.
Can be used as a library too with system_profiler parsing module, lsusb module using libusb and display module for printing amoungst others.

Planned Features for 1.0.0 Release

[x] Controllable block data like lsd --blocks [x] Modern drawing of device tree with utf-8 boxes. [x] Vendor ID nerd font icon look up and icon theming like lsd --icon. [ ] User defined icon map import. [ ] Drawing of headers. [ ] Show buses as headers in list mode. [ ] Tree support of all device interfaces and endpoints. [] libusb optional to get more USB data and support other OS with switch from system_profiler. [ ] Interface and Device Descriptor icon look up.

Install

From crates.io with a Rust tool-chain installed: cargo install cyme. If wishing to do it from within a local clone: cargo install --path ..

If wishing to use only macOS system_profiler and not more verbose information, remove the 'libusb' feature with cargo install --no-default-features cyme

I also have a Homebrew tap: brew tap tuna-f1sh/cyme.

Alias `lsusb`

If you want to create a macOS version of lsusb, create an alias in your environment with the --lsusb compatibility flag:

alias lsusb='cyme --lsusb'

Examples output:

```

lsusb Bus 000 Device 001: ID 0bda:0411 4-Port USB 3.0 Hub Bus 002 Device 002: ID 043e:9a60 USB3.1 Hub Bus 002 Device 007: ID 0781:558c Extreme SSD Bus 002 Device 008: ID 0bda:8153 Belkin USB-C LAN Bus 002 Device 005: ID 2109:2817 USB2.0 Hub ```

Usage