MeowTube

YouTube client on your terminal

Table of Contents

• About
• Getting Started
• Usage
• Contributing

About

MeowTube is a CLI (Command Line Interface) to interact with youtube videos or audios and easy to play it via VLC. No need any account to use it.

Getting Started

First, make sure VLC already installed on your machine.

Prerequisites

1. VLC Media Player Installed

2. Register VLC (location where VLC installed) to your PATH variable

3. for windows user, better to use cmder, ANSI color supported by default

4. Check everything is good, type vlc on your terminal / cmd.

   vlc
   

Register VLC to the PATH

• Linux, no need extra step
• Mac OS / OSX, See Official Doc and then export that location to your .zshrc or .bashrc

  echo 'export PATH="$PATH:/Applications/VLC.app/Contents/MacOS"' >> ~/.zshrc && source ~/.zshrc
  

• Windows, see Official Doc and then copy that directory location to your PATH on your environment variable (see reference).

Installing

1. Download MeowTube via release page
2. Choose which target OS do you use
3. Extract the downloaded file
4. Move the file to any folder what you want (OPTIONAL)
5. Register MeowTube to your PATH variable (choose where meowtube is located)
6. Create an alias for MeowTube (OPTIONAL)
7. You may need to create meowtube config, due to some instances uses anti bot protection

Register MeowTube to the PATH

• unix based(linux & macos). export to .zshrc or .bashrc

  echo 'export PATH="$PATH:$HOME/MEOWTUBE_LOCATION_FOLDER"' >> ~/.zshrc && source ~/.zshrc
  

• Windows, copy the directory location to your PATH on your environment variable (see reference)

Usage

Check everything is good. Type on your terminal

meowtube

or

meowtube --help

Command Line Arguments

Argument	Description
help	Help about any command
play	To play YouTube video
popular	To see popular videos on YouTube
search	To search for videos according to certain characters
trending	To see trending videos on YouTube

Play Arguments

Argument	Description
:YoutubeURL	Valid YouTube video url e.g: https://youtu.be/0FZZJHuQMFs
:videoId	Valid Youtube videoId e.g: "tMzjKjV6r_w"
audio	To play audio only
playlist	To play all videos from YouTube playlist
list	shorthand for playlist. To play all videos from YouTube playlist
video	To play YouTube video

NOTE: Every argument has --help flag to see their specific usage

Global config

This config used for excluding or including invidious instances. You can add this config on your $HOME PATH and named it with .meowtube.yaml. For excluding, you can set it as false. Example:

invidious.fdn.fr: false
invidious.kavin.rocks: false
invidious.snopyta.org: false
yewtu.be: true
ytprivate.com: false

Reference: Invidious Instances

✍️ Authors

• @ikhsanalatsary - Idea & Initial work

🎉 Acknowledgements

• Inspired by ohmyzsh/spotify
• Using Invidious APIs

📌 Misc

I also published an app that uses Invidious APIs. You can download it on Play Store.