Katsucord Selfbot

Katscord is a Discord Selfbot built with discord.js-selfbot-v13

Warning

Using selfbots violates Discord's Terms of Service. Your account risks permanent suspension. Use at your own risk.

Risks & Compliance

Caution

Selfbots are against Discord's Terms of Service. Running Katsucord may result in warnings, temporary locks, or permanent account deletion.

Caution

Auto-questing is especially risky. The !quest command automatically progresses and claims Discord Quests. This is self-bot abuse and can flag your account immediately. Use with extreme caution.

Important

This project is provided for educational purposes only. You are responsible for any action Discord takes against your account.

Features

• Music & video playback (YouTube, Spotify, local files)
• Adaptive video streaming (auto, low, medium, high quality)
• Save, load, and manage queues as named playlists
• Pluggable storage backend: JSON or SQLite
• TikTok downloader (video, slideshow, search by keyword)
• Chatex AI integration
• Discord Quest auto-completion (!quest)
• Per-guild voice/text channel targets
• Modular plugin & command system with cooldowns and guards
• Owner-only eval and exec for live debugging
• Production ready with PM2

Requirements

• Node.js 20 or newer
• ffmpeg and yt-dlp available on PATH
• A Discord user token (selfbot)

Installation

1. Clone the repository

git clone https://github.com/nat9h/Katscord.git
cd Katscord

2. Install dependencies

npm install

3. Configure environment variables

cp .env.example .env

Then edit .env:

# Required
USER_TOKEN=""                  # your Discord user token

# Optional Spotify (Client Credentials Flow)
SPOTIFY_CLIENT_ID=
SPOTIFY_CLIENT_SECRET=

# Optional runtime overrides
COOKIES_PATH=./cookies.txt     # for yt-dlp authenticated downloads
SETTINGS_PATH=./data/settings.json
OWNER_IDS=                     # comma-separated Discord user IDs

# Storage backend for playlists
# JSON   = file-per-playlist under ./data/playlists/ (default)
# SQLite = single ./data/playlists.db file
DB=JSON

Running

Development (watch mode)

npm run dev

Production

npm start

With PM2

npm run pm2

Lint and format

npm run lint        # check
npm run lint:fix    # auto-fix
npm run format      # prettier

Configuration at runtime

Most settings are managed in chat through commands. Run !help to see the full list. A few common ones:

!config bot <voiceChannelId> [textChannelId]
!setprefix <prefix>
!addowner <userId>
!play <query|url|path> [-audio|-video] [-quality auto|low|medium|high]
!playlist save|load|list|show|add|remove|rename|delete
!tiktok <url|query>
!quest login <token>
!quest list
!quest start <n|all>
!quest stop <n|all>
!quest redeem <n>

License

This project is licensed under the MIT License — see the LICENSE file for details.