An open API service indexing awesome lists of open source software.

https://github.com/itsamirhn/linktrkr

Simple Link Tracker Telegram Bot
https://github.com/itsamirhn/linktrkr

bot golang telegram tracker url

Last synced: about 1 year ago
JSON representation

Simple Link Tracker Telegram Bot

Awesome Lists containing this project

README

          

# LinkTrkr
![Telegram Bot](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white&label=%40LinkTrkrBot)

### Have you ever sent someone a URL via email or message and wondered:
*"Did they click on it?"*
Now, you don’t have to wonder anymore! With **LinkTrkr**, you can easily wrap any long URL into a trackable link and get notified when someone clicks on it.

---

## 🔥 **Why LinkTrkr?**

- **Real-Time Click Notifications:** Get instantly notified when your link is clicked.
- **No Database, Maximum Privacy:** No database is used, ensuring your data is not stored anywhere. This makes it **fast** and **lightweight** too!
- **IP & User-Agent Insights:** Gain useful insights such as the **IP address** and **user-agent** of the user who clicked your link.
- **Simple and Dependency-Free:** No complex setup or extra dependencies—just pure functionality.
- **Inline Support:** Quickly generate trackable links right inside Telegram chats.

---

## 🚀 **How to Use LinkTrkr?**

### 🌟 Step 1: Start the Bot
Before using the bot inline, make sure to start the bot by sending it a message. This is necessary to allow the bot to send notifications to you. Try it here: [t.me/LinkTrkrBot](https://t.me/LinkTrkrBot).

### 🌟 Step 2: Use Inline in Telegram
1. Open any Telegram chat.
2. Type: `@LinkTrkrBot [Your URL]`.
3. Instantly get a trackable link like this: `https://trkr.amirhn.com/r/eyJhbG...`

Example:
```
@LinkTrkrBot https://google.com
```

The bot will generate a wrapped link that you can share and track.

---

### ✂️ **Shorten Your Wrapped Link**
While the generated link provides tracking capabilities, it may still be long. If you prefer a shorter link, you can use any URL shortening service (e.g., [bit.ly](https://bit.ly), [tinyurl.com](https://tinyurl.com)) to further shorten the wrapped URL.

---

### 🛡️ **Privacy-Focused**
Since LinkTrkr doesn’t use a database, your data remains yours. No link history, no data tracking—just the notifications and insights you need.

---

### 🤖 Start Now
Ready to track your links and gain valuable insights? Give it a try at [t.me/LinkTrkrBot](https://t.me/LinkTrkrBot).

---

## 🛠️ Development
1. Create a bot using [BotFather](https://t.me/BotFather) and paste the token in the `.env` file (or export it as `BOT_TOKEN` environment variable).
2. Clone the repository.
3. Install [Task](https://taskfile.dev/installation/) on your system.
4. Run `task serve` to start the bot.

## 👮🏻 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.