youtube-uploader 0.6.0

YouTube video upload library with resumable upload, multi-channel workspaces, upload profiles, and per-video metadata TOML
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

# youtube-uploader

A Rust library and **CLI tool** for uploading videos to YouTube via the Data API v3. You run it, it uploads, it exits. **No daemon, no background process, no service.**

📖 **[Full Guide → GUIDE.md](GUIDE.md)** — setup, CLI reference, profiles, automation, architecture, security, roadmap.

🏠 **[Repository](https://github.com/DraconDev/youtube-video-uploader)** · 📦 **[Latest Release](https://github.com/DraconDev/youtube-video-uploader/releases/latest)**

## Quick Start

```bash
# Authenticate (one-time per channel)
youtube-uploader auth

# Upload a video (private by default)
youtube-uploader upload --file video.mp4 --title "My Video"

# JSON output for scripts
youtube-uploader --output json upload --file video.mp4 --title "My Video"

# Multi-channel
youtube-uploader -w gaming upload --file gameplay.mp4 --title "Let's Play"

# Upload profile
youtube-uploader -P gaming upload --file gameplay.mp4 --title "Stream"

# Batch
youtube-uploader batch manifest.csv --concurrency 2
```

## Library Usage

```rust
use std::sync::Arc;
use tokio::sync::Mutex;
use youtube_uploader::{
    CredentialStore, YouTubeUploader, VideoUpload, Visibility, StderrProgressListener,
};

let store = Arc::new(Mutex::new(CredentialStore::load("my-passphrase")?));
let youtube = YouTubeUploader::new(store, "my-passphrase", "youtube");
let progress = Arc::new(StderrProgressListener::new());

let video = VideoUpload::new("/path/to/video.mp4", "My Video Title")
    .with_description("Video description")
    .with_tags(vec!["tag1".to_string(), "tag2".to_string()])
    .with_visibility(Visibility::Public);

let result = youtube.upload(&video, Some(progress.clone())).await?;
println!("Uploaded: {} (workspace: {})", result.url, result.workspace);
```

## Features

- **YouTube API uploads**: Resumable chunked upload with 308 resume support
- **Multi-channel workspaces**: Upload to multiple YouTube accounts from a single installation
- **Upload profiles**: TOML-based presets for reusable upload defaults
- **Per-video metadata TOML**: AI-friendly `.meta.toml` files for automation pipelines
- **`--output json`**: Machine-readable output for CI/CD and scripting
- **Encrypted credential storage**: AES-256-GCM, PBKDF2 100K, zeroize on drop
- **Default visibility = Private**: Uploads never accidentally go public

## Installation

```bash
cargo install youtube-uploader-cli
```

```toml
[dependencies]
youtube-uploader = "0.6"
tokio = { version = "1", features = ["full"] }
```

## License

MIT — see [LICENSE](LICENSE).