youtube-tui 0.3.0

Warning:

• This app is only for *nix systems

Changes made in this commit

• Channel support

Installation

Requirements: Git, Cargo and the Rust Compiler

Executable size: ~12.5MB

# Install from crates.io (might not be as up-to-date as the one on GitHub)
cargo install youtube-tui

# Install from GitHub with cargo install (The binary will be placed in ~/.cargo/bin, and can be called with `youtube-tui`)
git clone https://github.com/siriusmart/youtube-tui && cd youtube-tui && cargo install --path . && cd .. && rm -rf youtube-tui

Features

• View the Trending and Popular tab of YouTube
• View your Watch history
• Download videos and audio
• Watch videos and audio
• Video and playlist support

Movement

• Use the arrow keys to move around the screen
• Press enter to select an item
• When item is selected all your keys will be passed into it
• Press escape to exit the item
• Press q to quit the program

Layout

• Each divided area is one item
• Red shows the item your currently on
• Blue shows the selected item
• Yellow shows an item in a special state

Storage

• Cache is stored in ~/.cache/youtube-tui, it is cleared when you quit the program
• Storage is stored in ~/.local/share/youtube-tui
• Config files are stored in ~/.config/youtube-tui

Config files

The config files are located in ~/.config/youtube-tui, run the program once to create the config files. The following are the default config files:

main.yml

# The program's main config file
---
yt_dl: # Donwload location for your downloaded videos
  video_path: ~/Downloads/%(title)s.%(ext)s
  audio_path: ~/Downloads/%(title)s.%(ext)s
max_watch_history: 50 # Maximum length of watch history

commands.yml

# Command arguments to use when launching applications
---
video_player:
  command: mpv
  open_in_console: false
  args:
    - "--no-terminal"
    - "{url}"
audio_player:
  command: mpv
  open_in_console: true
  args:
    - "--no-video"
    - "{url}"
image_viewer:
  command: mpv
  open_in_console: false
  args:
    - "{url}"
    - "--no-terminal"
video_downloader:
  command: yt-dlp
  open_in_console: true
  args:
    - "{url}"
    - "-o"
    - "{video_save_location}"
audio_downloader:
  command: yt-dlp
  open_in_console: true
  args:
    - "{url}"
    - "-o"
    - "{audio_save_location}"
    - "-x"
terminal:
  command: konsole
  open_in_console: false
  args:
    - "-e"
    - "{command}"
playlist_audio_all:
  command: mpv
  open_in_console: true
  args:
    - "--no-video"
    - "{url}"
playlist_video_all:
  command: mpv
  open_in_console: false
  args:
    - "{url}"
    - "--no-terminal"
playlist_shuffle_audio_all:
  command: mpv
  open_in_console: true
  args:
    - "--no-video"
    - "{url}"
    - "--shuffle"
download_all_audio:
  command: yt-dlp
  open_in_console: true
  args:
    - "{url}"
    - "-o"
    - "{audio_save_location}"
    - "-x"
download_all_video:
  command: yt-dlp
  open_in_console: true
  args:
    - "{url}"
    - "-o"
    - "{video_save_location}"

To Do

• Update notice (e.g. when a new version is released on GitHub or crates.io, can be disabled in the config file)
• Keybind options (e.g. change the keybinds in the config file)
• Channel search + item sorting

Bugs

• If there is a bug please open a GitHub issue thx :)