rusbview - GitLite

KO | EN

gitlite — search

#gpt #cross-platform #bash #cloud-native #command-line #cpp #machine-learning #swift #react #git

rusbview

(★ 11)

rusbview is a desktop application for inspecting USB enum

File Explorer

ZIP Download

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`cargo test`

View Details ▼

Execute the unit and integration tests of a Rust package.

cargo {{[t|test]}} {{test_name}}

Only run tests containing a specific string in their names:

cargo {{[t|test]}} -- --test-threads {{count}}

Set the number of simultaneous running test cases:

cargo {{[t|test]}} {{[-r|--release]}}

Test artifacts in release mode, with optimizations:

🔍

`pnpm`

View Details ▼

Fast, disk space efficient package manager for Node.js.
Manage Node.js projects and their module dependencies.

pnpm init

Create a `package.json` file:

pnpm {{[i|install]}}

Download all the packages listed as dependencies in `package.json`:

pnpm add {{module_name}}@{{version}}

Download a specific version of a package and add it to the list of dependencies in `package.json`:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

`rusbview` is a Tauri desktop application for inspecting USB topology, device details, hotplug history, and USB descriptors. The frontend is React, shadcn/ui, Tailwind CSS, and Motion.

## Run

Install frontend dependencies with `pnpm`:

```sh
pnpm install
```

Start the Tauri desktop app:

```sh
pnpm tauri dev
```

Build local distribution bundles without updater artifacts:

```sh
pnpm tauri build --config '{"bundle":{"createUpdaterArtifacts":false}}'
```

The app checks `https://github.com/HalfSweet/rusbview/releases/latest/download/latest.json` for updates. Tag releases publish the updater manifest through the release workflow.

For development and CI checks:

```sh
pnpm build
cargo test
```

## Platform Notes

### macOS

- Requires the Xcode command line toolchain.
- USB descriptor access can be limited by macOS permissions and device class restrictions. The app keeps profiling errors in the device detail model instead of failing the whole snapshot.

### Linux

- Tauri needs the WebKitGTK and desktop integration packages for the target distribution.
- Full descriptor reads may require udev permissions for USB devices. If devices appear without verbose descriptors, add appropriate udev rules or run with elevated permissions for debugging.

### Windows

- Build with the stable MSVC Rust toolchain and the WebView2 runtime available on the target machine.
- Some descriptor or hotplug metadata may depend on Windows device access permissions. Running elevated can help distinguish permission issues from parser issues.

## Data Locations

The application uses OS-specific project directories via the `directories` crate:

- Device history: `device-history.json` under the application data directory.
- Logs: daily rolling files under the application cache directory.

The GUI displays both paths in the Logs tab. Logs use `RUST_LOG` when set, otherwise `info`.

## Features

- Tree view of USB buses and devices.
- Device details with vendor/product IDs, serial number, speed, class, protocol, and location.
- Descriptor sections generated from cyme's verbose USB data, including configurations, interfaces, endpoints, BOS, qualifier, hub, and raw cyme JSON.
- Hotplug listener based on cyme/nusb watch support, pushed to the UI with Tauri events.
- Persistent insertion/removal counters keyed by stable device identity.
- Light, dark, and system theme modes.
- Initial i18n structure for English and Simplified Chinese. Use `RUSBVIEW_LANG=zh` to force the backend locale during development.

## Acknowledgements

Core USB enumeration and hotplug watching are powered by [`cyme`](https://github.com/tuna-f1sh/cyme).

## License

`rusbview` is licensed under the GNU General Public License v3.0 only. See [LICENSE](LICENSE).