sdrive 1.4.1

Command line tool for uploading and managing files on SDrive.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

# SDRIVE CLI - Secure File Sharing with End-to-End Encryption

SDRIVE CLI is a command-line tool for secure file sharing with end-to-end encryption and per-file key sharing. The tool allows you to easily share files with others while maintaining full control over access.

## Installation

1. cargo install sdrive

## Commands

### Configuration

#### Create Configuration
```bash
sdrive config create
```
This will guide you through setting up:
- API key (available at https://sdrive.pro)
- User GUID
- RPC URL
- Sync directory
- Keypair path

#### Generate Encryption Key
```bash
sdrive config generate-key
```
Generates a secure encryption and decryption key in your keyring.

#### Export Key
```bash
sdrive config export-key
```
Exports the master encryption key in base64 format for sharing with others.

#### Import Key
```bash
sdrive config import-key <base64-key>
```
Imports a master encryption key from base64 format.

### File Operations

#### Upload File
```bash
sdrive upload <filepath>
```
Uploads a file to SDRIVE with end-to-end encryption. The file is automatically encrypted before upload.

#### Download File
```bash
sdrive download <url> [--output <filepath>] [--key <base64-key>]
```
Downloads and decrypts a file from SDRIVE. You can specify:
- `--output`: Where to save the decrypted file
- `--key`: A per-file key for decryption (optional)

Supports downloading from:
- cdn.sdrive.pro
- ipfs.sdrive.pro

#### Decrypt File
```bash
sdrive decrypt <filepath> [--output <filepath>]
```
Decrypts a locally stored file. You can specify:
- `--output`: Where to save the decrypted file

### Synchronization
```bash
sdrive sync
```
(Under development) Synchronizes files between local directories and SDRIVE.

## Security

- End-to-end encryption for all file sharing
- Support for per-file key sharing
- Secure storage of master key in system keyring
- Download URL validation

## Logging

You can control the log level using the `--log-level` flag:
```bash
sdrive --log-level debug <command>
```

## Troubleshooting

If you experience issues:
1. Verify that your API key is valid
2. Check that you have the correct configuration in `sdrive.toml`
3. Ensure the master key is properly installed in the keyring
4. Enable debug logging for more detailed information

## License

This project is licensed under the MIT License.