From 0e37ad6b323cc15549bd460b8dba7e963a252d29 Mon Sep 17 00:00:00 2001
From: Armin <armin@raumschiff>
Date: Thu, 9 Jul 2026 16:05:06 +0200
Subject: [PATCH] document known limitations in README

---
 README.md  | 5 +++++
 index.html | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 423ecef..730eb61 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,11 @@ There is a live demo available at [bsd.pm/noiz](https://bsd.pm/noiz/).
 
 Open `index.html` in any modern browser. Click **+Folder**, **+Files**, or drag audio files onto the window.
 
+## Known Limitations
+
+- **File path display** — When adding individual files via **+Files** or drag-and-drop, browsers do not expose the full filesystem path for security reasons. Only the filename is shown in the tag editor. Using **+Folder** (which reads directory structure) provides the relative path within the selected folder.
+- **Playback interruption on +Folder** — Opening the native directory picker suspends the browser's `AudioContext`, causing playback to stop. This is a browser-level security restriction (user gesture required for audio resume). Simply press play again after adding files.
+
 ## noizapp
 There is a simple PoC Electron available to make noiz a stand-alone desktop "app":
 https://codeberg.org/armin/noizapp
diff --git a/index.html b/index.html
index 2a3904f..c3fb6df 100644
--- a/index.html
+++ b/index.html
@@ -1160,7 +1160,7 @@ async function processFiles(files, paths) {
     if (!isAudioFile(file.name)) continue;
     prog++;
     const url = URL.createObjectURL(file);
-    const path = paths ? paths[i] : file.name;
+    const path = paths ? paths[i] : (file.path || file.name);
     const [tags, ainfo, duration] = await Promise.all([readTags(file), readAudioInfo(file), readDuration(file)]);
     const name = tags.title || file.name.replace(/\.[^.]+$/, '').replace(/_/g, ' ');
     found.push({