diff options
author | Thanos Apollo <[email protected]> | 2024-02-10 12:08:10 +0200 |
---|---|---|
committer | Thanos Apollo <[email protected]> | 2024-02-10 12:08:10 +0200 |
commit | bdb3d532308071cd912bfbf92963c9cabe79de7c (patch) | |
tree | b4e0abc717a5e32f6e265678f2cccc69dc9ea681 /README.md | |
parent | 28b603bfc57788e25f8016a7771cedf372e5f3b5 (diff) | |
parent | 3172527a6a8f1297587cf1c90eaaf594b1009f68 (diff) |
Version 2.1.2 Release: Merge branch '2.1.2-dev'2.1.2
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 94 |
1 files changed, 0 insertions, 94 deletions
diff --git a/README.md b/README.md deleted file mode 100644 index e92df6e..0000000 --- a/README.md +++ /dev/null @@ -1,94 +0,0 @@ -[![MELPA](https://melpa.org/packages/yeetube-badge.svg)](https://melpa.org/#/yeetube) - -# YeeTube - -![yeetube showcase](/showcase/example.gif?raw=true "Showcase Yeetube") -## About - -This package provides the ability to scrape YouTube, with the results -displayed in a proced-like buffer. - - -Package functionality includes: - -- Query YouTube -- Play video url *by default using mpv* -- Bookmark/Save video url -- Download video *using yt-dlp* -- A minimal yt-dlp front-end, *which is independent of the rest - YouTube functionality*. - -*This package does not use Invidious or YouTube's API, just "parses" -html & json.* - - -## Installation -This package is available via [MELPA](https://melpa.org/#/yeetube) - -### Straight.el - -``` emacs-lisp -(straight-use-package - '(yeetube :type git - :host nil - :repo "https://git.thanosapollo.org/yeetube")) -``` - - -### Manual -``` shell -$ git clone https://git.thanosapollo.org/yeetube -``` - -*Add this to your emacs configuration:* - -``` emacs-lisp - (add-to-list 'load-path "/path/to/yeetube") - (load-file "~/path/to/yeetube.el") - (require 'yeetube) -``` - -### Dependencies -- [mpv](https://mpv.io/): default multimedia player -- [yt-dlp](https://github.com/yt-dlp/yt-dlp): download functionality - -*Debian/Ubuntu* -``` shell -$ sudo apt install mpv yt-dlp -``` - -## Configuration -### Media Player -By default `yeetube-player` is set to `yeetube-mpv-play`, you can -use [mpv.el](https://github.com/kljohann/mpv.el), -[GNU/Emms](https://www.gnu.org/software/emms/) or other similar -packages like so: - -``` emacs-lisp -(setf yeetube-player #'emms-play-url) -``` - -Make sure that the media player of your choice can directly play -youtube urls. - -### Apply Filters - -To filter the search results based on a specific criterion, you can -modify the `yeetube-filter` value to your preferred option. - -For example: - -```emacs-lisp -(setf yeetube-filter "Views") -``` - -This will filter & sort the search results according to the number of views. - - -### FAQ -#### Feature request: display thumbnails -Formatting images in a text buffer is not something that I found easy -or fun to do. Feel free to submit a patch if you manage to make an -appealing version of it - - |