Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lainiwa/ph-marks
:kiss: Pornhub bookmarks at your CLI
https://github.com/lainiwa/ph-marks
bookmarks cli pornhub zsh zsh-plugin
Last synced: about 1 month ago
JSON representation
:kiss: Pornhub bookmarks at your CLI
- Host: GitHub
- URL: https://github.com/lainiwa/ph-marks
- Owner: lainiwa
- License: mit
- Created: 2020-03-16T21:51:35.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2022-06-26T09:57:10.000Z (almost 2 years ago)
- Last Synced: 2024-01-25T12:52:54.197Z (4 months ago)
- Topics: bookmarks, cli, pornhub, zsh, zsh-plugin
- Language: Shell
- Homepage:
- Size: 432 KB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Lists
- awesome-zsh-plugins - ph-marks - Bookmark pornhub videos from your terminal. (Plugins / ZSH on Windows)
- fucking-awesome-zsh-plugins - ph-marks - Bookmark pornhub videos from your terminal. (Plugins / ZSH on Windows)
- awesome-zsh-plugins - ph-marks - Bookmark pornhub videos from your terminal. (Plugins / ZSH on Windows)
README
|status| |licence|
.. |status| image:: https://github.com/lainiwa/ph-marks/workflows/CI/badge.svg
.. _status: https://github.com/lainiwa/ph-marks/actions?query=workflow%3ACI
.. |licence| image:: https://img.shields.io/badge/license-MIT-blue.svg
.. _licence: LICENCE
============================================
:kiss: Pornhub Bookmarks at Your CLI
============================================
``ph-marks`` is a zsh plugin, that will let you bookmark pornhub videos. It will **not** download the videos, only their meta information and thumbnails.
.. raw:: html
Installation
############
Dependencies
============
First of all you will need some dependencies to be present on your system for this plugin to work.
Here is a table of them. The links will lead to the "install" section of each dependency.
+-------------+--------------------------+-----------+-----------------------------+
| Name | Description | Necessity | Note |
+=============+==========================+===========+=============================+
| coreutils | Basic command line tools | required | You are likely to already |
| | in UNIX-like systems | | have them |
+-------------+--------------------------+-----------+-----------------------------+
| jq_ or | JSON parser | required | jq is more likely to be |
| query-json_ | | | present in your repo. |
| | | | However, query-json is a |
| | | | faster alternative. |
+-------------+--------------------------+-----------+-----------------------------+
| youtube-dl_ | Video (metadata) | required | It is best to install the |
| | downloader | | latest version with ``pip`` |
| | | | as older version might lag |
| | | | behind pornhub most recent |
| | | | changes |
+-------------+--------------------------+-----------+-----------------------------+
| fzf_ | Fuzzy picker | optional | These two are required for |
+-------------+--------------------------+-----------+ interactive video filtering |
| ueberzug_ | In-terminal image | optional | |
| | viewer | | |
+-------------+--------------------------+-----------+-----------------------------+
.. _jq: https://stedolan.github.io/jq/download/
.. _query-json: https://github.com/davesnx/query-json#installation
.. _youtube-dl: https://github.com/ytdl-org/youtube-dl#installation
.. _fzf: https://github.com/junegunn/fzf/#installation
.. _ueberzug: https://github.com/seebye/ueberzug#installation
Plugin install
==============
Install with your favourite zsh plugin manager::
zinit load lainiwa/ph-marks
Getting Started
###############
Type ``ph `` to see available subcommands.
Let's add a first video to your library:
.. code-block:: console
$ ph add 'https://www.pornhub.com/view_video.php?viewkey=ph5e6b2338e1256'
The other option is specifying just the viewkey
instead of a full link: ``ph add ph5e6b2338e1256``.
Now list your available videos with the following command:
.. code-block:: console
$ ph list
https://www.pornhub.com/view_video.php?viewkey=ph5e6b2338e1256 "WHY Porn Changes the Brain | Science of NoFap [SFW]"
Definitely not the video to be had in one's porn bookmarks :rofl:! Let's delete it:
.. code-block:: console
$ ph delete ph5e6b2338e1256
Note you can ``ph delete `` to insert the id of the video automatically.
Now add a bunch of videos to our library (for educational reasons only):
.. code-block:: console
$ ph add \
ph5c877ca9b5f1e ph5c877cecbb277 ph5c87cc007de24 \
ph5c2a66302d63c ph5c585ffeede61 \
ph5c0f6597271b0 ph5ddb8051f0d36
Let's say you feel sapiosexual today. You can then issue a search by title:
.. code-block:: console
$ ph title facts and logic
https://www.pornhub.com/view_video.php?viewkey=ph5c0f6597271b0 "Ben Shapiro DESTROYS FEMALE LIBERAL WITH FACTS AND LOGIC"
https://www.pornhub.com/view_video.php?viewkey=ph5ddb8051f0d36 "Ben Shapiro gets BRUTALLY FUCKED by FACTS and LOGIC!!!!"
You can pipe ``ph`` commands into each other to filter them even further:
.. code-block:: console
$ ph title facts and logic | ph cat anal
https://www.pornhub.com/view_video.php?viewkey=ph5c0f6597271b0 "Ben Shapiro DESTROYS FEMALE LIBERAL WITH FACTS AND LOGIC"
Categories do not make much sense sometimes...
Configuration
#############
Configuration is being done via environment variables:
+--------------------------+-----------------------------+-------------------------+
| Variable | Default value | Meaning |
+==========================+=============================+=========================+
| PH_MARKS_HOME | ~/.pornhub | Directory with all the |
| | | fetched video metadata |
+--------------------------+-----------------------------+-------------------------+
| PH_MARKS_PARALLELIZATION | 5 | Number of parallel |
| | | metadata fetches |
+--------------------------+-----------------------------+-------------------------+
| PH_MARKS_BROWSER_CMD | Auto detection: | Command to use to open |
| | | a link in browser |
| | * firefox --private | |
| | * chrom{e,ium} --incognito | |
| | * etc | |
+--------------------------+-----------------------------+-------------------------+
Examples
########
+-------------------------------------------+-----------------------------------+
| Command | Translation |
+===========================================+===================================+
| ph category webcam | :cinema:: |
+-------------------------------------------+-----------------------------------+
| ph tag squirting | :whale:: |
+-------------------------------------------+-----------------------------------+
| ph tag squirting | ph fzf | ph open | Interactively pick a :whale:: |
| | and watch it in browser |
+-------------------------------------------+-----------------------------------+
| ph tag fake_taxi | ph open | Search and open :taxi: in browser |
+-------------------------------------------+-----------------------------------+
| ph ti facts and logic | ph del | keep nothing but feels |
+-------------------------------------------+-----------------------------------+
| ph ls | ph del | keep nothing |
+-------------------------------------------+-----------------------------------+
| rm ~/.pornhub/* | basically same as above |
+-------------------------------------------+-----------------------------------+
| ph tag mexican ukrainian | ph cat big_ass | (:mexico: ∪ :ukraine:) ∩ :peach: |
+-------------------------------------------+-----------------------------------+
Feedback
########
If you have found a bug, file a `bug report `_.