Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

den0bot - osu!-related telegram chat bot

Build status CodeFactor

Uses Telegram.Bot, SQLite-net, Newtonsoft.Json, OppaiSharp, xFFmpeg.NET, Highcharts.


Empty config will generate near the app with the name config.json.

  /* Requiured */
  /* list of modules to use */
  "Modules": [

  /* Telegram bot token, can be obtained on */
  "TelegamToken": "123:abc",

  /* Bot owner username */
  "OwnerUsername": "StanRiders",

  /* Optional */
  /* enables sending random strings instead of commands sometimes (strings can be set in locale file) */
  "UseEvents": false,

  /* Cat API token, can be obtained on */
  "CatToken": ""

Installing modules

Module files must be placed into ./Modules folder, module config will generate in the same folder with modulename.json.

Built-in Modules

  • ModAnalytics: Saves various message data into the sqlite database.
  • ModBasicCommands: Self-explanatory.
  • ModCat: Sends random cat image when it finds "cat" in a message.
  • ModGirls: Stores every picture sent with a tag, sends random pictures from DB with voting buttons.
  • ModRandom: Various rng-based commands.
  • ModSanta: Secret santa handling.
  • ModShmalala: Generates messages using Markov chain.
  • ModThread: Returns thread link and messages from


  • ModBeatmap: Finds in messages and returns map info with PP values.
  • ModMaplist: Sends random map from a google spreadsheet.
  • ModMatchFollow: Sends updates about ongoing multiplayer match.
  • ModProfile: Finds in messages and returns player info and topscores.
  • ModRecentScores: Returns player's recent/map scores with PP info.
  • ModYoutube: Checks youtube channel for new videos and sends them to every chat that enabled subscription.


Empty config will generate in the Modules directory with the name osuconfig.json.

  /* Requiured */
  /* osu!API v1 token, can be obtained on */
  "osuToken": "",

  /* osu!API v2 client ID, can be obtained on */
  "osuClientId": "",

  /* osu!API v2 client secret, can be obtained on */
  "osuClientSecret": "",

  /* Google API token, can be obtained on */
  "GoogleAPIToken": "",

  /* Youtube channel for chat subscriptions */
  "YoutubeChannelId": null,

Visual Studio 2019, .NET 5.0