watcher/sample.env at main · smarks/watcher · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
# Sample Environment Configuration for URL Watcher
# Copy this file to .env and fill in your actual values

# ============================================
# SMS NOTIFICATION CONFIGURATION
# ============================================
# Choose ONE of the following SMS providers and configure it
# All providers require the SMS_PHONE_NUMBER to be set

# Phone number to receive SMS notifications (required)
# Format: Include country code with + prefix (e.g., +1 for US/Canada)
SMS_PHONE_NUMBER=+1234567890

# ============================================
# Option 1: TextBelt (Simple, pay-per-text)
# ============================================
# TextBelt is a simple SMS API that charges per text message
# Get your API key from: https://textbelt.com/
# Pricing: https://textbelt.com/purchase
# Test with 'textbelt' as key for 1 free SMS per day
TEXTBELT_API_KEY=your_textbelt_api_key_here

# ============================================
# Option 2: Vonage (formerly Nexmo)
# ============================================
# Vonage offers robust SMS capabilities with global coverage
# Sign up at: https://www.vonage.com/communications-apis/
# Dashboard: https://dashboard.nexmo.com/
VONAGE_API_KEY=your_vonage_api_key_here
VONAGE_API_SECRET=your_vonage_api_secret_here
# From number can be a phone number or alphanumeric sender ID (max 11 chars)
VONAGE_FROM_NUMBER=URLWatcher

# ============================================
# Option 3: ClickSend
# ============================================
# ClickSend provides SMS, email, and other communication services
# Sign up at: https://www.clicksend.com/
# Dashboard: https://dashboard.clicksend.com/
# Note: Requires 'pip install clicksend-client'
CLICKSEND_USERNAME=your_clicksend_username_here
CLICKSEND_API_KEY=your_clicksend_api_key_here
# Source is the sender name that appears on the SMS (max 11 chars)
CLICKSEND_SOURCE=URLWatcher

# ============================================
# USAGE NOTES
# ============================================
# 1. Copy this file to .env: cp sample.env .env
# 2. Choose ONE SMS provider and fill in its credentials
# 3. Update SMS_PHONE_NUMBER with your actual phone number
# 4. Test your configuration: python test_sms_notifications.py
# 5. Run the watcher with SMS: python url_watcher.py <URL> --sms
#
# Security: Never commit .env to version control!
# The .env file should be in .gitignore