Giter Club home page Giter Club logo

discord-soundboard's Introduction

Discord Soundboard

A soundboard bot for Discord using the unofficial Discord.NET API. The bot responds to mentions or direct messages and plays sound effects in a specific voice channel.

License

Apache License 2.0

Caveats

This bot was written for a small circle of friends and suffers from a lack of documentation, no warranty of any kind, and is not representative of quality work.

Supported Platforms

  • Windows

Dependencies

  • Discord.Net
  • Discord.Net.Audio
  • Discord.Net.Modules
  • Discord.Net.Commands
  • NAudio
  • Opus

Features

  • File Formats
  • RIFF Wave (PCM)
  • Plays sound effects with simple commands
  • Resamples sound effects during playback so users don't have to ensure files have a specific sample rate, channel count, or bit-depth
  • Accepts attachments in messages and downloads them for use as a sound effect

Configuration

The default filename for the configuration file is soundbot.cfg

Key Description Default
name Bot's name used for display purposes Discord Soundboard
email Bot's account e-mail address n/a
password Bot's account password n/a
path.effects Path for sound effects Effects
path.database Path for bot database file Data/soundbot.db
database.save.interval Interval (ms) the database is persisted to disk 15000
status The 'playing game' status message to display Soundboard
voice.channel The voice channel for the bot to connect to n/a
voice.bitrate The voice bitrate to use (in bits) 64
repository.file.maximumSize Maximum file size for sound effects (in bytes) 2097152

Configuration Sample

email = [email protected]
password = example
path.effects = Effects
status = example
voice.channel = example
voice.bitrate = 128

Commands

Assuming the bot's handle is soundbot:

list

Lists all sound effects registered by the bot.

@soundbot list

play

Plays a registered sound effect. This is the default command.

@soundbot <effect>
@soundbot boop

stats

Presents various statistics collected over time.

stat description
topusers prints list of users with the longest play durations
topsounds prints list of sounds with the most plays
totals prints total number of sounds, number of plays, and total duration played
@soundbot stats <stat>
@soundbot stats totals

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.