homarr/packages/api/src/router/widgets/media-server.ts

import { z } from "zod/v4";

import { mediaServerRequestHandler } from "@homarr/request-handler/media-server";

import { createManyWidgetIntegrationMiddleware } from "../../middlewares/integration";
import { PUBLIC_INTEGRATION_ERROR, settleIntegrationQueries } from "../../settle-integrations";
import { createTRPCRouter, publicProcedure } from "../../trpc";

export const mediaServerRouter = createTRPCRouter({
  getCurrentStreams: publicProcedure
    .meta({
      mcp: {
        enabled: true,
        description:
          "Get currently active streams from Plex/Jellyfin/Emby/Navidrome media servers. REQUIRED: integrationIds (array of media server integration IDs from integration_all), showOnlyPlaying (boolean — true to filter to actively playing streams only)",
      },
    })
    .concat(createManyWidgetIntegrationMiddleware("query", "mediaServer"))
    .input(z.object({ showOnlyPlaying: z.boolean() }))
    .query(async ({ ctx, input }) => {
      return await settleIntegrationQueries(
        ctx.integrations,
        async (integration) => {
          const { data } = await mediaServerRequestHandler
            .handler(integration, { showOnlyPlaying: input.showOnlyPlaying })
            .getDataAsync();
          return {
            integrationId: integration.id,
            integrationName: integration.name,
            integrationKind: integration.kind,
            sessions: data,
            error: undefined,
          };
        },
        {
          fallback: (integration) => ({
            integrationId: integration.id,
            integrationName: integration.name,
            integrationKind: integration.kind,
            sessions: [],
            error: PUBLIC_INTEGRATION_ERROR,
          }),
          throwOnAllFailures: true,
        },
      );
    }),
});