semvec/pypi-packages huggingface dataset:
xxxease 0.1.1
Simple terminal porn watcher
License: MIT
Requires Python: >=3.10

```markdown
# XXXEase 🛋️

[![PyPI](https://img.shields.io/pypi/v/xxxease.svg)](https://pypi.org/project/xxxease/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

A dead-simple terminal porn watcher. Search, pick a video, stream or download it. No browser. No tabs. No bullshit.


## Features

- `xxxease search "bbc"` → beautiful table with title, duration, views and URL
- Arrow keys to pick a video
- One key to **stream** or **download**
- Standalone commands: `xxxease stream URL` and `xxxease download URL`
- Downloads go to `~/Downloads/porn` by default
- Configurable player (mpv/vlc), quality (720p/1080p/best) and output folder
- Rich progress bars and spinners 

## Installation

```bash
pip install xxxease
```

That's it.

## Quick Start

```bash
# Search and binge
xxxease search "brazzers" --limit 5
```

You'll get a table like this:

```
Results for 'brazzers' (pornhub) (1-5)
┏━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ # ┃ Title                                 ┃ Duration ┃ Views     ┃ URL                                   ┃
┡━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 1 │ Brazzers - Big Tit MILF Gets Pounded  │ 32.5 min │ 5,421,337 │ http://www.pornhub.com/view_video.ph… │
│ 2 │ Brazzers Exxtra - Angela White Scene  │ 38.1 min │ 8,912,045 │ http://www.pornhub.com/view_video.ph… │
└───┴───────────────────────────────────────┴──────────┴───────────┴───────────────────────────────────────┘
```

Use arrow keys to pick a video → choose **stream** (plays instantly) or **download** (saved to `~/Downloads/porn`).

Direct usage:

```bash
xxxease stream https://www.pornhub.com/view_video.php?viewkey=ph12....
xxxease download https://www.pornhub.com/view_video.php?viewkey=ph12... --subs
```

Safe mode (YouTube):

```bash
xxxease search "funny cats" --site youtube
```

## Configuration

First run creates `~/.xxxease.toml`. Edit it:

```toml
player = "mpv"                     # mpv or vlc
quality = "best[height<=1080]"     # 720p, 1080p, best, audio-only
output = "~/Downloads/porn"        # where downloads go
```

## Tips & Troubleshooting

- Getting blocks or age gates?  
  Use a VPN (ProtonVPN free works great) or log in to Pornhub in Firefox — cookies are auto-loaded.
- Want subs? Use `--subs` with `download` or pick "download" in the picker.
- Update yt-dlp : `pip install --upgrade yt-dlp`

## Demo

![demo](demo.gif)