Feather is a lightweight, efficient, and locally hosted YouTube Music TUI built with Rust. It is designed to provide a minimalistic yet powerful music streaming experience directly from YouTube, using yt-dlp and mpv.
A lightweight, ad-less player with only essential features.
- 🎶 Stream YouTube Music without downloading files.
- ⚡ Minimal Memory Usage, targeting 60MB - 80MB RAM.
- 🚀 Fast Playback, with loading times around 3 seconds.
- 🖥️ Terminal User Interface (TUI) built using Ratatui.
- 🔄 Self-Update Feature (planned).
Ensure you have the following installed:
- 🦀 Rust (latest stable version)
- 📥 yt-dlp (for fetching YouTube data)
- 🎵 mpv (for playback)
git clone https://github.com/13unk0wn/Feather.git
cd Feather/feather_frontend
cargo build --release./target/release/feather_frontendNavigate through the TUI to search and play music. Additional controls and keyboard shortcuts will be documented soon.
If a song fails to play due to YouTube restrictions, you can bypass them by adding your cookies to the environment:
export FEATHER_COOKIES="paste your cookies here"- This is optional and should only be used if playback errors occur.
- Feather can play songs without cookies, but adding them may help
mpvbypass certain restrictions.
Feather has been tested on Linux Mint (Debian Edition), but all libraries used are compatible with other Linux distributions. Windows and Macos are not officially supported.
- 🎶 Implement player
- 🔍 Implement search
- �햐 Implement history
- ⚡ Improve performance
- 🎨 Improve UI
- 🌜 Add support for playing playlists
- 🎼 Add support for creating user playlists
- ⚙️ Add user configuration support
Check out CONTRIBUTION.md
If you have any doubts regarding contribution, feel free to reach out via:
- GitHub Issues
- @x: 13unk0wn
- Email: 13unk0wn.proton.me
A big thank you to the maintainers and contributors of:
- RustyPipe — for providing essential tools for YouTube playback.
- mpv — for making a great media player that powers Feather's playback.
- Ratatui — for enabling the terminal-based UI experience.
- Sled - database
Feather is licensed under the MIT License.
This project is still in early development. Expect rapid iterations and improvements. Suggestions and feedback are always appreciated!