Discord Analyst

📈 Gives you precisions you never asked for.

All commands

* %help (command) - info about commands
* %info - version and uptime
* %scan - full analysis
* %freq - frequency analysis
* %compo - composition analysis
* %pres - presence analysis
* %repeat - repeat last analysis (adding supplied arguments)
* %mobile - fix @invalid-user for last command but mentions users
* %gdpr - displays GDPR information
* %find - find specific words or phrases (you can use quotes to add spaces in queries, backticks define regexes)
  * arguments:
    * top - rank users for these queries
* %first - read first message (add text to filter like %find)
  * arguments:
    * image - pull an image instead of a message
    * spoiler:allow/only - allow spoiler images
* %rand - read a random message (add text to filter like %find)
  * arguments:
    * image - pull an image instead of a message
    * spoiler:allow/only - allow spoiler images
* %last - read last message (add text to filter like %find)
  * arguments:
    * image - pull an image instead of a message
    * spoiler:allow/only - allow spoiler images
* %emojis - rank emojis by their usage
  * arguments:
    * <n> - top <n> emojis, default is 20
    * all - list all common emojis in addition to this guild's
    * members - show top member for each emoji
    * sort:usage/reaction - other sorting methods
* %mentions - rank mentions by their usage
  * arguments:
    * <n> - top <n> mentions, default is 10
    * all - show role/channel/everyone/here mentions
* %mentioned - rank specific user mentions by their usage
  * arguments:
    * <n> - top <n> mentions, default is 10
* %msg - rank users by their messages
  * arguments:
    * <n> - top <n> messages, default is 10
* %chan - rank channels by their messages
  * arguments:
    * <n> - top <n> channels, default is 10
* %react - rank users by their reactions
  * arguments:
    * <n> - top <n> messages, default is 10
* %words - (BETA) rank words by their usage
  * arguments:
    * <n> - words containings <n> or more letters, default is 3
    * <n2> - top <n2> words, default is 10
* %cancel - cancel current analysis (not launched with fast)

* Common arguments:
    * @member/me: filter for one or more member
    * #channel/here: filter for one or more channel
    * <date1> - filter after <date1>
    * <date2> - filter before <date2>
    * all/everyone - include bots messages
    * fast: only read cache
    * fresh: does not read cache
    * nsfw:allow/only - allow messages from nsfw channels
    * mobile/mention: mentions users (fix @invalid-user bug)

(Sample dates: 2020 / 2021-11 / 2021-06-28 / 2020-06-28T23:00 / today / week / 8days / 1y)

Running this bot

1. Install requirements

pip3 install -r requirements.txt

2. Make a .env file as following

#.env
DISCORD_TOKEN=<bot token from discordapp.com/developers>

3.Invite bot in your discord server

Generate and use the OAuth2 link in discordapp.com/developers to invite it.

You will need:

Scopes:
- bot
Bot Permissions:
- View Channels
- Send Messages
- Read Message History

4. Launch bot

python3 src/main.py

Recommended permissions

View Channels
Read Message History
Send Messages

On large servers, you should disable "Send Messages" and enable it on an read-only channel where only administrators can launch commands. The bot can't be triggered elsewhere if it can't answer.

Already hosted bot

Changelog

v1.17
- compliency with 30 days data keeping policy and data encryption
- improvements and bug fix
v1.16
- %freq graph graph hours frequency along the week
- uses discord new time format
- %freq now shows quietest day of week and hour of day
- improvements and bug fix
v1.15
- nsfw:allow/only filter nsfw channels
- %find can use regexes
- %first, %rand and %last can be filter with specific keywords
- %first, %rand and %last can pull images
- bug fix
v1.14
- mobile/mention arg to fix mobile bug
- %repeat, %mobile to repeat commands
- more scan: %find
- bug fix
v1.13
- improved scan %words
- remove old and unused logs at start and guild leaving
- GDPR disclaimer before scanning
- start and stop dates
- bug fix and improvements
v1.12
- more scans: %words
- concurrent fast analysis
- assume fast if last analysis is fresh
- better memory handling
- bug fix
v1.11
- more scans: %first, %rand, %last
- streak computing in %pres
v1.10
- multithreading for queries
- bug fix
v1.9:
- all/everyone to include bots in scans
- fresh to not use previously cached data
- bug fix
v1.8:
- more scans: %msg, %chan
- bug fix
v1.7:
- emojis percents
- emojis other sorting
- mentions/mentioned ranking
- %cancel
v1.6:
- more scans: %scan, %freq, %compo, %pres
- huge bug fix
v1.5:
- top emojis
- bug fix
v1.4:
- integrate miniscord
- insane speed with bot-side logging
- bug fix
v1.3: revert to v1.1 and update requirements
v1.2: don't quit on occasional exception
v1.1:
- coma separator for big numbers
- history loading by chunks for big channels (performance increase)
- bug fix
v1.0: stable release

Klemek / discord-analyst