Bluebird monitors users on X and reports new posts via Discord.
Although not required, a Discord Webhook is recommended for notifications.
An X account is required. It is recommended to use a throwaway account due to use of the internal API.
Environment Variables:
LOG_LEVEL: Loguru severity level to write to the console.LOG_DISCORD_WEBHOOK_URL: Discord Webhook URL to receive log events.LOG_DISCORD_WEBHOOK_LEVEL: Minimum Loguru severity level to forward to Discord.USERS_ALL: Comma-separated list of X usernames to monitor for all posts.USERS_TOP: Comma-separated list of X usernames to monitor for top-level posts only.USERS_MEDIA: Comma-separated list of X usernames to monitor for media posts only.COOLDOWN_MIN_TIME: Minimum randomized cooldown time between checking for new posts (default is 60).COOLDOWN_MAX_TIME: Maximum randomized cooldown time between checking for new posts (default is 300).X_CSRF_TOKEN: CSRF Token obtained via request inspection on X.X_AUTH_TOKEN: Cookie Auth Token obtained via request inspection on X.X_BEARER_TOKEN: Authentication Bearer Token obtained via request inspection on X.DISCORD_WEBHOOK_URL: Discord Webhook URL to receive new post notifications.
Modify the following docker-compose.yml example file, then run docker compose up.
services:
bluebird:
container_name: bluebird
image: ethanchrisp/bluebird:latest
environment:
LOG_LEVEL: INFO
LOG_DISCORD_WEBHOOK_URL: https://discord.com/api/webhooks/YYYYYYYY/YYYYYYYY
LOG_DISCORD_WEBHOOK_LEVEL: WARNING
USERS_ALL: Mxtive,spectatorindex,Breaking911
USERS_TOP: X,XData
USERS_MEDIA: archillect
COOLDOWN_MIN_TIME: 60
COOLDOWN_MAX_TIME: 300
X_CSRF_TOKEN: XXXXXXXX
X_AUTH_TOKEN: XXXXXXXX
X_BEARER_TOKEN: XXXXXXXX
DISCORD_WEBHOOK_URL: https://discord.com/api/webhooks/XXXXXXXX/XXXXXXXX
restart: unless-stoppedBluebird is built for Python 3.12 or greater.
- Install required dependencies using Poetry:
poetry install --no-root - Rename
.env.exampleto.env, then provide the environment variables. - Start Bluebird:
python bluebird.py