---
title: "NGL Link Spam"
url: "https://ridwaanhall.com/projects/ngl-link-spam"
markdown: "https://ridwaanhall.com/projects/ngl-link-spam.md"
summary: "A modular Python command-line tool for sending messages to NGL links, with rate limiting, statistics and tests."
---

# NGL Link Spam

> A modular Python command-line tool for sending messages to NGL links, with rate limiting, statistics and tests.

- Category: Automation
- Status: Completed
- Started: April 16, 2025
- Built with: Python, pytest
- Live: https://ngl.link/
- Source: https://github.com/ridwaanhall/ngl-link-spamming

## About

### The problem

I wanted practice structuring a real Python tool: configuration, a clean package layout, request handling and tests, around a small and well-defined target.

### The approach

Version 2 is a package under src/ngl_spammer with a core request sender, generators for messages, devices, slugs and regions, utilities for config, logging and networking, and a command-line interface, with entry-point scripts and environment-based settings.

- Adaptive rate limiting that spaces requests out.
- Real-time statistics for progress and success rate.
- Error handling with retries, unit tests and written documentation.

### The result

A tidy example of turning a script into a maintainable package. Use it only on links you own, and respect the service's limits.

## Features

- **Modular Package**: A core sender, generators, utilities and a command-line interface.
- **Adaptive Rate Limiting**: Delays adjust to keep requests paced.
- **Live Statistics**: Progress and success rate while it runs.
- **Tests and Docs**: Unit tests and written documentation.

## Tags

NGL, Ngl Link, Ngl Spammer

## Elsewhere

- This page for people: https://ridwaanhall.com/projects/ngl-link-spam
- Index of every page as Markdown: [llms.txt](https://ridwaanhall.com/llms.txt)
