Skip to content

Repository files navigation

Discord.Net.AdminDashboard

Discord.Net.AdminDashboard

NuGet CI License

One-line embedded admin dashboard for your Discord.NET bot.
Local web UI with guild stats, job management, and live logs.


Features

  • Overview — guild count, users, uptime, CPU/memory, latency
  • Guilds — list all servers with member count, online users, channels
  • Jobs — view and cancel scheduled jobs (requires Discord.Net.Scheduler)
  • Live Logs — real-time streaming via SignalR, filterable log viewer
  • Zero config — runs as IHostedService alongside your bot
  • No external dependencies — pure ASP.NET Core Minimal API + SignalR

Installation

dotnet add package Discord.Net.AdminDashboard

Quick Start

using Discord.Net.AdminDashboard.Extensions;
using Discord.Net.Scheduler.Extensions;

var host = Host.CreateDefaultBuilder(args)
    .ConfigureServices((ctx, services) =>
    {
        services.AddSingleton(new DiscordSocketClient(...));
        services.AddDiscordScheduler()
                .AddJobStore<InMemoryJobStore>();

        services.AddAdminDashboard(options =>
        {
            options.Port = 5000;
        });
    })
    .Build();

await host.RunAsync();
// Dashboard available at http://localhost:5000

With custom port

services.AddAdminDashboard(port: 8080);

With configuration delegate

services.AddAdminDashboard(options =>
{
    options.Port = 5000;
    options.AccessToken = "my-secret"; // optional auth
});

Pages

Route Page
/ Overview dashboard with stats cards
/guilds.html List of guilds with member counts
/jobs.html Scheduled jobs table with cancel action
/logs.html Live log stream via SignalR

API Endpoints

Method Route Description
GET /api/stats Bot statistics
GET /api/guilds Guild list
GET /api/jobs Scheduled jobs
POST /api/jobs/{id}/cancel Cancel a job

Requirements

  • .NET 8.0+
  • Discord.NET 3.20.1+
  • Discord.Net.Scheduler 1.0.0+ (for job management features)

Dependencies

This package depends on:

  • Discord.Net.WebSocket (3.20.1) — for accessing DiscordSocketClient
  • Discord.Net.Scheduler (1.0.0) — for IJobStore and JobScheduler

Screenshots

(screenshots coming soon)

License

MIT

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages