ethanchrisp/callsign repository overview

⁠Callsign

Callsign monitors your public IP address and notifies when it changes.

⁠Setup

A Discord Webhook⁠ is recommended for notifications.

Regardless of your chosen setup method, Callsign is intended for use with a task scheduler, such as cron⁠.

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.
• DISCORD_WEBHOOK_URL: Discord Webhook⁠ URL to receive IP address change notifications.
• SIMPLE_MODE: Omit all extra information from the Discord embed notification other than the IP address. Optional, default False.

⁠Docker (Recommended)

Modify the following compose.yaml example file, then run docker compose up.

services:
  callsign:
    container_name: callsign
    image: ethanchrisp/callsign:latest
    environment:
      LOG_LEVEL: INFO
      LOG_DISCORD_WEBHOOK_URL: https://discord.com/api/webhooks/YYYYYYYY/YYYYYYYY
      LOG_DISCORD_WEBHOOK_LEVEL: WARNING
      DISCORD_WEBHOOK_URL: https://discord.com/api/webhooks/XXXXXXXX/XXXXXXXX

⁠Standalone

Callsign is built for Python 3.12⁠ or greater.

1. Install required dependencies using uv⁠: uv sync
2. Rename .env_example to .env, then provide the environment variables.
3. Start Callsign: python callsign.py