aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorThanos Apollo <[email protected]>2024-02-09 18:15:25 +0200
committerThanos Apollo <[email protected]>2024-02-09 18:38:46 +0200
commite86aa36f36ee009d39bdb6827c7931f1bad191ba (patch)
tree2f72cf0eeb560f8cd852decf56b94a4a8a27cc32 /README.md
parente857377830071c0d86e55f923c711a8554a4e9b1 (diff)
README: Redo as plain text
Diffstat (limited to 'README.md')
-rw-r--r--README.md108
1 files changed, 0 insertions, 108 deletions
diff --git a/README.md b/README.md
deleted file mode 100644
index a2efdbc..0000000
--- a/README.md
+++ /dev/null
@@ -1,108 +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.
-
-### Torsocks
-
-If you are using `yeetube-mpv-play` as your media player & running
-[tor](https://wiki.archlinux.org/title/Tor), you can use torsocks to
-route your traffic via the tor network.
-
-``` emacs-lisp
-(setf yeetube-mpv-enable-torsocks t)
-```
-
-*You can toggle that option with `yeetube-mpv-toggle-torsocks`*
-
-### Video Quality
-
-If you are using `yeetube-mpv-play` as your media player, you can
-specify video quality using `yeetube-mpv-change-video-quality`
-*recommended* or by using this snippet.
-
-``` emacs-lisp
-(setf yeetube-mpv-video-quality "720") ;; Accepted values include: 1080, 720, 480, 360, 240, 144
-```
-