Advanced Configuration

Advanced settings for power users who want fine-grained control over Sentinel's behavior.

Configuration FilesCopy Anchor Link

Sentinel stores its configuration in JSON files that can be edited directly.

scraper_config.jsonCopy Anchor Link

Global scraper settings:

{
  "api_id": "YOUR_API_ID",
  "api_hash": "YOUR_API_HASH",
  "keywords": ["CA:", "contract:", "mint:"],
  "puzzle_solving": true,
  "audio_processing": true
}

chats_config.jsonCopy Anchor Link

Chat-specific monitoring configuration:

{
  "chats": [
    {
      "link": "https://t.me/groupname",
      "enabled": true,
      "keywords": ["specific", "keywords"]
    }
  ]
}

Changes to these files are picked up by the config server and synced to the scraper.

Config ServerCopy Anchor Link

The config server runs as a WebSocket server that bridges the Chrome Extension and the scraper engine. It starts automatically when you run START_SENTINEL.sh.

• Listens for configuration changes from the Extension
• Pushes updated settings to the scraper in real time
• No manual configuration needed

TDLib SettingsCopy Anchor Link

The Telegram Forwarder uses TDLib (tdjson.dylib on macOS, tdjson.dll on Windows). Advanced TDLib parameters can be configured for:

• Custom database directory
• Log verbosity level
• Proxy settings

Troubleshooting with LogsCopy Anchor Link

If you experience issues, check the scraper logs:

• Logs are output to the terminal where START_SENTINEL.sh is running
• Increase log verbosity by modifying the scraper configuration
• Common issues:
  • Auth errors: Re-enter credentials in the Extension
  • Connection drops: Check internet stability
  • Missing detections: Review keyword configuration

File StructureCopy Anchor Link

sentinel/
├── Extension/              # Chrome Extension
│   ├── manifest.json
│   ├── popup.html
│   └── ...
├── native-host/            # Native messaging host
│   ├── install.sh
│   └── ...
├── config_server            # WebSocket config server
├── telegram_forwarder       # Main scraper engine
├── tdjson.dylib             # TDLib (macOS)
├── scraper_config.json      # Global settings
├── chats_config.json        # Chat configuration
└── START_SENTINEL.sh        # Launch script