Sanara is a Discord bot made in C# having various features
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Sanara-UnitTests
SanaraV2
.gitignore
.gitmodules
LICENSE
README.md
SanaraV2.sln
appveyor.yml

README.md


Build status
CodeFactor

Sanara

Sanara is a Discord bot made in C#.

Her goal is to provide various functionalities, you can check them here.

I spent a lot of times working on her and I hope that her source code will be able to help some people as the source code of some others bots did for me.

Useful links

Commands
Official Discord server
Report an issue/Make a suggestion
Invitation link
Help for the translation

External libraries used

BooruSharp
Discord.Net
Google API DotNet
Opus, Sodium and FFmpeg
Raven-csharp
RethinkDb
VNDBSharp
youtube-dl

Please make note that the bot also collect and save the following datas:

About users: id of the highscore (when playing games)
About guilds: Guild preference (box prefix and language)
You can check the different stats about the bot here: https://zirk.eu/sanara.html#stats
You can also do the 'GDPR' command at any time to check the informations the bot have on you (and on the guild if you are the owner).

How to use Sanara by cloning the repository

  • First clone the repository like that: git clone --recurse-submodules https://github.com/Xwilarg/Sanara.git , that will allow you to also clone the translation submodule.
  • Then open SanaraV2.sln with Visual Studio
  • You'll need to create a 'Keys' folder near your executable (default location: bin/Debug/)
  • You then need to create at least a 'token.dat' file inside the Keys folder. It contains the token of your bot.
  • The last step is to go inside 'Sentences.cs' and change the ownerId value by your Discord id.
  • Then download RethinkDb and launch it
  • You can also create the following files in the 'Keys' folder:
    • Sanara-7430da57d6af.json (contain your json file to access to the Google Translate API)
    • URLShortenerAPIKey.dat (contain your key for the goo.gl API), youtubeAPIKey.dat (contain your key for the YouTube API)
    • ranven.dat (contain your url to use Sentry)
    • visionAPI.json (contain your json for the Google Vision API)
  • To use radio you will also need to add opus.dll, libsodium.dll, ffmpeg.exe and youtube-dl.exe near Sanara executable, you can download them here and here.
  • To use games, you will also need to add files to the 'Saves' folder (downloadable here):
    • AnimeTags.dat for the anime guess game
    • BooruTriviaTags.dat for the booru guess game
    • shiritoriWords.dat for the shiritori game