## 📊 CounterDiscord — Server Analytics Bot

CounterDiscord tracks everything that happens in your Discord server and turns it into beautiful, detailed visualizations. No setup required — just invite the bot and it starts collecting data immediately.

---

### 📈 What It Tracks
- **Messages** — every message per user, channel, and time
- **Emojis** — custom and standard emoji usage in messages and reactions
- **Voice channels** — time spent in VC per user
- **Words & phrases** — configurable keyword tracking
- **Replies & mentions** — who interacts with who

---

### 🎨 Commands

**Stats**
- `/leaderboard` — top message senders bar chart
- `/activity` — server activity heatmap by hour and day of week
- `/vc-leaderboard` — who spends the most time in voice channels
- `/top-emojis` — most used emojis server-wide
- `/dashboard` — full server overview with all stats in one image

**Lookup**
- `/word <term>` — track how often a word or phrase is used
- `/emoji <emoji>` — see who uses a specific emoji the most

**ML Insights**
- `/predict-active` — predict which members will be active today
- `/user-archetypes` — cluster members by behavior (Power User, Lurker, Weekend Warrior, etc.)
- `/activity-spikes` — detect unusual activity spikes in your server
- `/emoji-trends` — see which emojis are rising or falling in usage

**Configuration** *(Manage Server required)*
- `/track-word <word>` — add a word to the tracking list
- `/untrack-word <word>` — remove a tracked word
- `/ignore-channel <#channel>` — stop tracking a channel

---

### 🤖 Machine Learning
CounterDiscord uses real ML models to surface insights you can't get from raw numbers:
- **Activity prediction** — identifies members likely to be active based on historical patterns
- **Behavior clustering** — groups your members into archetypes automatically
- **Anomaly detection** — flags unusual activity spikes that might indicate events, raids, or drama
- **Emoji trends** — linear regression to identify rising and falling emoji usage

---

### 🎨 Chart Style
All charts use a custom midnight blue dark theme designed to look great in Discord. No default matplotlib grey here.

---

### 🔒 Privacy
CounterDiscord only collects message metadata (who sent what, when, and where) — never message content except for configured tracked words. Data is stored per-server and never shared. You can stop tracking any channel with `/ignore-channel`.

---

### 🛠️ Self-Hostable
CounterDiscord is fully open source. If you want full control over your data, you can host your own instance.
→ github.com/caicedogamer/CounterDiscord

counter-stats

Track messages, emojis, voice & reactions. Beautiful charts, ML insights & full server dashboard.

Votando em counter-stats

Quer nos ajudar?