90 lines
4.5 KiB
Markdown
90 lines
4.5 KiB
Markdown
# ytLlive
|
|
|
|
<p align="center">
|
|
<img src="Assets/llamacasty-logo.jpg" alt="LlamaCasty — livestream smarter" height="120"/>
|
|
</p>
|
|
|
|
A creator-proof live-streaming and recording app for YouTube — native Windows (C# / WPF / .NET 8).
|
|
|
|
## Screenshot
|
|
|
|
|
|
|
|
## Design Principle
|
|
|
|
> This software is so intuitive that even the most right-brained person can easily intuit and use it.
|
|
|
|
Every feature is measured against this. One-click go-live, sane YouTube defaults, visual scene
|
|
building, and no dead ends — every action has a visible outcome.
|
|
|
|
## Why ytLlive
|
|
|
|
OBS treats YouTube as an afterthought; SLOBS is Twitch-first with YouTube bolted on. ytLlive is
|
|
designed and dedicated to YouTube livestreaming and recording, and to YouTube's specific quirks.
|
|
|
|
## Account Assumption
|
|
|
|
ytLlive assumes you already have a YouTube creator account — connecting uses "Sign in with Google"
|
|
to link that existing account. **ytLlive does not create accounts.** If you don't have a YouTube
|
|
channel yet, set one up on YouTube first, then connect it here.
|
|
|
|
## Audio Assumption
|
|
|
|
ytLlive uses your **default** microphone and desktop/game output — it never hunts for a device or
|
|
contends for one. **It assumes your audio is already configured and working** (default input and
|
|
output set, not hijacked by another app). Audio issues are a Windows/device matter outside ytLlive's
|
|
scope: we don't debug, detect, or try to fix them. If it doesn't sound right, fix the system's audio
|
|
settings first — it's on the OS, not on us.
|
|
|
|
## Run
|
|
|
|
```bash
|
|
dotnet build # Windows only — WPF
|
|
dotnet run
|
|
```
|
|
|
|
## Version Roadmap
|
|
|
|
**v1 is the finished product** (creator ruling, 2026-09-01 — there are no v1.x releases).
|
|
Everything still queueing lands in v1; anything not on the feature list is on the closed
|
|
**"Out of product — permanently"** list in `TASKS.md` — read that page before asking for a feature.
|
|
|
|
What v1 ships: the five-scene director's control surface, webcam + screen capture, media + web +
|
|
text sources, chat on-stream, the social bar, mic/desktop audio with auto-duck and TRAX, local
|
|
recording, variable quality tiers with auto step-down, one-click go-live + scheduling, stream
|
|
resilience (auto-reconnect inside YouTube's grace, one-click back on air), built-in monetization
|
|
awareness (reward capture, session reports, YPP journey tracker), Alerts — all free and ungated;
|
|
the paid tier only removes the branding flash.
|
|
|
|
## Structure
|
|
|
|
| Path | Role |
|
|
|------|------|
|
|
| `Models/` | Scene, Source, WebcamSceneConfig, SceneElement, SceneCatalog, QualityOption, StreamConfig/Health, chat, Socials, BroadcastMetadata, Music, MicStatus |
|
|
| `ViewModels/` | MainViewModel (partial classes per area) + dialogs: GoLive, CameraPicker, MicPicker, HotkeyConfig, Socials, LiveBroadcastForm |
|
|
| `Services/` | YouTube (OAuth, streams/broadcasts, chat polling), LayoutStore (SQLite), capture (camera/screen-capture/media-file via FFmpeg), SceneCompositor + FramePump, FFmpeg encoder + RTMP, audio pipeline (WASAPI loopback + mic, mixer, filters, ducker, limiter, TRAX), SocialValidator, notifications, hotkeys, SceneGraph, ChatOverlayLayer |
|
|
| `Helpers/` | ViewModelBase, RelayCommand, ImageCache, AppLog, TokenStore (DPAPI), OAuthCredentials, converters |
|
|
| `Themes/` | `Controls.xaml` — the dark-theme control styles, merged once in `App.xaml` |
|
|
| `MainWindow.xaml` | Dark-theme control surface: thumbnails + central preview, two-state left panel (layers/properties ↔ live chat), top bar, footer |
|
|
| `Distribution.md` | GA-time plan: signing, installer, EULA, hardening — executed as TASK 36 |
|
|
|
|
## Docs (memory map)
|
|
|
|
`schema.md` defines the conventions; `ai.md` is the AI/session guide;
|
|
`TASKS.md` is the task queue. Each code directory carries an `index.md`.
|
|
|
|
## License
|
|
|
|
LlamaCasty is free software, released under the **GNU General Public License v3.0**
|
|
([`LICENSE`](LICENSE)) with three additional terms permitted by GPL-3.0 section 7
|
|
([`ADDITIONAL-TERMS.md`](ADDITIONAL-TERMS.md)):
|
|
|
|
- **Keep the credit** — any copy, modified or not, shows "Based on LlamaCasty by Gramps —
|
|
https://llamacasty.com" in its About screen.
|
|
- **Rename your fork** — modified versions are marked as modified and use a different name.
|
|
- **No trademark rights** — the LlamaCasty name and llama logo aren't licensed. The icon and logo
|
|
files are all rights reserved and aren't covered by the GPL.
|
|
|
|
Bundled third-party components keep their own licenses: see
|
|
[`THIRD-PARTY-NOTICES.txt`](THIRD-PARTY-NOTICES.txt).
|