docs: add tracearr integration (#494)

Author: StrandedTurtle

docs/integrations/tracearr/index.mdx

@@ -0,0 +1,38 @@
+---
+title: 'Tracearr'
+description: "Tracearr is a comprehensive media monitoring solution that tracks streams, user activity, and policy violations in your media server (including Plex, Jellyfin, Emby)."
+hide_title: true
+---
+
+import { IntegrationHeader } from '@site/src/components/integrations/header';
+import { IntegrationCapabilites } from '@site/src/components/integrations/widgets';
+import { AddingIntegration } from '@site/src/components/integrations/adding';
+import {IntegrationSecrets} from '@site/src/components/integrations/secrets';
+import { tracearrIntegration } from '.';
+import { tracearrWidget } from '@site/docs/widgets/tracearr';
+
+
+<IntegrationHeader
+  integration={tracearrIntegration}
+  categories={['Media Monitoring']}
+/>
+
+### Widgets & Capabilities
+<IntegrationCapabilites
+    items={[
+        { widget: tracearrWidget }
+    ]}
+/>
+
+### Adding the integration
+<AddingIntegration />
+
+### Secrets
+<IntegrationSecrets secrets={[{
+    credentials: ['apiKey'],
+    steps: [
+        <span>
+            In Tracearr, go to <strong>Settings → API</strong> and generate or copy your API key.
+        </span>
+    ]
+}]} />

docs/integrations/tracearr/index.ts

@@ -0,0 +1,8 @@
+import { IntegrationDefinition } from '@site/src/types';
+export const tracearrIntegration: IntegrationDefinition = {
+  name: 'Tracearr',
+  description:
+    'Tracearr is a comprehensive media monitoring solution that tracks streams, user activity, and policy violations in your media server.',
+  iconUrl: 'https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons@master/svg/tracearr.svg',
+  path: '../../integrations/tracearr',
+};

docs/widgets/tracearr/img/streams-and-stats.png

@@ -0,0 +1,52 @@
+---
+title: 'Tracearr'
+description: 'Monitor media server streams, user activity, and policy violations.'
+hide_title: true
+---
+
+import { AddingWidget } from '@site/src/components/widgets/adding';
+import { WidgetConfig } from '@site/src/components/widgets/configuration';
+import { WidgetHeader } from '@site/src/components/widgets/header';
+import { WidgetIntegrations } from '@site/src/components/widgets/integrations';
+import { tracearrWidget } from '.';
+import { tracearrIntegration } from '@site/docs/integrations/tracearr';
+
+
+<WidgetHeader
+  widget={tracearrWidget}
+  categories={['Media Monitoring']}
+/>
+
+The Tracearr widget provides a real-time monitoring dashboard for your media server activity. It displays active streams, user statistics, recent watching history, and policy violations.
+
+### Sections
+
+| Section | Description |
+|---|---|
+| **Stats Bar** | Displays Active Streams, Total Users, Transcode Count, and Total Bandwidth at a glance. |
+| **Active Streams** | Shows currently playing media with poster art, user info, progress bar, resolution, and transcoding status (Direct Play or Transcode). |
+| **Recent Activity** | A paginated list of watching history with user avatars and watched status. |
+| **Violations** | Alerts for policy violations (e.g., concurrent stream limits) with severity levels. |
+
+### Screenshots
+
+import widgetOverview from './img/widget-overview.png';
+import streamsAndStats from './img/streams-and-stats.png';
+
+<div className="flex flex-col gap-2">
+  <img src={widgetOverview} alt="tracearr-widget-overview" width={128 * 4} />
+  <img src={streamsAndStats} alt="tracearr-streams-and-stats" width={128 * 4} />
+</div>
+
+### Adding the widget
+
+<AddingWidget />
+
+### Supported Integrations
+
+<WidgetIntegrations items={[{
+  integration: tracearrIntegration,
+}]} />
+
+### Configuration
+<WidgetConfig configuration={tracearrWidget.configuration} />

docs/widgets/tracearr/img/widget-overview.png

@@ -0,0 +1,37 @@
+import { WidgetDefinition } from '@site/src/types';
+import { IconActivity } from '@tabler/icons-react';
+
+export const tracearrWidget: WidgetDefinition = {
+  icon: IconActivity,
+  name: 'Tracearr',
+  description: 'Monitor media server streams, user activity, and policy violations.',
+  path: '../../widgets/tracearr',
+  configuration: {
+    items: [
+      {
+        name: 'Show Streams',
+        description: 'Display the active streams section.',
+        values: { type: 'boolean' },
+        defaultValue: 'yes',
+      },
+      {
+        name: 'Show Stats',
+        description: 'Display the stats bar with active streams, total users, transcode count, and bandwidth.',
+        values: { type: 'boolean' },
+        defaultValue: 'yes',
+      },
+      {
+        name: 'Show Recent Activity',
+        description: 'Display the recent activity list with user watch history.',
+        values: { type: 'boolean' },
+        defaultValue: 'yes',
+      },
+      {
+        name: 'Show Violations',
+        description: 'Display the violations alerts for policy breaches.',
+        values: { type: 'boolean' },
+        defaultValue: 'yes',
+      },
+    ],
+  },
+};