Grabber
Utilities to extract media from supported sources and publish to Telegram/Telegraph.
Quick Start
- Install dependencies:
uv sync --dev
- Configure environment in
.env(at minimum):
BOT_TOKENTELEGRAPH_TOKENSHORT_NAMEAUTHOR_NAMEAUTHOR_URL
- Show supported entities:
uv run grabber -a
Run (CLI)
Example:
uv run grabber --publish --channel @your_channel --sources "https://example.com/post"
Send plain text to a channel:
uv run grabber --channel @your_channel --text "Some text"
Print unread Picazor album notification URLs:
uv run grabber --notifications picazor --number 10
Print profile URLs for the first unread Picazor album notifications scanned:
uv run grabber --notifications picazor --number 10 --profiles
Print Fapello feed image URLs:
uv run grabber --notifications fapello --number 10
Print unique Fapello profile URLs from the feed:
uv run grabber --notifications fapello --number 10 --profile
Search Fapello models:
uv run grabber --search fapello --query peachyxeena
Fapello notification/search modes and Picazor notification mode need these .env values from authenticated browser sessions:
FAPELLO_USER_ID=
FAPELLO_HASH=
PICAZOR_SESSION_TOKEN=
PICAZOR_CF_CLEARANCE=
PICAZOR_CSRF_TOKEN=
PICAZOR_LOCALE=en
Post text into a thread (discussion group):
uv run grabber --channel @your_channel --thread-id 123 --text "Some text in thread"
If --thread-id is omitted, grabber prints the resolved thread id so you can reuse it:
uv run grabber --channel @your_channel --text "Some text"
Output:
Text sent to @your_channel
Resolved thread id for reuse: --thread-id 123
Run Interactive Bot
uv run python -m grabber.core.bot.interactive_bot
Then use /post, select channel, and send source URLs.
Run Web UI
The web interface is served in two services:
web-api: FastAPI backend (session-protected endpoints)web-ui: React dashboard
Setup
- Add web environment variables:
WEB_UI_PASSWORD=your-strong-password
WEB_SESSION_SECRET=a-long-random-string
WEB_SESSION_TTL_SECONDS=86400
- Start the stack:
docker compose up --build web-api web-ui
-
Open
http://<your-vps-ip>:8888(or map another public port indocker-compose.yml). -
Log in with
WEB_UI_PASSWORD. After login:
- Enter one or more URLs and target channel
- Optionally enable tag mode/video mode
- Send plain text by checking Post text only
- Optionally provide a thread id (
--thread-id) for text replies/comments
Notes:
- The channel list is pulled from the existing bot
CHANNELSmapping (src/grabber/core/settings.py). - Entity list comes from
QUERY_MAPPING. - API routes are exposed under
/api/*and proxied by the UI.
Pornhub Video-to-Channel
Single-video Pornhub URLs are supported for direct Telegram delivery.
Requirements
- A target channel is mandatory (
--channelin CLI or bot channel picker). yt_dlpmust be available in the runtime environment.PORNHUB_COOKIES_FILE_PATHmust point to a valid Netscape-format cookies file.
Add to .env:
PORNHUB_COOKIES_FILE_PATH=/absolute/path/to/pornhub_cookies.txt
Supported Pornhub hosts
pornhub.comwww.pornhub.comm.pornhub.com
CLI example
uv run grabber \
--publish \
--channel -1003835153909 \
--sources "https://www.pornhub.com/view_video.php?viewkey=ph5abc123"
Note: CLI --channel must be a Telegram username/ID (for example @channel_name or -100...), not the interactive bot display label.
Delivery behavior
- Chooses the best format expected to fit Telegram Bot API upload limits (
<= 50MB). - If the selected media is oversized, it sends a link message fallback to the channel.
- If
--channelis missing, Pornhub execution fails fast with an explicit error. - If
PORNHUB_COOKIES_FILE_PATHis missing/invalid, execution fails fast. - Checkpoint dedupe is applied, and successful sends are committed.
Troubleshooting
PORNHUB_COOKIES_FILE_PATH is required...- Set
PORNHUB_COOKIES_FILE_PATHin.env.
- Set
...does not exist or is not a file- Fix the path and permissions for the cookies file.
yt_dlp is required to process Pornhub sources- Install dependencies in the same runtime where
grabberexecutes.
- Install dependencies in the same runtime where
ERROR: [PornHub] ... Unable to extract title- The adapter now auto-falls back to HTML media parsing when
yt_dlpmetadata extraction fails. - If it still fails, refresh/export cookies again and update
yt-dlpin your runtime.
- The adapter now auto-falls back to HTML media parsing when
- Oversized media warnings
- Expected behavior; the source falls back to link delivery.
1 maintainer
Metadata
1 maintainer
Release files for grabberlib2 0.51.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| grabberlib2-0.51.3.tar.gz | 232.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| grabberlib2-0.51.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 691.2 kB
Release files / grabberlib2-0.51.3.tar.gz
| Download URL | grabberlib2-0.51.3.tar.gz |
|---|---|
| Size | 232.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8d1b434da7010e2f268ba2bb67d44ab1428e8724946fddbf813765ab630cfe4d
|
|
BLAKE2b-256 checksum How to use checksums |
0ef30154551a3ef78bfcc20d07811ae9e82b7dcd0731708c603cde4ae6f4b0b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / grabberlib2-0.51.3-py3-none-any.whl
| Download URL | grabberlib2-0.51.3-py3-none-any.whl |
|---|---|
| Size | 459.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d6c9191539ae2c44dac7a27fb0493b8774dc04e1b5a2979ed6fd896c5cecb1fb
|
|
BLAKE2b-256 checksum How to use checksums |
1bac3072a27e5969567fe1b1f8b458a2fddaaf835c110ef9406ba07408f4d888
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for grabberlib2 0.51.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
