8000 GitHub - mindhuntr/yt-x: Browse youtube from your terminal
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

mindhuntr/yt-x

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 

Repository files navigation

YT-X

GitHub Issues or Pull Requests GitHub License GitHub file size in bytes GitHub Release GitHub commit activity

Browse YouTube from your terminal.

yt-x-search.webm
Browse Channels You Have Subscribed To From The Terminal
yt-x-channels.webm
View Channels Playlists
yt-x-channels-playlists.webm
Search For Something From a Specific Channel
yt-x-channels-search.webm
Watch Whats Featured in A Specific Channel
yt-x-channels-featured.webm
I Use Neovim By The Way
yt-x-config.webm

Installation

Linux/BSD Arch Linux MacOS Android

# latest release
curl -sL "https://raw.githubusercontent.com/Benex254/yt-x/refs/tags/v0.1.1/yt-x" -o ~/.local/bin/yt-x && chmod +x ~/.local/bin/yt-x

# Development version
curl -sL "https://raw.githubusercontent.com/Benex254/yt-x/refs/heads/master/yt-x" -o ~/.local/bin/yt-x && chmod +x ~/.local/bin/yt-x

Dependencies

Required:

  • jq - to pass the json data
  • curl - to download preview images
  • yt-dlp - to provide the data
  • fzf - for the main ui
  • mpv - for streaming
  • ffmpeg - to properly download hsl streams

optional:

  • glow - rendering the markdown for the descriptions
  • gum - for an even better ui
  • chafa - image rendering
  • icat - image rendering
  • imgcat - image rendering

Usage

# launch the ui
yt-x

# edit your config
yt-x -e

Define Custom Playlists

This option lets you define custom playlists.

For example:

# file located at: ~/.config/yt-x/custom_playlists.yt-x

<playlist-name>: <playlist-url>

The playlist name should only contain letters and numbers.

Contribution

Pr's are highly welcomed.

TODO

Features:

  • Add like video functionality
  • Add subscribe to channel functionality
  • Use a JSON file to store custom playlists in order to allow more features
  • Handle visit channel in browser option
  • Update script option

Fix:

  • Fix the channel sub menu by making it conform to the new preview logic
  • Fix the channel image preview
  • Fix bug where going back in the channels menu may result into weird behavior

Documentation and refactor:

  • Document all functionality
  • Remove all code in relation to lib-x which was used as a template for this project
  • Save the image and preview scripts with the filename as the id of the video or channel.
  • Write completions for fish
  • Don't force sixel graphics when using chafa
  • Remove unnecessary comments

About

Browse youtube from your terminal

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%
0