news-bot

A LXMFy News Bot for the Reticulum Network. Get your daily RSS full-text feeds with instant news access and optional cryptographic signature verification.

Features

Instant News: Type news to get the latest headlines from default feeds immediately
RSS Feed Subscriptions: Subscribe to any RSS feed with full-text extraction
Scheduled Updates: Automatic delivery based on your timezone and preferred schedule
Feed Categories: Pre-configured categories like news, military, cybersecurity, and science
Admin Commands: Database backup/restore, statistics, and user management

Installation

pip install lxmfy-news-bot

pipx install lxmfy-news-bot

Git:

pipx install git+https://github.com/lxmfy/news-bot.git

The bot will store its data in ~/.local/share/lxmfy-news-bot/

Usage

lxmfy-news-bot

Configuration

The bot supports various environment variables for customization. See .env-example for a complete list of all available configuration options.

Basic Configuration

BOT_NAME: Bot display name (default: "LXMFy News Bot")
BOT_ANNOUNCE: Announcement interval in seconds (default: 600)
BOT_PREFIX: Command prefix (default: "")
BOT_ADMINS: Comma-separated list of admin hashes

Security & Signatures

BOT_SIGNATURE_VERIFICATION_ENABLED: Enable cryptographic signature verification (default: false)
BOT_REQUIRE_MESSAGE_SIGNATURES: Reject unsigned messages when verification is enabled (default: false)

Performance & Limits

BOT_RATE_LIMIT: Messages per minute limit (default: 8)
BOT_COOLDOWN: Cooldown period in seconds (default: 1)
BOT_MAX_WARNINGS: Max warnings before timeout (default: 3)
BOT_WARNING_TIMEOUT: Warning timeout in seconds (default: 300)

Storage & Data

DATA_DIR: Data directory path (default: platform-specific)
BACKUP_DIR: Backup directory path (default: data/backups)
CONFIG_DIR: Configuration directory path (default: newsbot/)
FEEDS_CONFIG: Custom feeds YAML file path

Docker

docker run -d \
  -v /path/to/data:/app/data \
  -v /path/to/backups:/app/backups \
  -v /path/to/.reticulum:/root/.reticulum \
  -e BOT_NAME="My News Bot" \
  -e BOT_ADMINS="admin1hash,admin2hash" \
  -e BOT_SIGNATURE_VERIFICATION_ENABLED="true" \
  ghcr.io/lxmfy/news-bot:latest

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lxmfy_news_bot-0.7.0.tar.gz (13.3 kB view details)

Uploaded Nov 13, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

lxmfy_news_bot-0.7.0-py3-none-any.whl (14.5 kB view details)

Uploaded Nov 13, 2025 Python 3

File details

Details for the file lxmfy_news_bot-0.7.0.tar.gz.

File metadata

Download URL: lxmfy_news_bot-0.7.0.tar.gz
Upload date: Nov 13, 2025
Size: 13.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for lxmfy_news_bot-0.7.0.tar.gz
Algorithm	Hash digest
SHA256	`7e1b9ed6ca501d8b6f591650bc906de0dd95c588f13a315bfa692547ee42569d`
MD5	`8b050b9156b4ca5ae5b6f3882eefd925`
BLAKE2b-256	`80b56acc6751983a74b3b9473eeefd8e82abad250b8c1ef651a2716a818e1662`

See more details on using hashes here.

Provenance

The following attestation bundles were made for lxmfy_news_bot-0.7.0.tar.gz:

Publisher: publish.yml on lxmfy/news-bot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: lxmfy_news_bot-0.7.0.tar.gz
- Subject digest: 7e1b9ed6ca501d8b6f591650bc906de0dd95c588f13a315bfa692547ee42569d
- Sigstore transparency entry: 699292912
- Sigstore integration time: Nov 13, 2025
Source repository:
- Permalink: lxmfy/news-bot@f938b16043d59ac866913513ffa596846a63a673
- Branch / Tag: refs/tags/v0.7.0
- Owner: https://github.com/lxmfy
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@f938b16043d59ac866913513ffa596846a63a673
- Trigger Event: push