https://github.com/nate-craft/yt-feeds
A fast, simple, and lightweight TUI application to watch subscription feeds from YouTube
https://github.com/nate-craft/yt-feeds
cli mpv rust youtube yt-dlp
Last synced: 5 months ago
JSON representation
A fast, simple, and lightweight TUI application to watch subscription feeds from YouTube
- Host: GitHub
- URL: https://github.com/nate-craft/yt-feeds
- Owner: nate-craft
- License: mit
- Created: 2025-03-29T16:54:00.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-06T19:03:41.000Z (7 months ago)
- Last Synced: 2025-12-21T17:58:42.184Z (6 months ago)
- Topics: cli, mpv, rust, youtube, yt-dlp
- Language: Rust
- Homepage:
- Size: 910 KB
- Stars: 11
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# YT-Feeds
YT-Feeds is a cross-platform simple, fast, and distraction free CLI application to view videos from your favorite channels.
## Features
- Fast startup and navigation
- Uses minimal resources (under 1 Mb)
- Distraction and short form content free!
- Search for your favorite channels and subscribe/unsubscribe
- Automatically tracks and resumes watch history locally
- Shows recent videos from subscriptions organized by date
- Groups subscriptions into a collective "feed" organized by date
- Categorize and view videos in the 'watch later' menu
- Never requires leaving the terminal or using your mouse
## Installing
Precompiled binaries can be found on the [AUR](https://aur.archlinux.org)
```bash
paru -Syu yt-feeds
```
For cross-platform support, use [cargo-binstall](https://github.com/cargo-bins/cargo-binstall):
```bash
cargo binstall yt-feeds
```
Or, by source with [cargo](https://github.com/cargo-bins/cargo-binstall):
```bash
cargo install --git https://github.com/nate-craft/yt-feeds
```
YT-Feeds requires mpv and yt-dlp to be installed in order to function:
- [mpv](https://github.com/mpv-player/mpv)
- [yt-dlp](https://github.com/yt-dlp/yt-dlp)
For dependency guidance, see the [installation page](docs/00-Installation.md).
## Configuration
For configuration, error logging, and saved data storage, see the [configuration page](docs/01-Configuration.md).
## Limitations
Currently, watch history is not supported on Windows as it does not support Unix sockets. A custom work-around
is planned for the future.