chore(release): 1.30.0 [skip ci]

chore(release): automatic release v1.30.0
fix(security): upgrade eslint-config-prettier to latest version without malicious code
2025-07-21 08:43:16 +00:00 · 2025-07-21 08:42:26 +00:00 · 2025-07-21 07:54:13 +00:00 · 2025-07-21 01:25:53 +00:00 · 2025-07-20 15:21:47 +00:00 · 2025-07-20 17:13:57 +02:00
171 changed files with 2553 additions and 1070 deletions
@@ -31,6 +31,8 @@ body:
      label: Version
      description: What version of Homarr are you running?
      options:
+        - 1.29.0
+        - 1.28.1
        - 1.28.0
        - 1.27.0
        - 1.26.0
@@ -1 +1 @@
-22.17.0
+22.17.1
@@ -1,3 +1,38 @@
+## [1.30.0](https://github.com/homarr-labs/homarr/compare/v1.29.0...v1.30.0) (2025-07-21)
+
+### Features
+
+* **infra:** add external redis ([#3639](https://github.com/homarr-labs/homarr/issues/3639)) ([8e96032](https://github.com/homarr-labs/homarr/commit/8e960324bcc43a64100fd9c6c1fd6822c7759160))
+* **widgets:** add media release widget ([#3219](https://github.com/homarr-labs/homarr/issues/3219)) ([66ebb50](https://github.com/homarr-labs/homarr/commit/66ebb5061fd219f9c804ef3a6bbe3372d296f740))
+
+### Bug Fixes
+
+* **deps:** update dependency @gitbeaker/rest to v43 ([#3623](https://github.com/homarr-labs/homarr/issues/3623)) ([732bce7](https://github.com/homarr-labs/homarr/commit/732bce72aee6c99d0ee94d04e173d378c2552a16))
+* **deps:** update dependency @tabler/icons-react to ^3.34.1 ([#3661](https://github.com/homarr-labs/homarr/issues/3661)) ([bf88f0d](https://github.com/homarr-labs/homarr/commit/bf88f0d0918b4073a5770ab3589e00e5f89cacf1))
+* **deps:** update nextjs monorepo to v15.4.2 ([#3654](https://github.com/homarr-labs/homarr/issues/3654)) ([42301b4](https://github.com/homarr-labs/homarr/commit/42301b4a1ed9e9f638b449a460862db9cd7ed50b))
+* **deps:** update testcontainers-node monorepo to ^11.3.0 ([#3652](https://github.com/homarr-labs/homarr/issues/3652)) ([2394159](https://github.com/homarr-labs/homarr/commit/2394159f8b546e8b6e2d3cdc7c6bd0f75483209c))
+* **deps:** update testcontainers-node monorepo to ^11.3.1 ([#3659](https://github.com/homarr-labs/homarr/issues/3659)) ([98f8279](https://github.com/homarr-labs/homarr/commit/98f8279b61013c312d492522e317bcf93f10e2a6))
+* improved import from docker parsing ([#3642](https://github.com/homarr-labs/homarr/issues/3642)) ([36b0f57](https://github.com/homarr-labs/homarr/commit/36b0f576e5a00726d76695fd3300710be6f925f8))
+* **security:** upgrade eslint-config-prettier to latest version without malicious code ([ecda928](https://github.com/homarr-labs/homarr/commit/ecda928bef407c67f01ce798c5f7a086cbd0dd9c))
+
+## [1.29.0](https://github.com/homarr-labs/homarr/compare/v1.28.1...v1.29.0) (2025-07-18)
+
+### Features
+
+* **logs:** add log level selection to tools ui ([#3565](https://github.com/homarr-labs/homarr/issues/3565)) ([c4e5c30](https://github.com/homarr-labs/homarr/commit/c4e5c3002bd1c746cee496b5ba6d19159104b7f8))
+* **releases-widget:** show project description when release description is missing ([#3635](https://github.com/homarr-labs/homarr/issues/3635)) ([47806c1](https://github.com/homarr-labs/homarr/commit/47806c180ebc960eb1731c02ec6af42156831bd0))
+
+### Bug Fixes
+
+* **deps:** update dependency drizzle-orm to ^0.44.3 ([#3629](https://github.com/homarr-labs/homarr/issues/3629)) ([e7012b6](https://github.com/homarr-labs/homarr/commit/e7012b6da496a0f4b7aad527d1d05cd03d0bfcda))
+* **deps:** update dependency eslint-config-prettier to ^10.1.7 ([#3651](https://github.com/homarr-labs/homarr/issues/3651)) ([1cc6ecb](https://github.com/homarr-labs/homarr/commit/1cc6ecbce29348cf891dd8cfc29d4238ff5f7f78))
+* **deps:** update dependency ldapts to v8.0.6 ([#3628](https://github.com/homarr-labs/homarr/issues/3628)) ([71dee5c](https://github.com/homarr-labs/homarr/commit/71dee5ca4bca04acc9c295c373d1209641ef3d99))
+* **deps:** update dependency swagger-ui-react to ^5.27.0 ([#3638](https://github.com/homarr-labs/homarr/issues/3638)) ([ee983e8](https://github.com/homarr-labs/homarr/commit/ee983e8241d2f32c1dcbbea4930b18442f32a5bf))
+* **deps:** update dependency typescript-eslint to ^8.37.0 ([#3631](https://github.com/homarr-labs/homarr/issues/3631)) ([d6ea8e8](https://github.com/homarr-labs/homarr/commit/d6ea8e8993d130a03592473744e74be7b4c54a79))
+* **deps:** update dependency undici to v7.12.0 ([#3650](https://github.com/homarr-labs/homarr/issues/3650)) ([cf0d2d3](https://github.com/homarr-labs/homarr/commit/cf0d2d3cdaf495d7786c45ba4c79d49f356c0e37))
+* **deps:** update nextjs monorepo to v15.4.1 ([#3632](https://github.com/homarr-labs/homarr/issues/3632)) ([39b025f](https://github.com/homarr-labs/homarr/commit/39b025f7633391c74aedeb4c4dca10d42fb3b4d8))
+* **deps:** update turbo monorepo to ^2.5.5 ([#3641](https://github.com/homarr-labs/homarr/issues/3641)) ([d4acb01](https://github.com/homarr-labs/homarr/commit/d4acb01efd6a9341fb5550a08def42d82c1f0b92))
+
 ## [1.28.1](https://github.com/homarr-labs/homarr/compare/v1.28.0...v1.28.1) (2025-07-12)

 ### Bug Fixes
@@ -64,6 +64,7 @@ ENV DB_URL='/appdata/db/db.sqlite'
 ENV DB_DIALECT='sqlite'
 ENV DB_DRIVER='better-sqlite3'
 ENV AUTH_PROVIDERS='credentials'
+ENV REDIS_IS_EXTERNAL='false'
 ENV NODE_ENV='production'

 ENTRYPOINT [ "/app/entrypoint.sh" ]
@@ -25,15 +25,16 @@
    "@homarr/boards": "workspace:^0.1.0",
    "@homarr/certificates": "workspace:^0.1.0",
    "@homarr/common": "workspace:^0.1.0",
+    "@homarr/core": "workspace:^0.1.0",
    "@homarr/cron-job-status": "workspace:^0.1.0",
    "@homarr/db": "workspace:^0.1.0",
    "@homarr/definitions": "workspace:^0.1.0",
    "@homarr/docker": "workspace:^0.1.0",
-    "@homarr/env": "workspace:^0.1.0",
    "@homarr/form": "workspace:^0.1.0",
    "@homarr/forms-collection": "workspace:^0.1.0",
    "@homarr/gridstack": "^1.12.0",
    "@homarr/icons": "workspace:^0.1.0",
+    "@homarr/image-proxy": "workspace:^0.1.0",
    "@homarr/integrations": "workspace:^0.1.0",
    "@homarr/log": "workspace:^",
    "@homarr/modals": "workspace:^0.1.0",
@@ -56,7 +57,7 @@
    "@mantine/modals": "^8.1.3",
    "@mantine/tiptap": "^8.1.3",
    "@million/lint": "1.0.14",
-    "@tabler/icons-react": "^3.34.0",
+    "@tabler/icons-react": "^3.34.1",
    "@tanstack/react-query": "^5.83.0",
    "@tanstack/react-query-devtools": "^5.83.0",
    "@tanstack/react-query-next-experimental": "^5.83.0",
@@ -75,7 +76,7 @@
    "glob": "^11.0.3",
    "jotai": "^2.12.5",
    "mantine-react-table": "2.0.0-beta.9",
-    "next": "15.3.5",
+    "next": "15.4.2",
    "postcss-preset-mantine": "^1.18.0",
    "prismjs": "^1.30.0",
    "react": "19.1.0",
@@ -84,7 +85,7 @@
    "react-simple-code-editor": "^0.14.1",
    "sass": "^1.89.2",
    "superjson": "2.2.2",
-    "swagger-ui-react": "^5.26.2",
+    "swagger-ui-react": "^5.27.0",
    "use-deep-compare-effect": "^1.8.1",
    "zod": "^3.25.76"
  },
@@ -93,7 +94,7 @@
    "@homarr/prettier-config": "workspace:^0.1.0",
    "@homarr/tsconfig": "workspace:^0.1.0",
    "@types/chroma-js": "3.1.1",
-    "@types/node": "^22.16.3",
+    "@types/node": "^22.16.4",
    "@types/prismjs": "^1.26.5",
    "@types/react": "19.1.8",
    "@types/react-dom": "19.1.6",
@@ -3,7 +3,7 @@
 import { Button, Fieldset, Grid, Group, Input, NumberInput, Slider, Stack, Text, TextInput } from "@mantine/core";

 import { clientApi } from "@homarr/api/client";
-import { createId } from "@homarr/db/client";
+import { createId } from "@homarr/common";
 import { useZodForm } from "@homarr/form";
 import { useI18n } from "@homarr/translation/client";
 import { boardSaveLayoutsSchema } from "@homarr/validation/board";
@@ -4,8 +4,7 @@ import { IconAlertTriangle, IconCheck, IconCopy, IconExclamationCircle, IconRepe

 import { clientApi } from "@homarr/api/client";
 import { useSession } from "@homarr/auth/client";
-import { getMantineColor } from "@homarr/common";
-import { createId } from "@homarr/db/client";
+import { createId, getMantineColor } from "@homarr/common";
 import { createDocumentationLink } from "@homarr/definitions";
 import { createModal, useConfirmModal, useModalAction } from "@homarr/modals";
 import { AddCertificateModal } from "@homarr/modals-collection";
@@ -3,7 +3,7 @@
 import { SimpleGrid, Skeleton, Stack, Title } from "@mantine/core";

 import { clientApi } from "@homarr/api/client";
-import { createId } from "@homarr/db/client";
+import { createId } from "@homarr/common";
 import type { KubernetesLabelResourceType } from "@homarr/definitions";
 import { useI18n } from "@homarr/translation/client";

@@ -10,7 +10,7 @@ import { MantineReactTable } from "mantine-react-table";

 import type { RouterOutputs } from "@homarr/api";
 import { clientApi } from "@homarr/api/client";
-import { createId } from "@homarr/db/client";
+import { createId } from "@homarr/common";
 import type { KubernetesIngress } from "@homarr/definitions";
 import type { ScopedTranslationFunction } from "@homarr/translation";
 import { useScopedI18n } from "@homarr/translation/client";
@@ -8,7 +8,7 @@ import { MantineReactTable } from "mantine-react-table";

 import type { RouterOutputs } from "@homarr/api";
 import { clientApi } from "@homarr/api/client";
-import { createId } from "@homarr/db/client";
+import { createId } from "@homarr/common";
 import type { KubernetesService } from "@homarr/definitions";
 import type { ScopedTranslationFunction } from "@homarr/translation";
 import { useScopedI18n } from "@homarr/translation/client";
@@ -0,0 +1,26 @@
+"use client";
+
+import { Select } from "@mantine/core";
+
+import type { LogLevel } from "@homarr/log/constants";
+import { logLevelConfiguration, logLevels } from "@homarr/log/constants";
+import { useI18n } from "@homarr/translation/client";
+
+import { useLogContext } from "./log-context";
+
+export const LogLevelSelection = () => {
+  const { level, setLevel } = useLogContext();
+  const t = useI18n();
+
+  return (
+    <Select
+      data={logLevels.map((level) => ({
+        value: level,
+        label: `${logLevelConfiguration[level].prefix} ${t(`log.level.option.${level}`)}`,
+      }))}
+      value={level}
+      onChange={(value) => setLevel(value as LogLevel)}
+      checkIconPosition="right"
+    />
+  );
+};
@@ -0,0 +1,32 @@
+"use client";
+
+import type { PropsWithChildren } from "react";
+import { createContext, useContext, useMemo, useState } from "react";
+
+import type { LogLevel } from "@homarr/log/constants";
+import { logLevels } from "@homarr/log/constants";
+
+const LogContext = createContext<{
+  level: LogLevel;
+  setLevel: (level: LogLevel) => void;
+  activeLevels: LogLevel[];
+} | null>(null);
+
+interface LogContextProviderProps extends PropsWithChildren {
+  defaultLevel: LogLevel;
+}
+
+export const LogContextProvider = ({ defaultLevel, children }: LogContextProviderProps) => {
+  const [level, setLevel] = useState(defaultLevel);
+  const activeLevels = useMemo(() => logLevels.slice(0, logLevels.indexOf(level) + 1), [level]);
+
+  return <LogContext.Provider value={{ level, setLevel, activeLevels }}>{children}</LogContext.Provider>;
+};
+
+export const useLogContext = () => {
+  const context = useContext(LogContext);
+  if (!context) {
+    throw new Error("useLogContext must be used within a LogContextProvider");
+  }
+  return context;
+};
@@ -1,4 +1,4 @@
-import { Box } from "@mantine/core";
+import { Box, Group } from "@mantine/core";

 import { getScopedI18n } from "@homarr/translation/server";

@@ -7,11 +7,14 @@ import "@xterm/xterm/css/xterm.css";
 import { notFound } from "next/navigation";

 import { auth } from "@homarr/auth/next";
+import { env } from "@homarr/log/env";

 import { DynamicBreadcrumb } from "~/components/navigation/dynamic-breadcrumb";
 import { fullHeightWithoutHeaderAndFooter } from "~/constants";
 import { createMetaTitle } from "~/metadata";
 import { ClientSideTerminalComponent } from "./client";
+import { LogLevelSelection } from "./level-selection";
+import { LogContextProvider } from "./log-context";

 export async function generateMetadata() {
  const session = await auth();
@@ -32,11 +35,14 @@ export default async function LogsManagementPage() {
  }

  return (
-    <>
-      <DynamicBreadcrumb />
+    <LogContextProvider defaultLevel={env.LOG_LEVEL}>
+      <Group justify="space-between" align="center" wrap="nowrap">
+        <DynamicBreadcrumb />
+        <LogLevelSelection />
+      </Group>
      <Box style={{ borderRadius: 6 }} h={fullHeightWithoutHeaderAndFooter} p="md" bg="black">
        <ClientSideTerminalComponent />
      </Box>
-    </>
+    </LogContextProvider>
  );
 }
@@ -8,22 +8,29 @@ import { Terminal } from "@xterm/xterm";

 import { clientApi } from "@homarr/api/client";

+import { useLogContext } from "./log-context";
 import classes from "./terminal.module.css";

 export const TerminalComponent = () => {
  const ref = useRef<HTMLDivElement>(null);
+  const { activeLevels } = useLogContext();

  const terminalRef = useRef<Terminal>(null);
-  clientApi.log.subscribe.useSubscription(undefined, {
-    onData(data) {
-      terminalRef.current?.writeln(`${data.timestamp} ${data.level} ${data.message}`);
-      terminalRef.current?.refresh(0, terminalRef.current.rows - 1);
+  clientApi.log.subscribe.useSubscription(
+    {
+      levels: activeLevels,
    },
-    onError(err) {
-      // This makes sense as logging might cause an infinite loop
-      alert(err);
+    {
+      onData(data) {
+        terminalRef.current?.writeln(data.message);
+        terminalRef.current?.refresh(0, terminalRef.current.rows - 1);
+      },
+      onError(err) {
+        // This makes sense as logging might cause an infinite loop
+        alert(err);
+      },
    },
-  });
+  );

  useEffect(() => {
    if (!ref.current) {
@@ -0,0 +1,19 @@
+import { notFound } from "next/navigation";
+
+import { ImageProxy } from "@homarr/image-proxy";
+
+export const GET = async (_request: Request, props: { params: Promise<{ id: string }> }) => {
+  const { id } = await props.params;
+
+  const imageProxy = new ImageProxy();
+  const image = await imageProxy.forwardImageAsync(id);
+  if (!image) {
+    notFound();
+  }
+
+  return new Response(image, {
+    headers: {
+      "Cache-Control": "public, max-age=3600, immutable", // Cache for 1 hour
+    },
+  });
+};
@@ -1,6 +1,6 @@
 import { getBoardLayouts } from "@homarr/boards/context";
+import { createId } from "@homarr/common";
 import type { Modify } from "@homarr/common/types";
-import { createId } from "@homarr/db/client";
 import type { WidgetKind } from "@homarr/definitions";

 import type { Board, EmptySection, Item, ItemLayout } from "~/app/[locale]/boards/_types";
@@ -1,4 +1,4 @@
-import { createId } from "@homarr/db/client";
+import { createId } from "@homarr/common";

 import type { Board, EmptySection, ItemLayout, Section } from "~/app/[locale]/boards/_types";
 import { getFirstEmptyPosition } from "./empty-position";
@@ -1,4 +1,4 @@
-import { createId } from "@homarr/db";
+import { createId } from "@homarr/common";

 import type { Board, DynamicSection, EmptySection, Item, Section } from "~/app/[locale]/boards/_types";
 import { DynamicSectionMockBuilder } from "./dynamic-section-mock";
@@ -1,4 +1,4 @@
-import { createId } from "@homarr/db";
+import { createId } from "@homarr/common";

 import type { CategorySection } from "~/app/[locale]/boards/_types";

@@ -1,4 +1,4 @@
-import { createId } from "@homarr/db";
+import { createId } from "@homarr/common";

 import type { DynamicSection } from "~/app/[locale]/boards/_types";

@@ -1,4 +1,4 @@
-import { createId } from "@homarr/db";
+import { createId } from "@homarr/common";

 import type { EmptySection } from "~/app/[locale]/boards/_types";

@@ -1,4 +1,4 @@
-import { createId } from "@homarr/db";
+import { createId } from "@homarr/common";

 import type { Item } from "~/app/[locale]/boards/_types";

@@ -1,4 +1,4 @@
-import { createId } from "@homarr/db";
+import { createId } from "@homarr/common";

 import type { Board } from "~/app/[locale]/boards/_types";

@@ -1,7 +1,7 @@
 import { useCallback } from "react";

 import { useUpdateBoard } from "@homarr/boards/updater";
-import { createId } from "@homarr/db/client";
+import { createId } from "@homarr/common";

 import type { CategorySection, EmptySection, Section } from "~/app/[locale]/boards/_types";
 import type { MoveCategoryInput } from "./actions/move-category";
@@ -2,7 +2,7 @@ import { useCallback } from "react";

 import { fetchApi } from "@homarr/api/client";
 import { getCurrentLayout, useRequiredBoard } from "@homarr/boards/context";
-import { createId } from "@homarr/db/client";
+import { createId } from "@homarr/common";
 import { useConfirmModal, useModalAction } from "@homarr/modals";
 import { useSettings } from "@homarr/settings";
 import { useI18n } from "@homarr/translation/client";
@@ -1,5 +1,5 @@
 import { getBoardLayouts } from "@homarr/boards/context";
-import { createId } from "@homarr/db/client";
+import { createId } from "@homarr/common";

 import type { Board, DynamicSection, DynamicSectionLayout, EmptySection } from "~/app/[locale]/boards/_types";
 import { getFirstEmptyPosition } from "~/components/board/items/actions/empty-position";
@@ -1,5 +1,4 @@
-import { createEnv } from "@homarr/env";
-import { createBooleanSchema } from "@homarr/env/schemas";
+import { createBooleanSchema, createEnv } from "@homarr/core/infrastructure/env";

 export const env = createEnv({
  server: {
@@ -10,7 +10,7 @@
  "main": "./src/main.ts",
  "types": "./src/main.ts",
  "scripts": {
-    "build": "esbuild src/main.ts --bundle --platform=node --loader:.scss=text --external:*.node --external:@opentelemetry/api --external:deasync --outfile=tasks.cjs",
+    "build": "esbuild src/main.ts --bundle --platform=node --loader:.scss=text --external:*.node --external:@opentelemetry/api --external:deasync --external:bcrypt --outfile=tasks.cjs",
    "clean": "rm -rf .turbo node_modules",
    "dev": "pnpm with-env tsx ./src/main.ts",
    "format": "prettier --check . --ignore-path ../../.gitignore",
@@ -38,15 +38,15 @@
    "dotenv": "^17.2.0",
    "fastify": "^5.4.0",
    "superjson": "2.2.2",
-    "undici": "7.11.0"
+    "undici": "7.12.0"
  },
  "devDependencies": {
    "@homarr/eslint-config": "workspace:^0.2.0",
    "@homarr/prettier-config": "workspace:^0.1.0",
    "@homarr/tsconfig": "workspace:^0.1.0",
-    "@types/node": "^22.16.3",
+    "@types/node": "^22.16.4",
    "dotenv-cli": "^8.0.0",
-    "esbuild": "^0.25.6",
+    "esbuild": "^0.25.8",
    "eslint": "^9.31.0",
    "prettier": "^3.6.2",
    "tsx": "4.20.3",
@@ -34,7 +34,7 @@
    "@homarr/prettier-config": "workspace:^0.1.0",
    "@homarr/tsconfig": "workspace:^0.1.0",
    "@types/ws": "^8.18.1",
-    "esbuild": "^0.25.6",
+    "esbuild": "^0.25.8",
    "eslint": "^9.31.0",
    "prettier": "^3.6.2",
    "typescript": "^5.8.3"
@@ -1,9 +1,10 @@
 import { describe, expect, test } from "vitest";

 import { createHomarrContainer } from "./shared/create-homarr-container";
+import { createRedisContainer } from "./shared/redis-container";

 describe("Health checks", () => {
-  test("ready and live should return 200 OK", async () => {
+  test("ready and live should return 200 OK with normal image and no extra configuration", async () => {
    // Arrange
    const homarrContainer = await createHomarrContainer().start();

@@ -15,4 +16,31 @@ describe("Health checks", () => {
    expect(readyResponse.status).toBe(200);
    expect(liveResponse.status).toBe(200);
  }, 20_000);
+
+  test("ready and live should return 200 OK with external redis", async () => {
+    // Arrange
+    const redisContainer = await createRedisContainer().start();
+    const homarrContainer = await createHomarrContainer({
+      environment: {
+        REDIS_IS_EXTERNAL: "true",
+        REDIS_HOST: "host.docker.internal",
+        REDIS_PORT: redisContainer.getMappedPort(6379).toString(),
+        REDIS_PASSWORD: redisContainer.getPassword(),
+      },
+    }).start();
+
+    // Act
+    const readyResponse = await fetch(`http://localhost:${homarrContainer.getMappedPort(7575)}/api/health/ready`);
+    const liveResponse = await fetch(`http://localhost:${homarrContainer.getMappedPort(7575)}/api/health/live`);
+
+    // Assert
+    expect(
+      readyResponse.status,
+      `Expected ready to return OK statusCode=${readyResponse.status} content=${await readyResponse.text()}`,
+    ).toBe(200);
+    expect(
+      liveResponse.status,
+      `Expected live to return OK statusCode=${liveResponse.status} content=${await liveResponse.text()}`,
+    ).toBe(200);
+  }, 20_000);
 });
@@ -0,0 +1,5 @@
+import { RedisContainer } from "@testcontainers/redis";
+
+export const createRedisContainer = () => {
+  return new RedisContainer("redis:latest").withPassword("homarr");
+};
@@ -1,6 +1,6 @@
 {
  "name": "homarr",
-  "version": "1.28.1",
+  "version": "1.30.0",
  "private": true,
  "scripts": {
    "build": "cross-env CI=true turbo build",
@@ -38,8 +38,9 @@
    "@semantic-release/github": "^11.0.3",
    "@semantic-release/npm": "^12.0.2",
    "@semantic-release/release-notes-generator": "^14.0.3",
-    "@turbo/gen": "^2.5.4",
-    "@vitejs/plugin-react": "^4.6.0",
+    "@testcontainers/redis": "^11.3.1",
+    "@turbo/gen": "^2.5.5",
+    "@vitejs/plugin-react": "^4.7.0",
    "@vitest/coverage-v8": "^3.2.4",
    "@vitest/ui": "^3.2.4",
    "conventional-changelog-conventionalcommits": "^9.1.0",
@@ -47,15 +48,15 @@
    "jsdom": "^26.1.0",
    "prettier": "^3.6.2",
    "semantic-release": "^24.2.7",
-    "testcontainers": "^11.2.1",
-    "turbo": "^2.5.4",
+    "testcontainers": "^11.3.1",
+    "turbo": "^2.5.5",
    "typescript": "^5.8.3",
    "vite-tsconfig-paths": "^5.1.4",
    "vitest": "^3.2.4"
  },
  "packageManager": "pnpm@10.13.1",
  "engines": {
-    "node": ">=22.17.0"
+    "node": ">=22.17.1"
  },
  "pnpm": {
    "onlyBuiltDependencies": [
@@ -70,7 +71,7 @@
      "tree-sitter-json"
    ],
    "overrides": {
-      "proxmox-api>undici": "7.11.0"
+      "proxmox-api>undici": "7.12.0"
    },
    "allowUnusedPatches": true,
    "ignoredBuiltDependencies": [
@@ -46,7 +46,7 @@
    "@trpc/server": "^11.4.3",
    "@trpc/tanstack-react-query": "^11.4.3",
    "lodash.clonedeep": "^4.5.0",
-    "next": "15.3.5",
+    "next": "15.4.2",
    "react": "19.1.0",
    "react-dom": "19.1.0",
    "superjson": "2.2.2",
@@ -1,8 +1,9 @@
 import { z } from "zod";

 import { createSaltAsync, hashPasswordAsync } from "@homarr/auth";
+import { createId } from "@homarr/common";
 import { generateSecureRandomToken } from "@homarr/common/server";
-import { createId, db, eq } from "@homarr/db";
+import { db, eq } from "@homarr/db";
 import { apiKeys } from "@homarr/db/schema";

 import { createTRPCRouter, permissionRequiredProcedure } from "../trpc";
@@ -1,7 +1,8 @@
 import { TRPCError } from "@trpc/server";
 import { z } from "zod";

-import { asc, createId, eq, inArray, like } from "@homarr/db";
+import { createId } from "@homarr/common";
+import { asc, eq, inArray, like } from "@homarr/db";
 import { apps } from "@homarr/db/schema";
 import { selectAppSchema } from "@homarr/db/validationSchemas";
 import { getIconForName } from "@homarr/icons";
@@ -3,9 +3,10 @@ import superjson from "superjson";
 import { z } from "zod";

 import { constructBoardPermissions } from "@homarr/auth/shared";
+import { createId } from "@homarr/common";
 import type { DeviceType } from "@homarr/common/server";
 import type { Database, InferInsertModel, InferSelectModel, SQL } from "@homarr/db";
-import { and, asc, createId, eq, handleTransactionsAsync, inArray, isNull, like, not, or, sql } from "@homarr/db";
+import { and, asc, eq, handleTransactionsAsync, inArray, isNull, like, not, or, sql } from "@homarr/db";
 import { createDbInsertCollectionWithoutTransaction } from "@homarr/db/collection";
 import { getServerSettingByKeyAsync } from "@homarr/db/queries";
 import {
@@ -1,8 +1,9 @@
 import { TRPCError } from "@trpc/server";
 import { z } from "zod";

+import { createId } from "@homarr/common";
 import type { Database } from "@homarr/db";
-import { and, createId, eq, handleTransactionsAsync, like, not } from "@homarr/db";
+import { and, eq, handleTransactionsAsync, like, not } from "@homarr/db";
 import { getMaxGroupPositionAsync } from "@homarr/db/queries";
 import { groupMembers, groupPermissions, groups } from "@homarr/db/schema";
 import { everyoneGroup } from "@homarr/definitions";
@@ -1,10 +1,10 @@
 import { TRPCError } from "@trpc/server";
 import { z } from "zod";

-import { objectEntries } from "@homarr/common";
+import { createId, objectEntries } from "@homarr/common";
 import { decryptSecret, encryptSecret } from "@homarr/common/server";
 import type { Database } from "@homarr/db";
-import { and, asc, createId, eq, handleTransactionsAsync, inArray, like } from "@homarr/db";
+import { and, asc, eq, handleTransactionsAsync, inArray, like } from "@homarr/db";
 import {
  groupMembers,
  groupPermissions,
@@ -2,7 +2,8 @@ import { randomBytes } from "crypto";
 import { TRPCError } from "@trpc/server";
 import { z } from "zod";

-import { asc, createId, eq } from "@homarr/db";
+import { createId } from "@homarr/common";
+import { asc, eq } from "@homarr/db";
 import { invites } from "@homarr/db/schema";
 import { selectInviteSchema } from "@homarr/db/validationSchemas";

@@ -1,22 +1,33 @@
 import { observable } from "@trpc/server/observable";
+import z from "zod";

 import { logger } from "@homarr/log";
+import { logLevels } from "@homarr/log/constants";
 import type { LoggerMessage } from "@homarr/redis";
 import { loggingChannel } from "@homarr/redis";
+import { zodEnumFromArray } from "@homarr/validation/enums";

 import { createTRPCRouter, permissionRequiredProcedure } from "../trpc";

 export const logRouter = createTRPCRouter({
-  subscribe: permissionRequiredProcedure.requiresPermission("other-view-logs").subscription(() => {
-    return observable<LoggerMessage>((emit) => {
-      const unsubscribe = loggingChannel.subscribe((data) => {
-        emit.next(data);
-      });
-      logger.info("A tRPC client has connected to the logging procedure");
+  subscribe: permissionRequiredProcedure
+    .requiresPermission("other-view-logs")
+    .input(
+      z.object({
+        levels: z.array(zodEnumFromArray(logLevels)).default(["info"]),
+      }),
+    )
+    .subscription(({ input }) => {
+      return observable<LoggerMessage>((emit) => {
+        const unsubscribe = loggingChannel.subscribe((data) => {
+          if (!input.levels.includes(data.level)) return;
+          emit.next(data);
+        });
+        logger.info("A tRPC client has connected to the logging procedure");

-      return () => {
-        unsubscribe();
-      };
-    });
-  }),
+        return () => {
+          unsubscribe();
+        };
+      });
+    }),
 });
@@ -1,8 +1,9 @@
 import { TRPCError } from "@trpc/server";
 import { z } from "zod";

+import { createId } from "@homarr/common";
 import type { InferInsertModel } from "@homarr/db";
-import { and, createId, desc, eq, like } from "@homarr/db";
+import { and, desc, eq, like } from "@homarr/db";
 import { iconRepositories, icons, medias } from "@homarr/db/schema";
 import { createLocalImageUrl, LOCAL_ICON_REPOSITORY_SLUG, mapMediaToIcon } from "@homarr/icons/local";
 import { byIdSchema, paginatedSchema } from "@homarr/validation/common";
@@ -1,7 +1,8 @@
 import { TRPCError } from "@trpc/server";
 import { z } from "zod";

-import { asc, createId, eq, like } from "@homarr/db";
+import { createId } from "@homarr/common";
+import { asc, eq, like } from "@homarr/db";
 import { getServerSettingByKeyAsync, updateServerSettingByKeyAsync } from "@homarr/db/queries";
 import { searchEngines, users } from "@homarr/db/schema";
 import { createIntegrationAsync } from "@homarr/integrations";
@@ -2,7 +2,7 @@
 import { describe, expect, test, vi } from "vitest";

 import type { Session } from "@homarr/auth";
-import { createId } from "@homarr/db";
+import { createId } from "@homarr/common";
 import { apps } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";
 import type { GroupPermissionKey } from "@homarr/definitions";
@@ -2,8 +2,9 @@ import SuperJSON from "superjson";
 import { describe, expect, it, test, vi } from "vitest";

 import type { Session } from "@homarr/auth";
+import { createId } from "@homarr/common";
 import type { Database, InferInsertModel } from "@homarr/db";
-import { and, createId, eq, not } from "@homarr/db";
+import { and, eq, not } from "@homarr/db";
 import {
  boardGroupPermissions,
  boards,
@@ -1,7 +1,8 @@
 import { describe, expect, test, vi } from "vitest";

 import * as authShared from "@homarr/auth/shared";
-import { createId, eq } from "@homarr/db";
+import { createId } from "@homarr/common";
+import { eq } from "@homarr/db";
 import { boards, users } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";

@@ -2,7 +2,8 @@ import { describe, expect, test, vi } from "vitest";

 import type { Session } from "@homarr/auth";
 import * as env from "@homarr/auth/env";
-import { createId, eq } from "@homarr/db";
+import { createId } from "@homarr/common";
+import { eq } from "@homarr/db";
 import { groupMembers, groupPermissions, groups, users } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";
 import type { GroupPermissionKey } from "@homarr/definitions";
@@ -1,7 +1,8 @@
 import { describe, expect, test, vi } from "vitest";

 import * as authShared from "@homarr/auth/shared";
-import { createId, eq } from "@homarr/db";
+import { createId } from "@homarr/common";
+import { eq } from "@homarr/db";
 import { integrations, users } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";

@@ -2,8 +2,8 @@
 import { describe, expect, test, vi } from "vitest";

 import type { Session } from "@homarr/auth";
+import { createId } from "@homarr/common";
 import { encryptSecret } from "@homarr/common/server";
-import { createId } from "@homarr/db";
 import { integrations, integrationSecrets } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";
 import type { GroupPermissionKey } from "@homarr/definitions";
@@ -2,7 +2,7 @@
 import { describe, expect, test, vi } from "vitest";

 import type { Session } from "@homarr/auth";
-import { createId } from "@homarr/db";
+import { createId } from "@homarr/common";
 import { invites, users } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";

@@ -2,7 +2,7 @@ import SuperJSON from "superjson";
 import { describe, expect, test, vi } from "vitest";

 import type { Session } from "@homarr/auth";
-import { createId } from "@homarr/db";
+import { createId } from "@homarr/common";
 import { serverSettings } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";
 import { defaultServerSettings, defaultServerSettingsKeys } from "@homarr/server-settings";
@@ -1,8 +1,9 @@
 import { describe, expect, it, test, vi } from "vitest";

 import type { Session } from "@homarr/auth";
+import { createId } from "@homarr/common";
 import type { Database } from "@homarr/db";
-import { createId, eq } from "@homarr/db";
+import { eq } from "@homarr/db";
 import { invites, onboarding, users } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";
 import type { GroupPermissionKey, OnboardingStep } from "@homarr/definitions";
@@ -2,8 +2,9 @@ import { TRPCError } from "@trpc/server";
 import { z } from "zod";

 import { createSaltAsync, hashPasswordAsync } from "@homarr/auth";
+import { createId } from "@homarr/common";
 import type { Database } from "@homarr/db";
-import { and, createId, eq, like } from "@homarr/db";
+import { and, eq, like } from "@homarr/db";
 import { getMaxGroupPositionAsync } from "@homarr/db/queries";
 import { boards, groupMembers, groupPermissions, groups, invites, users } from "@homarr/db/schema";
 import { selectUserSchema } from "@homarr/db/validationSchemas";
@@ -5,6 +5,7 @@ import { dnsHoleRouter } from "./dns-hole";
 import { downloadsRouter } from "./downloads";
 import { healthMonitoringRouter } from "./health-monitoring";
 import { indexerManagerRouter } from "./indexer-manager";
+import { mediaReleaseRouter } from "./media-release";
 import { mediaRequestsRouter } from "./media-requests";
 import { mediaServerRouter } from "./media-server";
 import { mediaTranscodingRouter } from "./media-transcoding";
@@ -27,6 +28,7 @@ export const widgetRouter = createTRPCRouter({
  smartHome: smartHomeRouter,
  stockPrice: stockPriceRouter,
  mediaServer: mediaServerRouter,
+  mediaRelease: mediaReleaseRouter,
  calendar: calendarRouter,
  downloads: downloadsRouter,
  mediaRequests: mediaRequestsRouter,
@@ -0,0 +1,67 @@
+import { observable } from "@trpc/server/observable";
+
+import type { Modify } from "@homarr/common/types";
+import type { Integration } from "@homarr/db/schema";
+import type { IntegrationKindByCategory } from "@homarr/definitions";
+import { getIntegrationKindsByCategory } from "@homarr/definitions";
+import type { MediaRelease } from "@homarr/integrations/types";
+import { mediaReleaseRequestHandler } from "@homarr/request-handler/media-release";
+
+import { createManyIntegrationMiddleware } from "../../middlewares/integration";
+import { createTRPCRouter, publicProcedure } from "../../trpc";
+
+export const mediaReleaseRouter = createTRPCRouter({
+  getMediaReleases: publicProcedure
+    .concat(createManyIntegrationMiddleware("query", ...getIntegrationKindsByCategory("mediaRelease")))
+    .query(async ({ ctx }) => {
+      const results = await Promise.all(
+        ctx.integrations.map(async (integration) => {
+          const innerHandler = mediaReleaseRequestHandler.handler(integration, {});
+          const { data, timestamp } = await innerHandler.getCachedOrUpdatedDataAsync({ forceUpdate: false });
+
+          return {
+            integration: {
+              id: integration.id,
+              name: integration.name,
+              kind: integration.kind,
+              updatedAt: timestamp,
+            },
+            releases: data,
+          };
+        }),
+      );
+      return results.flatMap((result) =>
+        result.releases.map((release) => ({
+          ...release,
+          integration: result.integration,
+        })),
+      );
+    }),
+
+  subscribeToReleases: publicProcedure
+    .concat(createManyIntegrationMiddleware("query", ...getIntegrationKindsByCategory("mediaRelease")))
+    .subscription(({ ctx }) => {
+      return observable<{
+        integration: Modify<Integration, { kind: IntegrationKindByCategory<"mediaRelease"> }>;
+        releases: MediaRelease[];
+      }>((emit) => {
+        const unsubscribes: (() => void)[] = [];
+        for (const integrationWithSecrets of ctx.integrations) {
+          const { decryptedSecrets: _, ...integration } = integrationWithSecrets;
+          const innerHandler = mediaReleaseRequestHandler.handler(integrationWithSecrets, {});
+          const unsubscribe = innerHandler.subscribe((releases) => {
+            emit.next({
+              integration,
+              releases,
+            });
+          });
+          unsubscribes.push(unsubscribe);
+        }
+        return () => {
+          unsubscribes.forEach((unsubscribe) => {
+            unsubscribe();
+          });
+        };
+      });
+    }),
+});
@@ -1,8 +1,7 @@
 import { z } from "zod";

+import { createBooleanSchema, createDurationSchema, createEnv } from "@homarr/core/infrastructure/env";
 import { supportedAuthProviders } from "@homarr/definitions";
-import { createEnv } from "@homarr/env";
-import { createBooleanSchema, createDurationSchema } from "@homarr/env/schemas";

 const authProvidersSchema = z
  .string()
@@ -27,15 +27,15 @@
    "@auth/drizzle-adapter": "^1.10.0",
    "@homarr/certificates": "workspace:^0.1.0",
    "@homarr/common": "workspace:^0.1.0",
+    "@homarr/core": "workspace:^0.1.0",
    "@homarr/db": "workspace:^0.1.0",
    "@homarr/definitions": "workspace:^0.1.0",
-    "@homarr/env": "workspace:^0.1.0",
    "@homarr/log": "workspace:^0.1.0",
    "@homarr/validation": "workspace:^0.1.0",
    "bcrypt": "^6.0.0",
    "cookies": "^0.9.1",
-    "ldapts": "8.0.5",
-    "next": "15.3.5",
+    "ldapts": "8.0.6",
+    "next": "15.4.2",
    "next-auth": "5.0.0-beta.29",
    "react": "19.1.0",
    "react-dom": "19.1.0",
@@ -1,8 +1,8 @@
 import type { Session } from "next-auth";
 import { describe, expect, test, vi } from "vitest";

+import { createId } from "@homarr/common";
 import type { InferInsertModel } from "@homarr/db";
-import { createId } from "@homarr/db";
 import { boardGroupPermissions, boards, boardUserPermissions, groupMembers, groups, users } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";

@@ -1,9 +1,9 @@
 import { CredentialsSignin } from "@auth/core/errors";
 import { z } from "zod";

-import { extractErrorMessage } from "@homarr/common";
+import { createId, extractErrorMessage } from "@homarr/common";
 import type { Database, InferInsertModel } from "@homarr/db";
-import { and, createId, eq } from "@homarr/db";
+import { and, eq } from "@homarr/db";
 import { users } from "@homarr/db/schema";
 import { logger } from "@homarr/log";
 import type { userSignInSchema } from "@homarr/validation/user";
@@ -1,6 +1,6 @@
 import { describe, expect, test } from "vitest";

-import { createId } from "@homarr/db";
+import { createId } from "@homarr/common";
 import { users } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";

@@ -1,8 +1,9 @@
 import { CredentialsSignin } from "@auth/core/errors";
 import { describe, expect, test, vi } from "vitest";

+import { createId } from "@homarr/common";
 import type { Database } from "@homarr/db";
-import { and, createId, eq } from "@homarr/db";
+import { and, eq } from "@homarr/db";
 import { groups, users } from "@homarr/db/schema";
 import { createDb } from "@homarr/db/test";

@@ -24,7 +24,7 @@
  "dependencies": {
    "@homarr/common": "workspace:^0.1.0",
    "@homarr/db": "workspace:^0.1.0",
-    "undici": "7.11.0"
+    "undici": "7.12.0"
  },
  "devDependencies": {
    "@homarr/eslint-config": "workspace:^0.2.0",
@@ -34,7 +34,7 @@
    "@homarr/eslint-config": "workspace:^0.2.0",
    "@homarr/prettier-config": "workspace:^0.1.0",
    "@homarr/tsconfig": "workspace:^0.1.0",
-    "esbuild": "^0.25.6",
+    "esbuild": "^0.25.8",
    "eslint": "^9.31.0",
    "typescript": "^5.8.3"
  }
@@ -1,8 +1,9 @@
 import { command, string } from "@drizzle-team/brocli";

 import { createSaltAsync, hashPasswordAsync } from "@homarr/auth";
+import { createId } from "@homarr/common";
 import { generateSecureRandomToken } from "@homarr/common/server";
-import { and, count, createId, db, eq } from "@homarr/db";
+import { and, count, db, eq } from "@homarr/db";
 import { getMaxGroupPositionAsync } from "@homarr/db/queries";
 import { groupMembers, groupPermissions, groups, users } from "@homarr/db/schema";
 import { usernameSchema } from "@homarr/validation/user";
@@ -1,7 +1,7 @@
 import { randomBytes } from "crypto";
 import { z } from "zod";

-import { createEnv } from "@homarr/env";
+import { createEnv } from "@homarr/core/infrastructure/env";

 const errorSuffix = `, please generate a 64 character secret in hex format or use the following: "${randomBytes(32).toString("hex")}"`;

@@ -27,14 +27,14 @@
  },
  "prettier": "@homarr/prettier-config",
  "dependencies": {
-    "@homarr/env": "workspace:^0.1.0",
+    "@homarr/core": "workspace:^0.1.0",
    "@homarr/log": "workspace:^0.1.0",
    "@paralleldrive/cuid2": "^2.2.2",
    "dayjs": "^1.11.13",
-    "next": "15.3.5",
+    "next": "15.4.2",
    "react": "19.1.0",
    "react-dom": "19.1.0",
-    "undici": "7.11.0",
+    "undici": "7.12.0",
    "zod": "^3.25.76",
    "zod-validation-error": "^3.5.3"
  },
@@ -12,3 +12,4 @@ export * from "./error";
 export * from "./fetch-with-timeout";
 export * from "./theme";
 export * from "./function";
+export * from "./id";
@@ -1,9 +1,4 @@
 import baseConfig from "@homarr/eslint-config/base";

 /** @type {import('typescript-eslint').Config} */
-export default [
-  {
-    ignores: [],
-  },
-  ...baseConfig,
-];
+export default [...baseConfig];
@@ -1,12 +1,13 @@
 {
-  "name": "@homarr/env",
+  "name": "@homarr/core",
  "version": "0.1.0",
  "private": true,
  "license": "Apache-2.0",
  "type": "module",
  "exports": {
-    ".": "./index.ts",
-    "./schemas": "./src/schemas.ts"
+    "./infrastructure/redis": "./src/infrastructure/redis/client.ts",
+    "./infrastructure/env": "./src/infrastructure/env/index.ts",
+    ".": "./src/index.ts"
  },
  "typesVersions": {
    "*": {
@@ -24,6 +25,7 @@
  "prettier": "@homarr/prettier-config",
  "dependencies": {
    "@t3-oss/env-nextjs": "^0.13.8",
+    "ioredis": "5.6.1",
    "zod": "^3.25.76"
  },
  "devDependencies": {
@@ -7,3 +7,6 @@ export const defaultEnvOptions = {
 } satisfies Partial<Parameters<typeof createEnvT3>[0]>;

 export const createEnv: typeof createEnvT3 = (options) => createEnvT3({ ...defaultEnvOptions, ...options });
+
+export * from "./prefix";
+export * from "./schemas";
@@ -0,0 +1,13 @@
+export const runtimeEnvWithPrefix = (prefix: `${string}_`) =>
+  Object.entries(process.env)
+    .filter(([key]) => key.startsWith(prefix))
+    .reduce(
+      (acc, [key, value]) => {
+        if (value === undefined) return acc;
+
+        const newKey = key.replace(prefix, "");
+        acc[newKey] = value;
+        return acc;
+      },
+      {} as Record<string, string>,
+    );
@@ -0,0 +1,26 @@
+import type { RedisOptions } from "ioredis";
+import { Redis } from "ioredis";
+
+import { redisEnv } from "./env";
+
+const defaultRedisOptions = {
+  connectionName: "homarr",
+} satisfies RedisOptions;
+
+export type { Redis as RedisClient } from "ioredis";
+
+export const createRedisClient = () =>
+  redisEnv.IS_EXTERNAL
+    ? new Redis({
+        ...defaultRedisOptions,
+        host: redisEnv.HOST,
+        port: redisEnv.PORT,
+        tls: redisEnv.TLS_CA
+          ? {
+              ca: redisEnv.TLS_CA,
+            }
+          : undefined,
+        username: redisEnv.USERNAME,
+        password: redisEnv.PASSWORD,
+      })
+    : new Redis(defaultRedisOptions);
@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+
+import { createEnv } from "../env";
+import { runtimeEnvWithPrefix } from "../env/prefix";
+import { createBooleanSchema } from "../env/schemas";
+
+export const redisEnv = createEnv({
+  server: {
+    IS_EXTERNAL: createBooleanSchema(false),
+    HOST: z.string().optional(),
+    PORT: z.coerce.number().default(6379).optional(),
+    TLS_CA: z.string().optional(),
+    USERNAME: z.string().optional(),
+    PASSWORD: z.string().optional(),
+  },
+  runtimeEnv: runtimeEnvWithPrefix("REDIS_"),
+});
@@ -26,8 +26,8 @@
  "prettier": "@homarr/prettier-config",
  "dependencies": {
    "@homarr/common": "workspace:^0.1.0",
+    "@homarr/core": "workspace:^0.1.0",
    "@homarr/cron-jobs": "workspace:^0.1.0",
-    "@homarr/env": "workspace:^0.1.0",
    "@homarr/log": "workspace:^0.1.0",
    "@tanstack/react-query": "^5.83.0",
    "@trpc/client": "^11.4.3",
@@ -1,7 +1,7 @@
 import { z } from "zod/v4";

 import { env as commonEnv } from "@homarr/common/env";
-import { createEnv } from "@homarr/env";
+import { createEnv } from "@homarr/core/infrastructure/env";

 export const env = createEnv({
  server: {
@@ -1,8 +1,7 @@
-import { splitToNChunks, Stopwatch } from "@homarr/common";
+import { createId, splitToNChunks, Stopwatch } from "@homarr/common";
 import { EVERY_WEEK } from "@homarr/cron-jobs-core/expressions";
 import type { InferInsertModel } from "@homarr/db";
 import { db, handleTransactionsAsync, inArray, sql } from "@homarr/db";
-import { createId } from "@homarr/db/client";
 import { iconRepositories, icons } from "@homarr/db/schema";
 import { fetchIconsAsync } from "@homarr/icons";
 import { logger } from "@homarr/log";
@@ -1 +0,0 @@
-export { createId } from "@paralleldrive/cuid2";
@@ -1,7 +1,7 @@
 import { z } from "zod";

 import { env as commonEnv } from "@homarr/common/env";
-import { createEnv } from "@homarr/env";
+import { createEnv } from "@homarr/core/infrastructure/env";

 const drivers = {
  betterSqlite3: "better-sqlite3",
@@ -9,5 +9,4 @@ export const db = database;
 export type Database = typeof db;
 export type { HomarrDatabaseMysql } from "./driver";

-export { createId } from "@paralleldrive/cuid2";
 export { handleDiffrentDbDriverOperationsAsync as handleTransactionsAsync } from "./transactions";
@@ -1,4 +1,4 @@
-import { objectKeys } from "@homarr/common";
+import { createId, objectKeys } from "@homarr/common";
 import {
  createDocumentationLink,
  everyoneGroup,
@@ -9,7 +9,7 @@ import {
 import { defaultServerSettings, defaultServerSettingsKeys } from "@homarr/server-settings";

 import type { Database } from "..";
-import { createId, eq } from "..";
+import { eq } from "..";
 import {
  getServerSettingByKeyAsync,
  insertServerSettingByKeyAsync,
@@ -6,7 +6,6 @@
  "type": "module",
  "exports": {
    ".": "./index.ts",
-    "./client": "./client.ts",
    "./collection": "./collection.ts",
    "./schema": "./schema/index.ts",
    "./test": "./test/index.ts",
@@ -41,17 +40,17 @@
  "dependencies": {
    "@auth/core": "^0.40.0",
    "@homarr/common": "workspace:^0.1.0",
+    "@homarr/core": "workspace:^0.1.0",
    "@homarr/definitions": "workspace:^0.1.0",
-    "@homarr/env": "workspace:^0.1.0",
    "@homarr/log": "workspace:^0.1.0",
    "@homarr/server-settings": "workspace:^0.1.0",
    "@mantine/core": "^8.1.3",
    "@paralleldrive/cuid2": "^2.2.2",
-    "@testcontainers/mysql": "^11.2.1",
+    "@testcontainers/mysql": "^11.3.1",
    "better-sqlite3": "^12.2.0",
    "dotenv": "^17.2.0",
    "drizzle-kit": "^0.31.4",
-    "drizzle-orm": "^0.44.2",
+    "drizzle-orm": "^0.44.3",
    "drizzle-zod": "^0.7.1",
    "mysql2": "3.14.2",
    "superjson": "2.2.2"
@@ -62,7 +61,7 @@
    "@homarr/tsconfig": "workspace:^0.1.0",
    "@types/better-sqlite3": "7.6.13",
    "dotenv-cli": "^8.0.0",
-    "esbuild": "^0.25.6",
+    "esbuild": "^0.25.8",
    "eslint": "^9.31.0",
    "prettier": "^3.6.2",
    "tsx": "4.20.3",
@@ -92,19 +92,19 @@ export const integrationDefs = {
    name: "Jellyfin",
    secretKinds: [["username", "password"], ["apiKey"]],
    iconUrl: "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons@master/svg/jellyfin.svg",
-    category: ["mediaService"],
+    category: ["mediaService", "mediaRelease"],
  },
  emby: {
    name: "Emby",
    secretKinds: [["apiKey"]],
    iconUrl: "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons@master/svg/emby.svg",
-    category: ["mediaService"],
+    category: ["mediaService", "mediaRelease"],
  },
  plex: {
    name: "Plex",
    secretKinds: [["apiKey"]],
    iconUrl: "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons@master/svg/plex.svg",
-    category: ["mediaService"],
+    category: ["mediaService", "mediaRelease"],
  },
  jellyseerr: {
    name: "Jellyseerr",
@@ -224,6 +224,7 @@ export const integrationDefs = {
      "downloadClient",
      "healthMonitoring",
      "indexerManager",
+      "mediaRelease",
      "mediaRequest",
      "mediaService",
      "mediaTranscoding",
@@ -282,6 +283,7 @@ export const integrationCategories = [
  "mediaService",
  "calendar",
  "mediaSearch",
+  "mediaRelease",
  "mediaRequest",
  "downloadClient",
  "usenet",
@@ -24,6 +24,7 @@ export const widgetKinds = [
  "indexerManager",
  "healthMonitoring",
  "releases",
+  "mediaReleases",
  "dockerContainers",
  "notifications",
 ] as const;
@@ -25,7 +25,7 @@
  "prettier": "@homarr/prettier-config",
  "dependencies": {
    "@homarr/common": "workspace:^0.1.0",
-    "@homarr/env": "workspace:^0.1.0",
+    "@homarr/core": "workspace:^0.1.0",
    "dockerode": "^4.0.7"
  },
  "devDependencies": {
@@ -1,7 +1,6 @@
 import { z } from "zod";

-import { createEnv } from "@homarr/env";
-import { createBooleanSchema } from "@homarr/env/schemas";
+import { createBooleanSchema, createEnv } from "@homarr/core/infrastructure/env";

 export const env = createEnv({
  server: {
@@ -1 +0,0 @@
-export * from "./src";
@@ -0,0 +1,4 @@
+import baseConfig from "@homarr/eslint-config/base";
+
+/** @type {import('typescript-eslint').Config} */
+export default [...baseConfig];
@@ -0,0 +1,39 @@
+{
+  "name": "@homarr/image-proxy",
+  "version": "0.1.0",
+  "private": true,
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "src/*"
+      ]
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf .turbo node_modules",
+    "format": "prettier --check . --ignore-path ../../.gitignore",
+    "lint": "eslint",
+    "typecheck": "tsc --noEmit"
+  },
+  "prettier": "@homarr/prettier-config",
+  "dependencies": {
+    "@homarr/certificates": "workspace:^0.1.0",
+    "@homarr/common": "workspace:^0.1.0",
+    "@homarr/log": "workspace:^0.1.0",
+    "@homarr/redis": "workspace:^0.1.0",
+    "bcrypt": "^6.0.0"
+  },
+  "devDependencies": {
+    "@homarr/eslint-config": "workspace:^0.2.0",
+    "@homarr/prettier-config": "workspace:^0.1.0",
+    "@homarr/tsconfig": "workspace:^0.1.0",
+    "@types/bcrypt": "5.0.2",
+    "eslint": "^9.31.0",
+    "typescript": "^5.8.3"
+  }
+}
@@ -0,0 +1,133 @@
+import bcrypt from "bcrypt";
+
+import { fetchWithTrustedCertificatesAsync } from "@homarr/certificates/server";
+import { createId } from "@homarr/common";
+import { decryptSecret, encryptSecret } from "@homarr/common/server";
+import { logger } from "@homarr/log";
+import { createGetSetChannel } from "@homarr/redis";
+
+const createHashChannel = (hash: `${string}.${string}`) => createGetSetChannel<string>(`image-proxy:hash:${hash}`);
+const createUrlByIdChannel = (id: string) =>
+  createGetSetChannel<{
+    url: `${string}.${string}`;
+    headers: `${string}.${string}`;
+  }>(`image-proxy:url:${id}`);
+const saltChannel = createGetSetChannel<string>("image-proxy:salt");
+
+export class ImageProxy {
+  private static salt: string | null = null;
+  private async getOrCreateSaltAsync(): Promise<string> {
+    if (ImageProxy.salt) return ImageProxy.salt;
+    const existingSalt = await saltChannel.getAsync();
+    if (existingSalt) {
+      ImageProxy.salt = existingSalt;
+      return existingSalt;
+    }
+
+    const salt = await bcrypt.genSalt(10);
+    logger.debug(`Generated new salt for image proxy salt="${salt}"`);
+    ImageProxy.salt = salt;
+    await saltChannel.setAsync(salt);
+    return salt;
+  }
+
+  public async createImageAsync(url: string, headers?: Record<string, string>): Promise<string> {
+    const existingId = await this.getExistingIdAsync(url, headers);
+    if (existingId) {
+      logger.debug(
+        `Image already exists in the proxy id="${existingId}" url="${this.redactUrl(url)}" headers="${this.redactHeaders(headers ?? null)}"`,
+      );
+      return this.createImageUrl(existingId);
+    }
+
+    const id = createId();
+    await this.storeImageAsync(id, url, headers);
+
+    return this.createImageUrl(id);
+  }
+
+  public async forwardImageAsync(id: string): Promise<Blob | null> {
+    const urlAndHeaders = await this.getImageUrlAndHeadersAsync(id);
+    if (!urlAndHeaders) {
+      return null;
+    }
+
+    const response = await fetchWithTrustedCertificatesAsync(urlAndHeaders.url, {
+      headers: urlAndHeaders.headers ?? {},
+    });
+
+    const proxyUrl = this.createImageUrl(id);
+    if (!response.ok) {
+      logger.error(
+        `Failed to fetch image id="${id}" url="${this.redactUrl(urlAndHeaders.url)}" headers="${this.redactHeaders(urlAndHeaders.headers)}" proxyUrl="${proxyUrl}" statusCode="${response.status}"`,
+      );
+      return null;
+    }
+
+    const blob = (await response.blob()) as Blob;
+    logger.debug(
+      `Forwarding image succeeded id="${id}" url="${this.redactUrl(urlAndHeaders.url)}" headers="${this.redactHeaders(urlAndHeaders.headers)}" proxyUrl="${proxyUrl} size="${(blob.size / 1024).toFixed(1)}KB"`,
+    );
+
+    return blob;
+  }
+
+  private createImageUrl(id: string): string {
+    return `/api/image-proxy/${id}`;
+  }
+
+  private async getImageUrlAndHeadersAsync(id: string) {
+    const urlHeaderChannel = createUrlByIdChannel(id);
+    const urlHeader = await urlHeaderChannel.getAsync();
+    if (!urlHeader) {
+      logger.warn(`Image not found in the proxy id="${id}"`);
+      return null;
+    }
+
+    return {
+      url: decryptSecret(urlHeader.url),
+      headers: JSON.parse(decryptSecret(urlHeader.headers)) as Record<string, string> | null,
+    };
+  }
+
+  private async getExistingIdAsync(url: string, headers: Record<string, string> | undefined): Promise<string | null> {
+    const salt = await this.getOrCreateSaltAsync();
+    const urlHash = await bcrypt.hash(url, salt);
+    const headerHash = await bcrypt.hash(JSON.stringify(headers ?? null), salt);
+
+    const channel = createHashChannel(`${urlHash}.${headerHash}`);
+    return await channel.getAsync();
+  }
+
+  private async storeImageAsync(id: string, url: string, headers: Record<string, string> | undefined): Promise<void> {
+    const salt = await this.getOrCreateSaltAsync();
+    const urlHash = await bcrypt.hash(url, salt);
+    const headerHash = await bcrypt.hash(JSON.stringify(headers ?? null), salt);
+
+    const hashChannel = createHashChannel(`${urlHash}.${headerHash}`);
+    const urlHeaderChannel = createUrlByIdChannel(id);
+    await urlHeaderChannel.setAsync({
+      url: encryptSecret(url),
+      headers: encryptSecret(JSON.stringify(headers ?? null)),
+    });
+    await hashChannel.setAsync(id);
+
+    logger.debug(
+      `Stored image in the proxy id="${id}" url="${this.redactUrl(url)}" headers="${this.redactHeaders(headers ?? null)}"`,
+    );
+  }
+
+  private redactUrl(url: string): string {
+    const urlObject = new URL(url);
+
+    const redactedSearch = [...urlObject.searchParams.keys()].map((key) => `${key}=REDACTED`).join("&");
+
+    return `${urlObject.origin}${urlObject.pathname}${redactedSearch ? `?${redactedSearch}` : ""}`;
+  }
+
+  private redactHeaders(headers: Record<string, string> | null): string | null {
+    if (!headers) return null;
+
+    return Object.keys(headers).join(", ");
+  }
+}
@@ -0,0 +1,9 @@
+{
+  "extends": "@homarr/tsconfig/base.json",
+  "compilerOptions": {
+    "types": ["node"],
+    "tsBuildInfoFile": "node_modules/.cache/tsbuildinfo.json"
+  },
+  "include": ["*.ts", "src"],
+  "exclude": ["node_modules"]
+}
@@ -28,11 +28,12 @@
    "@ctrl/deluge": "^7.1.0",
    "@ctrl/qbittorrent": "^9.6.0",
    "@ctrl/transmission": "^7.2.0",
-    "@gitbeaker/rest": "^42.5.0",
+    "@gitbeaker/rest": "^43.3.0",
    "@homarr/certificates": "workspace:^0.1.0",
    "@homarr/common": "workspace:^0.1.0",
    "@homarr/db": "workspace:^0.1.0",
    "@homarr/definitions": "workspace:^0.1.0",
+    "@homarr/image-proxy": "workspace:^0.1.0",
    "@homarr/log": "workspace:^0.1.0",
    "@homarr/node-unifi": "^2.6.0",
    "@homarr/redis": "workspace:^0.1.0",
@@ -44,7 +45,7 @@
    "octokit": "^5.0.3",
    "proxmox-api": "1.1.1",
    "tsdav": "^2.1.5",
-    "undici": "7.11.0",
+    "undici": "7.12.0",
    "xml2js": "^0.6.2",
    "zod": "^3.25.76"
  },
@@ -2,6 +2,7 @@ import { BaseItemKind } from "@jellyfin/sdk/lib/generated-client/models";
 import { z } from "zod";

 import { fetchWithTrustedCertificatesAsync } from "@homarr/certificates/server";
+import { ResponseError } from "@homarr/common/server";

 import type { IntegrationTestingInput } from "../base/integration";
 import { Integration } from "../base/integration";
@@ -10,6 +11,7 @@ import type { TestingResult } from "../base/test-connection/test-connection-serv
 import type { IMediaServerIntegration } from "../interfaces/media-server/media-server-integration";
 import type { CurrentSessionsInput, StreamSession } from "../interfaces/media-server/media-server-types";
 import { convertJellyfinType } from "../jellyfin/jellyfin-integration";
+import type { IMediaReleasesIntegration, MediaRelease } from "../types";

 const sessionSchema = z.object({
  NowPlayingItem: z
@@ -31,7 +33,34 @@ const sessionSchema = z.object({
  UserName: z.string().nullish(),
 });

-export class EmbyIntegration extends Integration implements IMediaServerIntegration {
+const itemSchema = z.object({
+  Id: z.string(),
+  ServerId: z.string(),
+  Name: z.string(),
+  Taglines: z.array(z.string()),
+  Studios: z.array(z.object({ Name: z.string() })),
+  Overview: z.string().optional(),
+  PremiereDate: z
+    .string()
+    .datetime()
+    .transform((date) => new Date(date))
+    .optional(),
+  DateCreated: z
+    .string()
+    .datetime()
+    .transform((date) => new Date(date)),
+  Genres: z.array(z.string()),
+  CommunityRating: z.number().optional(),
+  RunTimeTicks: z.number(),
+  Type: z.string(), // for example "Movie"
+});
+
+const userSchema = z.object({
+  Id: z.string(),
+  Name: z.string(),
+});
+
+export class EmbyIntegration extends Integration implements IMediaServerIntegration, IMediaReleasesIntegration {
  private static readonly apiKeyHeader = "X-Emby-Token";
  private static readonly deviceId = "homarr-emby-integration";
  private static readonly authorizationHeaderValue = `Emby Client="Dashboard", Device="Homarr", DeviceId="${EmbyIntegration.deviceId}", Version="0.0.1"`;
@@ -103,4 +132,69 @@ export class EmbyIntegration extends Integration implements IMediaServerIntegrat
        };
      });
  }
+
+  public async getMediaReleasesAsync(): Promise<MediaRelease[]> {
+    const limit = 100;
+    const users = await this.fetchUsersPublicAsync();
+    const userId = users.at(0)?.id;
+    if (!userId) {
+      throw new Error("No users found");
+    }
+
+    const apiKey = super.getSecretValue("apiKey");
+    const response = await fetchWithTrustedCertificatesAsync(
+      super.url(
+        `/Users/${userId}/Items/Latest?Limit=${limit}&Fields=CommunityRating,Studios,PremiereDate,Genres,ChildCount,ProductionYear,DateCreated,Overview,Taglines`,
+      ),
+      {
+        headers: {
+          [EmbyIntegration.apiKeyHeader]: apiKey,
+          Authorization: EmbyIntegration.authorizationHeaderValue,
+        },
+      },
+    );
+
+    if (!response.ok) {
+      throw new ResponseError(response);
+    }
+
+    const items = z.array(itemSchema).parse(await response.json());
+
+    return items.map((item) => ({
+      id: item.Id,
+      type: item.Type === "Movie" ? "movie" : item.Type === "Series" ? "tv" : "unknown",
+      title: item.Name,
+      subtitle: item.Taglines.at(0),
+      description: item.Overview,
+      releaseDate: item.PremiereDate ?? item.DateCreated,
+      imageUrls: {
+        poster: super.url(`/Items/${item.Id}/Images/Primary?maxHeight=492&maxWidth=328&quality=90`).toString(),
+        backdrop: super.url(`/Items/${item.Id}/Images/Backdrop/0?maxWidth=960&quality=70`).toString(),
+      },
+      producer: item.Studios.at(0)?.Name,
+      rating: item.CommunityRating?.toFixed(1),
+      tags: item.Genres,
+      href: super.url(`/web/index.html#!/item?id=${item.Id}&serverId=${item.ServerId}`).toString(),
+    }));
+  }
+
+  // https://dev.emby.media/reference/RestAPI/UserService/getUsersPublic.html
+  private async fetchUsersPublicAsync(): Promise<{ id: string; name: string }[]> {
+    const apiKey = super.getSecretValue("apiKey");
+    const response = await fetchWithTrustedCertificatesAsync(super.url("/Users/Public"), {
+      headers: {
+        [EmbyIntegration.apiKeyHeader]: apiKey,
+        Authorization: EmbyIntegration.authorizationHeaderValue,
+      },
+    });
+    if (!response.ok) {
+      throw new ResponseError(response);
+    }
+    const users = z.array(userSchema).parse(await response.json());
+
+    return users.map((user) => ({
+      id: user.Id,
+      name: user.Name,
+    }));
+  }
 }
@@ -0,0 +1,76 @@
+import type { MantineColor } from "@mantine/core";
+
+export const mediaTypeConfigurations = {
+  movie: {
+    color: "blue",
+  },
+  tv: {
+    color: "violet",
+  },
+  music: {
+    color: "green",
+  },
+  book: {
+    color: "orange",
+  },
+  game: {
+    color: "yellow",
+  },
+  video: {
+    color: "red",
+  },
+  article: {
+    color: "pink",
+  },
+  unknown: {
+    color: "gray",
+  },
+} satisfies Record<string, { color: MantineColor }>;
+
+export type MediaType = keyof typeof mediaTypeConfigurations;
+
+export interface MediaRelease {
+  id: string;
+  type: MediaType;
+  title: string;
+  /**
+   * The subtitle of the media item, if applicable.
+   * Can also contain the season number for TV shows.
+   */
+  subtitle?: string;
+  description?: string;
+  releaseDate: Date;
+  imageUrls: {
+    poster: string | undefined;
+    backdrop: string | undefined;
+  };
+  /**
+   * The name of the studio, publisher or author.
+   */
+  producer?: string;
+  /**
+   * Price in USD
+   */
+  price?: number;
+  /**
+   * Rating in any format (e.g. 5/10, 4.5/5, 90%, etc.)
+   */
+  rating?: string;
+  /**
+   * List of tags / genres / categories
+   */
+  tags: string[];
+  /**
+   * Link to the media item
+   */
+  href: string;
+  /*
+   * Video / Music: duration in seconds
+   * Book: number of pages
+   */
+  length?: number;
+}
+
+export interface IMediaReleasesIntegration {
+  getMediaReleasesAsync(): Promise<MediaRelease[]>;
+}
@@ -2,6 +2,8 @@ import { Jellyfin } from "@jellyfin/sdk";
 import { BaseItemKind } from "@jellyfin/sdk/lib/generated-client/models";
 import { getSessionApi } from "@jellyfin/sdk/lib/utils/api/session-api";
 import { getSystemApi } from "@jellyfin/sdk/lib/utils/api/system-api";
+import { getUserApi } from "@jellyfin/sdk/lib/utils/api/user-api";
+import { getUserLibraryApi } from "@jellyfin/sdk/lib/utils/api/user-library-api";
 import type { AxiosInstance } from "axios";

 import { createAxiosCertificateInstanceAsync } from "@homarr/certificates/server";
@@ -13,9 +15,10 @@ import { Integration } from "../base/integration";
 import type { TestingResult } from "../base/test-connection/test-connection-service";
 import type { IMediaServerIntegration } from "../interfaces/media-server/media-server-integration";
 import type { CurrentSessionsInput, StreamSession } from "../interfaces/media-server/media-server-types";
+import type { IMediaReleasesIntegration, MediaRelease } from "../types";

@HandleIntegrationErrors([integrationAxiosHttpErrorHandler])
-export class JellyfinIntegration extends Integration implements IMediaServerIntegration {
+export class JellyfinIntegration extends Integration implements IMediaServerIntegration, IMediaReleasesIntegration {
  private readonly jellyfin: Jellyfin = new Jellyfin({
    clientInfo: {
      name: "Homarr",
@@ -70,6 +73,43 @@ export class JellyfinIntegration extends Integration implements IMediaServerInte
      });
  }

+  public async getMediaReleasesAsync(): Promise<MediaRelease[]> {
+    const apiClient = await this.getApiAsync();
+    const userLibraryApi = getUserLibraryApi(apiClient);
+    const userApi = getUserApi(apiClient);
+
+    const users = await userApi.getUsers();
+    const userId = users.data.at(0)?.Id;
+    if (!userId) {
+      throw new Error("No users found");
+    }
+
+    const result = await userLibraryApi.getLatestMedia({
+      fields: ["CustomRating", "Studios", "Genres", "ChildCount", "DateCreated", "Overview", "Taglines"],
+      userId,
+      limit: 100,
+    });
+    return result.data.map((item) => ({
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+      id: item.Id!,
+      type: item.Type === "Movie" ? "movie" : item.Type === "Series" ? "tv" : "unknown",
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+      title: item.Name!,
+      subtitle: item.Taglines?.at(0),
+      description: item.Overview ?? undefined,
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+      releaseDate: new Date(item.PremiereDate ?? item.DateCreated!),
+      imageUrls: {
+        poster: super.url(`/Items/${item.Id}/Images/Primary?maxHeight=492&maxWidth=328&quality=90`).toString(),
+        backdrop: super.url(`/Items/${item.Id}/Images/Backdrop/0?maxWidth=960&quality=70`).toString(),
+      },
+      producer: item.Studios?.at(0)?.Name ?? undefined,
+      rating: item.CommunityRating?.toFixed(1),
+      tags: item.Genres ?? [],
+      href: super.url(`/web/index.html#!/details?id=${item.Id}&serverId=${item.ServerId}`).toString(),
+    }));
+  }
+
  /**
   * Constructs an ApiClient synchronously with an ApiKey or asynchronously
   * with a username and password.
@@ -0,0 +1,128 @@
+import type { IMediaReleasesIntegration, MediaRelease } from "../../interfaces/media-releases";
+
+export class MediaReleasesMockService implements IMediaReleasesIntegration {
+  public async getMediaReleasesAsync(): Promise<MediaRelease[]> {
+    return await Promise.resolve(mockMediaReleases);
+  }
+}
+
+export const mockMediaReleases: MediaRelease[] = [
+  {
+    id: "1",
+    type: "movie",
+    title: "Inception",
+    subtitle: "A mind-bending thriller",
+    description:
+      "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO.",
+    releaseDate: new Date("2010-07-16"),
+    imageUrls: {
+      poster: "https://media.outnow.ch/Movies/Bilder/2025/MinecraftMovie/015.jpg",
+      backdrop: "https://example.com/inception_backdrop.jpg",
+    },
+    producer: "Warner Bros.",
+    price: 14.99,
+    rating: "8.8/10",
+    tags: ["Sci-Fi", "Thriller"],
+    href: "https://example.com/inception",
+    length: 148,
+  },
+  {
+    id: "2",
+    type: "tv",
+    title: "Breaking Bad",
+    subtitle: "S5E14 - Ozymandias",
+    description: "When Walter White's secret is revealed, he must face the consequences of his actions.",
+    releaseDate: new Date("2013-09-15"),
+    imageUrls: {
+      poster: "https://media.outnow.ch/Movies/Bilder/2025/MinecraftMovie/015.jpg",
+      backdrop: "https://example.com/breaking_bad_backdrop.jpg",
+    },
+    producer: "AMC",
+    rating: "9.5/10",
+    tags: ["Crime", "Drama"],
+    href: "https://example.com/breaking_bad",
+  },
+  {
+    id: "3",
+    type: "music",
+    title: "Random Access Memories",
+    subtitle: "Daft Punk",
+    description: "The fourth studio album by French electronic music duo Daft Punk.",
+    releaseDate: new Date("2013-05-17"),
+    imageUrls: {
+      poster: "https://media.outnow.ch/Movies/Bilder/2025/MinecraftMovie/015.jpg",
+      backdrop: "https://example.com/ram_backdrop.jpg",
+    },
+    producer: "Columbia Records",
+    price: 9.99,
+    rating: "8.5/10",
+    tags: ["Electronic", "Dance", "Pop", "Funk"],
+    href: "https://example.com/ram",
+  },
+  {
+    id: "4",
+    type: "book",
+    title: "The Great Gatsby",
+    subtitle: "F. Scott Fitzgerald",
+    description: "A novel about the American dream and the disillusionment that comes with it.",
+    releaseDate: new Date("1925-04-10"),
+    imageUrls: {
+      poster: "https://media.outnow.ch/Movies/Bilder/2025/MinecraftMovie/015.jpg",
+      backdrop: "https://example.com/gatsby_backdrop.jpg",
+    },
+    producer: "Scribner",
+    price: 10.99,
+    rating: "4.2/5",
+    tags: ["Classic", "Fiction"],
+    href: "https://example.com/gatsby",
+  },
+  {
+    id: "5",
+    type: "game",
+    title: "The Legend of Zelda: Breath of the Wild",
+    subtitle: "Nintendo Switch",
+    description: "An open-world action-adventure game set in the fantasy land of Hyrule.",
+    releaseDate: new Date("2017-03-03"),
+    imageUrls: {
+      poster: "https://media.outnow.ch/Movies/Bilder/2025/MinecraftMovie/015.jpg",
+      backdrop: "https://example.com/zelda_backdrop.jpg",
+    },
+    producer: "Nintendo",
+    price: 59.99,
+    rating: "10/10",
+    tags: ["Action", "Adventure"],
+    href: "https://example.com/zelda",
+  },
+  {
+    id: "6",
+    type: "article",
+    title: "The Rise of AI in Healthcare",
+    subtitle: "Tech Innovations",
+    description: "Exploring the impact of artificial intelligence on the healthcare industry.",
+    releaseDate: new Date("2023-10-01"),
+    imageUrls: {
+      poster: "https://media.outnow.ch/Movies/Bilder/2025/MinecraftMovie/015.jpg",
+      backdrop: "https://example.com/ai_healthcare_backdrop.jpg",
+    },
+    producer: "Tech Innovations",
+    rating: "4.8/5",
+    tags: ["Technology", "Healthcare"],
+    href: "https://example.com/ai_healthcare",
+  },
+  {
+    id: "7",
+    type: "video",
+    title: "Wir LIEBEN unsere MAMAS | 50 Fragen zu Mamas",
+    releaseDate: new Date("2024-05-18T17:00:00Z"),
+    imageUrls: {
+      poster:
+        "https://i.ytimg.com/vi/a3qyfXc1Pfg/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBQKm0viRlfRjTV-V24vGO83rPaVw",
+      backdrop:
+        "https://i.ytimg.com/vi/a3qyfXc1Pfg/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBQKm0viRlfRjTV-V24vGO83rPaVw",
+    },
+    producer: "PietSmiet",
+    rating: "1K",
+    tags: [],
+    href: "https://www.youtube.com/watch?v=a3qyfXc1Pfg",
+  },
+];
@@ -9,6 +9,7 @@ import type {
  ISystemHealthMonitoringIntegration,
 } from "../interfaces/health-monitoring/health-monitoring-integration";
 import type { IIndexerManagerIntegration } from "../interfaces/indexer-manager/indexer-manager-integration";
+import type { IMediaReleasesIntegration } from "../interfaces/media-releases";
 import type { IMediaRequestIntegration } from "../interfaces/media-requests/media-request-integration";
 import type { IMediaServerIntegration } from "../interfaces/media-server/media-server-integration";
 import type { IMediaTranscodingIntegration } from "../interfaces/media-transcoding/media-transcoding-integration";
@@ -19,6 +20,7 @@ import { ClusterHealthMonitoringMockService } from "./data/cluster-health-monito
 import { DnsHoleMockService } from "./data/dns-hole";
 import { DownloadClientMockService } from "./data/download";
 import { IndexerManagerMockService } from "./data/indexer-manager";
+import { MediaReleasesMockService } from "./data/media-releases";
 import { MediaRequestMockService } from "./data/media-request";
 import { MediaServerMockService } from "./data/media-server";
 import { MediaTranscodingMockService } from "./data/media-transcoding";
@@ -36,6 +38,7 @@ export class MockIntegration
    IClusterHealthMonitoringIntegration,
    ISystemHealthMonitoringIntegration,
    IIndexerManagerIntegration,
+    IMediaReleasesIntegration,
    IMediaRequestIntegration,
    IMediaServerIntegration,
    IMediaTranscodingIntegration,
@@ -48,6 +51,7 @@ export class MockIntegration
  private static readonly clusterMonitoring = new ClusterHealthMonitoringMockService();
  private static readonly systemMonitoring = new SystemHealthMonitoringMockService();
  private static readonly indexerManager = new IndexerManagerMockService();
+  private static readonly mediaReleases = new MediaReleasesMockService();
  private static readonly mediaRequest = new MediaRequestMockService();
  private static readonly mediaServer = new MediaServerMockService();
  private static readonly mediaTranscoding = new MediaTranscodingMockService();
@@ -87,6 +91,9 @@ export class MockIntegration
  getIndexersAsync = MockIntegration.indexerManager.getIndexersAsync.bind(MockIntegration.indexerManager);
  testAllAsync = MockIntegration.indexerManager.testAllAsync.bind(MockIntegration.indexerManager);

+  // MediaReleasesIntegration
+  getMediaReleasesAsync = MockIntegration.mediaReleases.getMediaReleasesAsync.bind(MockIntegration.mediaReleases);
+
  // MediaRequestIntegration
  getSeriesInformationAsync = MockIntegration.mediaRequest.getSeriesInformationAsync.bind(MockIntegration.mediaRequest);
  requestMediaAsync = MockIntegration.mediaRequest.requestMediaAsync.bind(MockIntegration.mediaRequest);
@@ -1,7 +1,9 @@
 import { parseStringPromise } from "xml2js";
+import { z } from "zod";

 import { fetchWithTrustedCertificatesAsync } from "@homarr/certificates/server";
 import { ParseError } from "@homarr/common/server";
+import { ImageProxy } from "@homarr/image-proxy";
 import { logger } from "@homarr/log";

 import type { IntegrationTestingInput } from "../base/integration";
@@ -10,9 +12,10 @@ import { TestConnectionError } from "../base/test-connection/test-connection-err
 import type { TestingResult } from "../base/test-connection/test-connection-service";
 import type { IMediaServerIntegration } from "../interfaces/media-server/media-server-integration";
 import type { CurrentSessionsInput, StreamSession } from "../interfaces/media-server/media-server-types";
+import type { IMediaReleasesIntegration, MediaRelease } from "../types";
 import type { PlexResponse } from "./interface";

-export class PlexIntegration extends Integration implements IMediaServerIntegration {
+export class PlexIntegration extends Integration implements IMediaServerIntegration, IMediaReleasesIntegration {
  public async getCurrentSessionsAsync(_options: CurrentSessionsInput): Promise<StreamSession[]> {
    const token = super.getSecretValue("apiKey");

@@ -66,6 +69,93 @@ export class PlexIntegration extends Integration implements IMediaServerIntegrat
    return medias;
  }

+  public async getMediaReleasesAsync(): Promise<MediaRelease[]> {
+    const token = super.getSecretValue("apiKey");
+    const machineIdentifier = await this.getMachineIdentifierAsync();
+    const response = await fetchWithTrustedCertificatesAsync(super.url("/library/recentlyAdded"), {
+      headers: {
+        "X-Plex-Token": token,
+        Accept: "application/json",
+      },
+    });
+
+    const data = await recentlyAddedSchema.parseAsync(await response.json());
+    const imageProxy = new ImageProxy();
+
+    const images =
+      data.MediaContainer.Metadata?.flatMap((item) => [
+        {
+          mediaKey: item.key,
+          type: "poster",
+          url: item.Image.find((image) => image?.type === "coverPoster")?.url,
+        },
+        {
+          mediaKey: item.key,
+          type: "backdrop",
+          url: item.Image.find((image) => image?.type === "background")?.url,
+        },
+      ]).filter(
+        (image): image is { mediaKey: string; type: "poster" | "backdrop"; url: string } => image.url !== undefined,
+      ) ?? [];
+
+    const proxiedImages = await Promise.all(
+      images.map(async (image) => {
+        const imageUrl = super.url(image.url as `/${string}`);
+        const proxiedImageUrl = await imageProxy
+          .createImageAsync(imageUrl.toString(), {
+            "X-Plex-Token": token,
+          })
+          .catch((error) => {
+            logger.debug(new Error("Failed to proxy image", { cause: error }));
+            return undefined;
+          });
+        return {
+          mediaKey: image.mediaKey,
+          type: image.type,
+          url: proxiedImageUrl,
+        };
+      }),
+    );
+
+    return (
+      data.MediaContainer.Metadata?.map((item) => {
+        return {
+          id: item.Media.at(0)?.id.toString() ?? item.key,
+          type: item.type === "movie" ? "movie" : item.type === "tv" ? "tv" : "unknown",
+          title: item.title,
+          subtitle: item.tagline,
+          description: item.summary,
+          releaseDate: item.originallyAvailableAt
+            ? new Date(item.originallyAvailableAt)
+            : new Date(item.addedAt * 1000),
+          imageUrls: {
+            poster: proxiedImages.find((image) => image.mediaKey === item.key && image.type === "poster")?.url,
+            backdrop: proxiedImages.find((image) => image.mediaKey === item.key && image.type === "backdrop")?.url,
+          },
+          producer: item.studio,
+          rating: item.rating?.toFixed(1),
+          tags: item.Genre.map((genre) => genre.tag),
+          href: super
+            .url(`/web/index.html#!/server/${machineIdentifier}/details?key=${encodeURIComponent(item.key)}`)
+            .toString(),
+          length: item.duration ? Math.round(item.duration / 1000) : undefined,
+        };
+      }) ?? []
+    );
+  }
+
+  private async getMachineIdentifierAsync(): Promise<string> {
+    const token = super.getSecretValue("apiKey");
+    const response = await fetchWithTrustedCertificatesAsync(super.url("/identity"), {
+      headers: {
+        "X-Plex-Token": token,
+        Accept: "application/json",
+      },
+    });
+    const data = await identitySchema.parseAsync(await response.json());
+    return data.MediaContainer.machineIdentifier;
+  }
+
  protected async testingAsync(input: IntegrationTestingInput): Promise<TestingResult> {
    const token = super.getSecretValue("apiKey");

@@ -111,3 +201,50 @@ export class PlexIntegration extends Integration implements IMediaServerIntegrat
    }
  }
 }
+
+// https://plexapi.dev/api-reference/library/get-recently-added
+const recentlyAddedSchema = z.object({
+  MediaContainer: z.object({
+    Metadata: z
+      .array(
+        z.object({
+          key: z.string(),
+          studio: z.string().optional(),
+          type: z.string(), // For example "movie"
+          title: z.string(),
+          summary: z.string().optional(),
+          duration: z.number().optional(),
+          addedAt: z.number(),
+          rating: z.number().optional(),
+          tagline: z.string().optional(),
+          originallyAvailableAt: z.string().optional(),
+          Media: z.array(
+            z.object({
+              id: z.number(),
+            }),
+          ),
+          Image: z.array(
+            z
+              .object({
+                type: z.string(), // for example "coverPoster" or "background"
+                url: z.string(),
+              })
+              .optional(),
+          ),
+          Genre: z.array(
+            z.object({
+              tag: z.string(),
+            }),
+          ),
+        }),
+      )
+      .optional(),
+  }),
+});
+
+// https://plexapi.dev/api-reference/server/get-server-identity
+const identitySchema = z.object({
+  MediaContainer: z.object({
+    machineIdentifier: z.string(),
+  }),
+});
@@ -8,3 +8,4 @@ export * from "./base/searchable-integration";
 export * from "./homeassistant/homeassistant-types";
 export * from "./proxmox/proxmox-types";
 export * from "./unifi-controller/unifi-controller-types";
+export * from "./interfaces/media-releases";
@@ -6,6 +6,7 @@
  "type": "module",
  "exports": {
    ".": "./src/index.ts",
+    "./constants": "./src/constants.ts",
    "./env": "./src/env.ts"
  },
  "typesVersions": {
@@ -23,8 +24,7 @@
  },
  "prettier": "@homarr/prettier-config",
  "dependencies": {
-    "@homarr/env": "workspace:^0.1.0",
-    "ioredis": "5.6.1",
+    "@homarr/core": "workspace:^0.1.0",
    "superjson": "2.2.2",
    "winston": "3.17.0",
    "zod": "^3.25.76"
Author	SHA1	Message	Date
Releases Homarr	fd62524db3	chore(release): 1.30.0 [skip ci]	2025-07-21 08:43:16 +00:00
homarr-releases[bot]	4f0ba7a191	chore(release): automatic release v1.30.0	2025-07-21 08:42:26 +00:00
Meier Lukas	ecda928bef	fix(security): upgrade eslint-config-prettier to latest version without malicious code	2025-07-21 07:54:13 +00:00
homarr-renovate[bot]	bf88f0d091	fix(deps): update dependency @tabler/icons-react to ^3.34.1 (#3661 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-21 01:25:53 +00:00
homarr-renovate[bot]	98f8279b61	fix(deps): update testcontainers-node monorepo to ^11.3.1 (#3659 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-20 15:21:47 +00:00
Meier Lukas	8e960324bc	feat(infra): add external redis (#3639 )	2025-07-20 17:13:57 +02:00
homarr-renovate[bot]	732bce72ae	fix(deps): update dependency @gitbeaker/rest to v43 (#3623 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-20 17:00:34 +02:00
Meier Lukas	66ebb5061f	feat(widgets): add media release widget (#3219 )	2025-07-20 16:59:03 +02:00
homarr-renovate[bot]	fa8e704112	chore(deps): update dependency prettier-plugin-packagejson to ^2.5.19 (#3658 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-20 14:21:07 +00:00
homarr-renovate[bot]	3f29a453b9	chore(deps): update dependency esbuild to ^0.25.8 (#3657 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-19 20:22:44 +00:00
Andre Silva	36b0f576e5	fix: improved import from docker parsing (#3642 )	2025-07-19 21:22:11 +02:00
Manuel	18c3ed559e	chore: update issue template with 1.29.0	2025-07-19 15:25:12 +02:00
homarr-renovate[bot]	6fca92ac49	chore(deps): update dependency esbuild to ^0.25.7 (#3655 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-18 23:21:52 +00:00
homarr-renovate[bot]	42301b4a1e	fix(deps): update nextjs monorepo to v15.4.2 (#3654 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-18 21:22:56 +00:00
homarr-renovate[bot]	2394159f8b	fix(deps): update testcontainers-node monorepo to ^11.3.0 (#3652 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-18 20:23:21 +00:00
Releases Homarr	c2305d4e27	chore(release): 1.29.0 [skip ci]	2025-07-18 19:17:18 +00:00
homarr-releases[bot]	ba51d71c48	chore(release): automatic release v1.29.0	2025-07-18 19:16:23 +00:00
homarr-renovate[bot]	1cc6ecbce2	fix(deps): update dependency eslint-config-prettier to ^10.1.7 (#3651 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-18 16:29:08 +00:00
homarr-renovate[bot]	cf0d2d3cda	fix(deps): update dependency undici to v7.12.0 (#3650 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-18 15:22:54 +00:00
homarr-renovate[bot]	553f192605	chore(deps): update dependency proxmox-api>undici to v7.12.0 (#3649 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-18 14:23:08 +00:00
homarr-update-contributors[bot]	7f34c4323e	chore: update contributors (#3648 ) Co-authored-by: Homarr Update Contributors <210161987+homarr-update-contributors[bot]@users.noreply.github.com>	2025-07-18 12:37:14 +00:00
homarr-renovate[bot]	49ef822a26	chore(deps): update dependency @vitejs/plugin-react to ^4.7.0 (#3647 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-18 04:42:12 +00:00
Meier Lukas	c4e5c3002b	feat(logs): add log level selection to tools ui (#3565 )	2025-07-17 10:43:13 +02:00
Meier Lukas	c00110e426	refactor: move usages of create-id to common package (#3606 )	2025-07-17 10:42:11 +02:00
homarr-renovate[bot]	d4acb01efd	fix(deps): update turbo monorepo to ^2.5.5 (#3641 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-16 19:21:49 +00:00
homarr-renovate[bot]	ee983e8241	fix(deps): update dependency swagger-ui-react to ^5.27.0 (#3638 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-16 12:37:48 +00:00
homarr-crowdin[bot]	742d7bddf8	chore(lang): updated translations from crowdin Co-authored-by: Crowdin Homarr <190541745+homarr-crowdin[bot]@users.noreply.github.com>	2025-07-16 00:57:26 +00:00
homarr-renovate[bot]	93ead1b53f	chore(deps): update node.js to v22.17.1 (#3636 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-15 22:22:22 +00:00
homarr-renovate[bot]	11a42c176f	chore(deps): update dependency @types/node to ^22.16.4 (#3634 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-15 17:20:31 +00:00
Andre SilvaandMeier Lukas	47806c180e	feat(releases-widget): show project description when release description is missing (#3635 ) Co-authored-by: Meier Lukas <meierschlumpf@gmail.com>	2025-07-15 18:21:37 +02:00
homarr-crowdin[bot]	fc207b17dc	chore(lang): updated translations from crowdin Co-authored-by: Crowdin Homarr <190541745+homarr-crowdin[bot]@users.noreply.github.com>	2025-07-15 04:26:13 +00:00
homarr-renovate[bot]	39b025f763	fix(deps): update nextjs monorepo to v15.4.1 (#3632 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-14 22:22:28 +00:00
homarr-renovate[bot]	e7012b6da4	fix(deps): update dependency drizzle-orm to ^0.44.3 (#3629 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-14 19:19:57 +00:00
homarr-renovate[bot]	d6ea8e8993	fix(deps): update dependency typescript-eslint to ^8.37.0 (#3631 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-14 18:29:29 +00:00
homarr-renovate[bot]	71dee5ca4b	fix(deps): update dependency ldapts to v8.0.6 (#3628 ) Co-authored-by: homarr-renovate[bot] <158783068+homarr-renovate[bot]@users.noreply.github.com>	2025-07-14 07:25:43 +00:00
homarr-crowdin[bot]	fe018732b5	chore(lang): updated translations from crowdin Co-authored-by: Crowdin Homarr <190541745+homarr-crowdin[bot]@users.noreply.github.com>	2025-07-14 04:50:04 +00:00
homarr-crowdin[bot]	021bb48e1a	chore(lang): updated translations from crowdin Co-authored-by: Crowdin Homarr <190541745+homarr-crowdin[bot]@users.noreply.github.com>	2025-07-13 01:00:58 +00:00
Meier Lukas	f57ba4c8bc	chore(issue-template): add version 1.28.1	2025-07-12 11:11:42 +02:00
@@ -1 +1 @@
 .17.0
 .17.1
				`@@ -1 +0,0 @@`
				`export { createId } from "@paralleldrive/cuid2";`