https://github.com/codesoap/ytools
Use YouTube from your terminal
https://github.com/codesoap/ytools
cli terminal unix youtube
Last synced: 4 months ago
JSON representation
Use YouTube from your terminal
- Host: GitHub
- URL: https://github.com/codesoap/ytools
- Owner: codesoap
- License: mit
- Created: 2019-02-20T20:15:54.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-10-05T22:31:58.000Z (8 months ago)
- Last Synced: 2025-10-06T00:22:17.882Z (8 months ago)
- Topics: cli, terminal, unix, youtube
- Language: Go
- Homepage:
- Size: 60.5 KB
- Stars: 29
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
README
`ytools` is a set of simple tools to interact with YouTube via the terminal.
# Usage
```console
$ ytools-search Black Mambo
1: Glass Animals - Black Mambo (Lyric Video)
2: Glass Animals - Black Mambo
3: Madrugada-Black Mambo
...
$ ytools-info 2
Glass Animals - Black Mambo
14.643.046 Views 81.526 Likes Published on 17 Feb 2015
Our new record “How To Be a Human Being” featuring “Youth” and
...
$ mpv $(ytools-pick 2)
Playing: https://www.youtube.com/watch?v=H7bqZIpC3Pg
...
$ # Without an argument, recommendations for the last picked result are
$ # listed; this also works with ytools-info and ytools-pick:
$ ytools-recommend
1: Glass Animals - Cane Shuga
2: Black Coast - TRNDSTTR (Lucian Remix)
3: Glass Animals - Season 2 Episode 3 (Official Video)
...
```
For more information take a look at `man ytools`.
# Installation
The easiest way to try `ytools` is to use the prebuilt binaries, that
are available at the [releases
page](https://github.com/codesoap/ytools/releases).
If you want to properly install `ytools` on your system, I recommend
building them yourself:
```shell
git clone git@github.com:codesoap/ytools.git
cd ytools
# Execute as root to install:
make install
# To uninstall use (again as root):
# make uninstall
# If you don't want to run make as root and don't care for the man
# page, you could alternatively run the following. This will install the
# binaries to ~/go/bin/:
# go install ./...
```
## Porcelain
You can find some convenient scripts in `porcelain/`. They are *not*
installed by `make install`. Place the ones you like in `$HOME/bin/`
(make sure this directory is in your `$PATH`).