Document Truth Social authentication requirement
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>
This commit is contained in:
2026-01-23 02:27:40 -05:00
parent cf234b0beb
commit 01d4ddc422

View File

@@ -18,6 +18,7 @@ A Python-based Dockerized service that monitors Truth Social feeds and relays po
- Python 3.12+ - Python 3.12+
- Docker (for containerized deployment) - Docker (for containerized deployment)
- ffmpeg (for video transcoding) - ffmpeg (for video transcoding)
- A **Truth Social account** (for API access)
- A Discord webhook URL - A Discord webhook URL
- A Discord application (for interaction components) - A Discord application (for interaction components)
@@ -25,11 +26,13 @@ A Python-based Dockerized service that monitors Truth Social feeds and relays po
| Variable | Description | Required | | 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_WEBHOOK` | Discord Webhook URL for posting messages | Yes |
| `DISCORD_APPLICATION_ID` | Discord Application ID for components | Yes | | `DISCORD_APPLICATION_ID` | Discord Application ID for components | Yes |
| `DISCORD_PUBLIC_KEY` | Public Key for verifying interaction signatures | Yes (if using interactions) | | `DISCORD_PUBLIC_KEY` | Public Key for verifying interaction signatures | Yes (if using interactions) |
| `POLL_INTERVAL` | Seconds between checks (default: 300) | No | | `POLL_INTERVAL` | Seconds between checks (default: 300) | No |
| `TRUTH_USER` | Target username (default: realDonaldTrump) | No | | `TRUTH_USER` | Target username to monitor (default: realDonaldTrump) | No |
| `DB_PATH` | Path to SQLite DB (default: /data/seen.db) | No | | `DB_PATH` | Path to SQLite DB (default: /data/seen.db) | No |
## Quick Start ## Quick Start
@@ -41,6 +44,8 @@ A Python-based Dockerized service that monitors Truth Social feeds and relays po
pip install -r requirements.txt pip install -r requirements.txt
# Set environment variables # Set environment variables
export TRUTHSOCIAL_USERNAME="your_truthsocial_username"
export TRUTHSOCIAL_PASSWORD="your_truthsocial_password"
export DISCORD_WEBHOOK="your_webhook_url" export DISCORD_WEBHOOK="your_webhook_url"
export DISCORD_APPLICATION_ID="your_app_id" export DISCORD_APPLICATION_ID="your_app_id"
export DISCORD_PUBLIC_KEY="your_public_key" export DISCORD_PUBLIC_KEY="your_public_key"
@@ -57,6 +62,8 @@ docker build -t pravda .
# Run in daemon mode (Poller + Server) # Run in daemon mode (Poller + Server)
docker run -d \ docker run -d \
-e TRUTHSOCIAL_USERNAME="your_truthsocial_username" \
-e TRUTHSOCIAL_PASSWORD="your_truthsocial_password" \
-e DISCORD_WEBHOOK="your_webhook_url" \ -e DISCORD_WEBHOOK="your_webhook_url" \
-e DISCORD_APPLICATION_ID="your_app_id" \ -e DISCORD_APPLICATION_ID="your_app_id" \
-e DISCORD_PUBLIC_KEY="your_public_key" \ -e DISCORD_PUBLIC_KEY="your_public_key" \
@@ -66,6 +73,8 @@ docker run -d \
# One-off mode: relay a specific post # One-off mode: relay a specific post
docker run --rm \ docker run --rm \
-e TRUTHSOCIAL_USERNAME="your_truthsocial_username" \
-e TRUTHSOCIAL_PASSWORD="your_truthsocial_password" \
-e DISCORD_WEBHOOK="your_webhook_url" \ -e DISCORD_WEBHOOK="your_webhook_url" \
pravda https://truthsocial.com/@realDonaldTrump/posts/123456789 pravda https://truthsocial.com/@realDonaldTrump/posts/123456789
``` ```