diff --git a/src/components/media-player/ha-media-player-browse.ts b/src/components/media-player/ha-media-player-browse.ts
index 62fe5d1236..1f6af63c66 100644
--- a/src/components/media-player/ha-media-player-browse.ts
+++ b/src/components/media-player/ha-media-player-browse.ts
@@ -22,7 +22,6 @@ import { styleMap } from "lit-html/directives/style-map";
import { fireEvent } from "../../common/dom/fire_event";
import { computeRTLDirection } from "../../common/util/compute_rtl";
import { debounce } from "../../common/util/debounce";
-import type { MediaPlayerItem } from "../../data/media-player";
import {
browseLocalMediaPlayer,
browseMediaPlayer,
@@ -31,6 +30,7 @@ import {
MediaPickedEvent,
MediaPlayerBrowseAction,
} from "../../data/media-player";
+import type { MediaPlayerItem } from "../../data/media-player";
import { showAlertDialog } from "../../dialogs/generic/show-dialog-box";
import { installResizeObserver } from "../../panels/lovelace/common/install-resize-observer";
import { haStyle } from "../../resources/styles";
@@ -357,7 +357,31 @@ export class HaMediaPlayerBrowse extends LitElement {
`
: html`
- ${this.hass.localize("ui.components.media-browser.no_items")}
+ ${this.hass.localize("ui.components.media-browser.no_items")}
+
+ ${currentItem.media_content_id.startsWith(
+ "media-source://media_source/local_source"
+ )
+ ? html`${this.hass.localize(
+ "ui.components.media-browser.learn_adding_local_media",
+ "documentation",
+ html`
${this.hass.localize(
+ "ui.components.media-browser.documentation"
+ )}`
+ )}
+
+ ${this.hass.localize(
+ "ui.components.media-browser.local_media_files"
+ )}.`
+ : ""}
`}
`;
@@ -501,28 +525,31 @@ export class HaMediaPlayerBrowse extends LitElement {
private _renderError(err: { message: string; code: string }) {
if (err.message === "Media directory does not exist.") {
return html`
- No local media found.
+
+ ${this.hass.localize(
+ "ui.components.media-browser.no_local_media_found"
+ )}
+
- It looks like you have not yet created a media directory.
-
Create a directory with the name "media" in the
- configuration directory of Home Assistant
- (${this.hass.config.config_dir}).
Place your video, audio and
- image files in this directory to be able to browse and play them in
- the browser or on supported media players.
-
-
-
- Check the
- documentation
- for more info
+ ${this.hass.localize("ui.components.media-browser.no_media_folder")}
+
+ ${this.hass.localize(
+ "ui.components.media-browser.setup_local_help",
+ "documentation",
+ html`${this.hass.localize(
+ "ui.components.media-browser.documentation"
+ )}`
+ )}
+
+ ${this.hass.localize("ui.components.media-browser.local_media_files")}
`;
}
diff --git a/src/translations/en.json b/src/translations/en.json
index fff67d34fb..5504fd17df 100755
--- a/src/translations/en.json
+++ b/src/translations/en.json
@@ -374,6 +374,12 @@
"video_not_supported": "Your browser does not support the video element.",
"media_not_supported": "The Browser Media Player does not support this type of media",
"media_browsing_error": "Media Browsing Error",
+ "learn_adding_local_media": "Learn more about adding media in the {documentation}.",
+ "local_media_files": "Place your video, audio and image files in the media directory to be able to browse and play them in the browser or on supported media players.",
+ "documentation": "documentation",
+ "no_local_media_found": "No local media found",
+ "no_media_folder": "It looks like you have not yet created a media directory.",
+ "setup_local_help": "Check the {documentation} on how to setup local media.",
"class": {
"album": "Album",
"app": "App",
diff --git a/src/util/documentation-url.ts b/src/util/documentation-url.ts
index 693e9437d8..3ad016be72 100644
--- a/src/util/documentation-url.ts
+++ b/src/util/documentation-url.ts
@@ -2,6 +2,10 @@ import { HomeAssistant } from "../types";
export const documentationUrl = (hass: HomeAssistant, path: string) => {
return `https://${
- hass.config.version.includes("b") ? "rc" : "www"
+ hass.config.version.includes("b")
+ ? "rc"
+ : hass.config.version.includes("dev")
+ ? "next"
+ : "www"
}.home-assistant.io${path}`;
};