Steve Dudenhoeffer
01d4ddc422
All checks were successful
Build and Push Docker Image / build (push) Successful in 1m55s
truthbrush requires TRUTHSOCIAL_USERNAME and TRUTHSOCIAL_PASSWORD environment variables for API access. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
154 lines
4.4 KiB
Markdown
154 lines
4.4 KiB
Markdown
# Pravda
|
|
|
|
A Python-based Dockerized service that monitors Truth Social feeds and relays posts to Discord via webhooks. Features intelligent media handling (transcoding/splitting) and interactive message components.
|
|
|
|
## Features
|
|
|
|
- Monitors Truth Social feeds using the `truthbrush` library
|
|
- Relays posts to Discord with full media support
|
|
- Automatic video transcoding to H.264/AAC for Discord compatibility
|
|
- Smart file size management (keeps videos under 50MB)
|
|
- Message splitting for long posts (Discord's 2000 char limit)
|
|
- Interactive buttons for deleting messages and viewing raw post data
|
|
- SQLite database for tracking processed posts
|
|
- FastAPI server for handling Discord interaction webhooks
|
|
|
|
## Requirements
|
|
|
|
- Python 3.12+
|
|
- Docker (for containerized deployment)
|
|
- ffmpeg (for video transcoding)
|
|
- A **Truth Social account** (for API access)
|
|
- A Discord webhook URL
|
|
- A Discord application (for interaction components)
|
|
|
|
## Environment Variables
|
|
|
|
| Variable | Description | Required |
|
|
|----------|-------------|----------|
|
|
| `TRUTHSOCIAL_USERNAME` | Truth Social account username | Yes |
|
|
| `TRUTHSOCIAL_PASSWORD` | Truth Social account password | Yes |
|
|
| `DISCORD_WEBHOOK` | Discord Webhook URL for posting messages | Yes |
|
|
| `DISCORD_APPLICATION_ID` | Discord Application ID for components | Yes |
|
|
| `DISCORD_PUBLIC_KEY` | Public Key for verifying interaction signatures | Yes (if using interactions) |
|
|
| `POLL_INTERVAL` | Seconds between checks (default: 300) | No |
|
|
| `TRUTH_USER` | Target username to monitor (default: realDonaldTrump) | No |
|
|
| `DB_PATH` | Path to SQLite DB (default: /data/seen.db) | No |
|
|
|
|
## Quick Start
|
|
|
|
### Local Development
|
|
|
|
```bash
|
|
# Install dependencies
|
|
pip install -r requirements.txt
|
|
|
|
# Set environment variables
|
|
export TRUTHSOCIAL_USERNAME="your_truthsocial_username"
|
|
export TRUTHSOCIAL_PASSWORD="your_truthsocial_password"
|
|
export DISCORD_WEBHOOK="your_webhook_url"
|
|
export DISCORD_APPLICATION_ID="your_app_id"
|
|
export DISCORD_PUBLIC_KEY="your_public_key"
|
|
|
|
# Run locally
|
|
python main.py
|
|
```
|
|
|
|
### Docker
|
|
|
|
```bash
|
|
# Build image
|
|
docker build -t pravda .
|
|
|
|
# Run in daemon mode (Poller + Server)
|
|
docker run -d \
|
|
-e TRUTHSOCIAL_USERNAME="your_truthsocial_username" \
|
|
-e TRUTHSOCIAL_PASSWORD="your_truthsocial_password" \
|
|
-e DISCORD_WEBHOOK="your_webhook_url" \
|
|
-e DISCORD_APPLICATION_ID="your_app_id" \
|
|
-e DISCORD_PUBLIC_KEY="your_public_key" \
|
|
-v $(pwd)/data:/data \
|
|
-p 8080:8080 \
|
|
pravda
|
|
|
|
# One-off mode: relay a specific post
|
|
docker run --rm \
|
|
-e TRUTHSOCIAL_USERNAME="your_truthsocial_username" \
|
|
-e TRUTHSOCIAL_PASSWORD="your_truthsocial_password" \
|
|
-e DISCORD_WEBHOOK="your_webhook_url" \
|
|
pravda https://truthsocial.com/@realDonaldTrump/posts/123456789
|
|
```
|
|
|
|
## Architecture
|
|
|
|
The application runs two concurrent processes:
|
|
|
|
1. **The Poller**: Loops infinitely, checking for new posts. Processed posts are cached in SQLite to prevent duplicates.
|
|
|
|
2. **The Server**: A FastAPI instance listening on port 8080 to handle Discord interaction webhooks (button clicks).
|
|
|
|
### Interaction Endpoints
|
|
|
|
- `POST /interactions` - Discord interaction webhook handler
|
|
- `GET /health` - Health check endpoint
|
|
|
|
## Discord Components
|
|
|
|
Messages include interactive buttons:
|
|
|
|
- **Delete**: Removes the message (requires MANAGE_MESSAGES permission)
|
|
- **View Raw**: Shows the raw post JSON (ephemeral)
|
|
- **Original Post**: Links to the original Truth Social post
|
|
|
|
## Media Handling
|
|
|
|
- **Images**: Downloaded and attached directly
|
|
- **Videos**: Transcoded to H.264/AAC MP4 format
|
|
- Automatically scaled down if over 50MB
|
|
- Resolution reduced progressively (720p, then 480p) if needed
|
|
|
|
## Development
|
|
|
|
```bash
|
|
# Install dev dependencies
|
|
pip install -r requirements.txt
|
|
pip install black ruff mypy pytest
|
|
|
|
# Format code
|
|
black .
|
|
|
|
# Lint
|
|
ruff check .
|
|
|
|
# Type check
|
|
mypy .
|
|
|
|
# Run tests
|
|
pytest
|
|
```
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
pravda/
|
|
├── main.py # Application entrypoint
|
|
├── src/
|
|
│ ├── __init__.py
|
|
│ ├── database.py # SQLite operations
|
|
│ ├── discord.py # Discord webhook handling
|
|
│ ├── media.py # Media processing (ffmpeg)
|
|
│ ├── poller.py # Truth Social polling
|
|
│ └── server.py # FastAPI interaction handler
|
|
├── Dockerfile
|
|
├── entrypoint.sh
|
|
├── requirements.txt
|
|
├── pyproject.toml
|
|
└── .gitea/
|
|
└── workflows/
|
|
└── build-push.yaml
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|