Metadata-Version: 2.4
Name: tusb
Version: 0.3.2
Summary: TUI for managing USB devices on Linux
Author-email: Your Name <your.email@example.com>
License: GPL-3.0-or-later
License-File: LICENSE
Keywords: device-manager,linux,mount,tui,usb
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Filesystems
Requires-Python: >=3.14
Requires-Dist: click>=8.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: textual>=8.0.0
Description-Content-Type: text/markdown

# tusb

TUI for managing USB devices on Linux.

## Current Features

- List block devices via `lsblk`
- Mount/unmount USB devices with sudo password
- Generate fstab entries
- Device details (UUID, label, filesystem type)
- Write permissions via uid/gid mapping
- Auto-refresh device list
- Cross-platform compatibility checks

## Upcoming Features

- Device favorites/persistence
- Auto-mount on device plugged in
- Mount options configuration
- Multiple mount points per device
- Device filtering by type

## Installation

### uv ( Recommended )

```bash
uv tool install tusb
```

Or for development:

```bash
uv sync
.venv/bin/tusb
```

### From PyPI

```bash
pip install tusb
```

## Usage

```
tusb
```

### Key Bindings

| Key | Action |
|-----|--------|
| M | Mount selected device |
| U | Unmount selected device |
| F | Generate fstab line |
| R | Refresh device list |
| Q | Quit |

## Requirements

- Linux
- Python 3.14+
- sudo permissions

## References

- [caligula](https://github.com/ifd3f/caligula/) - TUI for managing LUKS volumes