Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/botspot/youtubuddy
Search/Watch/Download YouTube videos with a lightweight, interactive tool
https://github.com/botspot/youtubuddy
gui selected-videos video vlc youtube youtube-dl youtube-downloader youtube-player
Last synced: about 2 months ago
JSON representation
Search/Watch/Download YouTube videos with a lightweight, interactive tool
- Host: GitHub
- URL: https://github.com/botspot/youtubuddy
- Owner: Botspot
- License: gpl-3.0
- Created: 2020-12-13T22:38:47.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-03-28T08:22:13.000Z (over 1 year ago)
- Last Synced: 2024-10-18T05:17:41.519Z (2 months ago)
- Topics: gui, selected-videos, video, vlc, youtube, youtube-dl, youtube-downloader, youtube-player
- Language: Shell
- Homepage:
- Size: 403 KB
- Stars: 36
- Watchers: 7
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# YouTubuddy
## Search/Watch/Download YouTube videos with a lightweight, interactive tool
- Simple
- Does not need a web browser to operate
- One `bash` script that runs everything
- Based on `youtube-dl`
- Minimal dependencies
- Minimal size: less than 500 KB total
- Secure
- YouTube can't track you
- Videos won't appear in your browsing history
- Flexible
- Add your own flags to VLC and youtube-dl. For example, make VLC repeat the playlist, or play in fullscreen
- Awesome
- Supports playlists, direct links, and searches
- Displays video thumbnails and tooltips in search results
- Allows selecting multiple videos from a list
- Easily Download multiple videos with a single click
- Play all selected videos in VLC
## To download:
```
git clone https://github.com/Botspot/youtubuddy
```
## To run:
```
~/youtubuddy/gui
```
The first time you run it, YouTubuddy takes care of dependencies and adds a menu button.
## Updating:
YouTubuddy will automatically keep itself updated with this main repo. To disable this feature, create a file at `~/youtubuddy/no-update`.
## How it works:
It turns out `youtube-dl` has [this little-known feature](https://github.com/Botspot/pi-apps/issues/116#issuecomment-743803001) that allows you to search YouTube.
As it searches, `youtube-dl` [creates a JSON file](https://github.com/Botspot/youtubuddy/blob/51ba7a6e360888fb49a32db2d93480e6ee31cb63/gui#L201) at `~/youtubuddy/data/search.json`.
Every new line in the file is another search result.
Most of the rest of the script is dedicated to reading that json file and displaying the search results in a YAD dialog window.
# Optional Settings:
## To change video playback quality:
Open VLC:
Go to tools > preferences
Enable "All" option in settings
In the left pane select "input/codecs" then on the right pane in "track settings" click preferred resolution option and select the video quality.
Note: This option will also degrade the video quality for all video (local, streams etc).
## To change video download quality:
To change the default download quality open youtubuddy > options > youtube-dl args, and insert something like `-f 135+140`.
The `135` sets the video quality, which in this case is 480p. The `140` is audio quality.
List of video quality codes:
```
code format quality
140 m4a audio only
160 mp4 144p
133 mp4 240p
134 mp4 360p
135 mp4 480p
136 mp4 720p
17 3gp 176x144
36 3gp 320x240
5 flv 400x240
43 webm 640x360
18 mp4 640x360
22 mp4 1280x720
```