Skip to content

Latest commit

 

History

53 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

!ntro

Quickly find people’s introduction messages in Discord servers.

Note

I am running my own instance of this bot you can invite to your servers and use freely.

Please report any bugs, oversights, issues, or suggestions to @pixtelslinks on discord.

invite link

Features

  • Automatic message scraping.
  • Multiple scraping modes: oldest, newest, longest, or a simple "smart" heuristic.
  • Lookup by mention, username, or ID; use me to fetch your own intro.

Setup (personal use)

  1. Clone repository:
git clone https://github.com/pixtelslinks/intro-bot.git
cd intro-bot
  1. Install dependencies:
npm install
  1. Create a .env file in the project root with your Discord token:
DISCORD_TOKEN=discord-bot-token
  1. Run the bot with pm2 (recommended for background processes):
npx pm2 start ecosystem.config.js
  1. Stop the bot:
npx pm2 stop ecosystem.config.js

Commands

Configuration

These require the 'Manage Channels' privilege to use.

  • Configure the bot (after inviting it to your server):
!ntro config
  • Add an intro channel by mention or ID:
!ntro config channel [#channel|channelID]
  • Set scraping mode:
!ntro config mode [first|last|largest|smart]

Modes explained:

  • first — choose each user’s oldest message in the configured channels.
  • last — choose each user’s most recent message.
  • largest — choose the longest message by character count.
  • smart — prefer recent messages that are larger than the average (heuristic).

Usage

  • Look up any user by mention, username, or ID:
!ntro @user
!ntro username
!ntro 123456789012345678
  • To fetch your own intro, use:
!ntro me
  • To re-cache your intro:
!ntro update
  • To override your intro with a specific message:
!ntro override message-link
  • To clear your message override & re-cache:
!ntro update force
  • Update all messages in a server (requires privileges)
!ntro update all

Development

  • After installing locally with the setup instructions, run the project:
npx nodemon --ignore '*.json'

Contributing

PRs and issues are welcome. Keep changes focused and add tests where appropriate.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages