https://github.com/0xtbug/meowcount
MeowCount is a lightweight Flask app that leverages Discord OAuth2 to retrieve a user’s identity and guilds, then counts and displays how many servers the user belongs to.
https://github.com/0xtbug/meowcount
discord discord-bot discord-server discord-server-counter flask-application python
Last synced: 12 days ago
JSON representation
MeowCount is a lightweight Flask app that leverages Discord OAuth2 to retrieve a user’s identity and guilds, then counts and displays how many servers the user belongs to.
- Host: GitHub
- URL: https://github.com/0xtbug/meowcount
- Owner: 0xtbug
- Created: 2025-09-07T06:51:42.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-08T02:00:39.000Z (9 months ago)
- Last Synced: 2025-10-10T22:58:44.208Z (8 months ago)
- Topics: discord, discord-bot, discord-server, discord-server-counter, flask-application, python
- Language: HTML
- Homepage: https://meowcount.vercel.app
- Size: 16.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MeowCount
MeowCount is a minimal Flask web app that shows how many Discord servers (guilds) you’re in. It uses Discord OAuth2 to request the `identify` and `guilds` scopes, counts your servers from the Discord API, and displays the result. No database is required.
## Oneclick Deploy
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2F0xtbug%2Fmeowcount)
## Installation
### Local
1. Prerequisites: Python 3.11+.
2. Create `.env` with your Discord app credentials:
```bash
CLIENT_ID=your_discord_client_id
CLIENT_SECRET=your_discord_client_secret
REDIRECT_URI=http://localhost:3000
SECRET_KEY=replace_with_a_random_secret
PORT=3000
APP_MODE=dev # change to prod if production
```
3. Install and run:
```bash
python -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python run.py
```
### Docker
- With Compose (recommended):
```bash
docker compose up -d meowcount
docker compose logs -f meowcount
```
- Manual:
```bash
docker build -t meowcount .
docker run -d -p 3000:3000 --env-file .env --name meowcount meowcount
```
> App at http://localhost:3000
## Docker: Development
- Development service (`meowcount-dev`, auto-reload, bind mount):
```bash
docker compose up meowcount-dev
```
> App at http://localhost:3001
## Environment Notes
- `REDIRECT_URI` must match your Discord application redirect (e.g., `http://localhost:3000/auth` base is set via app logic).
- In production, set a strong `SECRET_KEY` and use HTTPS for the redirect URL.