@amoshydra/davison 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 amoshydra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,132 @@
+# davison
+
+A standalone music server that streams your local music library to Sonos speakers and serves it via WebDAV for tools like Music Assistant.
+
+## Features
+
+- **Sonos control** — discover Sonos speakers on your LAN, stream music directly to them
+- **Mobile-first web UI** — browse your music library by folder, control playback, manage queues and playlists
+- **WebDAV server** — expose your music library over WebDAV for Music Assistant, file managers, or any WebDAV client
+- **Direct streaming** — HTTP range-request streaming with album art extraction
+- **Zero configuration** — point it at your music folders and go
+- **No cloud dependency** — everything runs on your local network
+
+## Quick Start
+
+### Prerequisites
+
+- Node.js 22+ (or Docker)
+- Music files on a local or mounted drive
+
+### Via npx
+
+```bash
+npx davison --path /path/to/music
+```
+
+Open http://localhost:3000 in your browser.
+
+### Via Docker
+
+```bash
+docker run -d \
+  --name davison \
+  --network host \
+  -v /path/to/music:/music:ro \
+  ghcr.io/your-username/davison \
+  --path /music
+```
+
+> `--network host` is required for Sonos UPnP discovery to work.
+
+### Via Docker Compose
+
+```yaml
+version: "3.8"
+services:
+  davison:
+    image: ghcr.io/your-username/davison
+    network_mode: host
+    volumes:
+      - /path/to/music:/music:ro
+    command: ["--path", "/music"]
+```
+
+## Usage
+
+### Command-line options
+
+| Option | Description |
+|--------|-------------|
+| `-p, --path <paths...>` | One or more music directories (required) |
+| `--port <number>` | Server port (default: 3000) |
+| `--host <address>` | LAN address (auto-detected if omitted) |
+
+### Web UI
+
+| Tab | Description |
+|-----|-------------|
+| **Library** | Browse music by folder structure |
+| **Queue** | View and manage the current playback queue |
+| **Now Playing** | Full-screen player with album art, vinyl animation, swipe gestures |
+| **Playlists** | Create, edit, and load playlists |
+| **Settings** | Discover and select Sonos devices |
+
+### WebDAV
+
+The WebDAV server is available at `/webdav` (e.g., `http://192.168.0.x:3000/webdav/`). It mirrors your music folder structure. No authentication required.
+
+To use with Music Assistant:
+1. Add a **WebDAV** provider
+2. URL: `http://<your-server-ip>:3000/webdav/`
+3. Leave username/password blank
+4. Content type: `music`
+
+### Sonos
+
+davison discovers Sonos speakers on your LAN automatically via SSDP multicast. Select a speaker from the **Settings** tab and start playing.
+
+## Development
+
+```bash
+git clone https://github.com/your-username/davison.git
+cd davison
+pnpm install
+pnpm run dev -- --path /path/to/music
+```
+
+The dev server hot-reloads on file changes.
+
+## Architecture
+
+```
+                   ┌──────────────────────┐
+                   │    Web Browser        │
+                   │  (React + Vite)       │
+                   └──────────┬───────────┘
+                              │ HTTP (port 3000)
+                   ┌──────────▼───────────┐
+                   │   Express Server      │
+                   │  ┌─────────────────┐  │
+                   │  │ REST API (/api) │  │
+                   │  │ Queue Manager   │  │
+                   │  │ Sonos Controller│  │
+                   │  │ Playlist Store  │  │
+                   │  ├─────────────────┤  │
+                   │  │ WebDAV (/webdav)│  │
+                   │  │ (Nephele VFS)   │  │
+                   │  └─────────────────┘  │
+                   └──────────┬───────────┘
+                              │
+          ┌───────────────────┼───────────────────┐
+          │                   │                   │
+   ┌──────▼──────┐    ┌──────▼──────┐    ┌───────▼──────┐
+   │  Sonos       │    │ Music Files │    │ Music        │
+   │  Speakers    │    │  (on disk)  │    │ Assistant    │
+   │  (UPnP/HTTP) │    │             │    │ (via WebDAV) │
+   └─────────────┘    └─────────────┘    └──────────────┘
+```
+
+## License
+
+MIT

package/bin/davison.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+// `npx @amoshydra/davison` entry point.
+import { spawn, execSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+import { dirname, resolve } from 'node:path'
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const root = resolve(__dirname, '..')
+
+// Apply the Nephele HEAD Content-Length patch if not already applied
+const getHeadPath = resolve(root, 'node_modules', 'nephele', 'dist', 'Methods', 'GET_HEAD.js')
+if (existsSync(getHeadPath)) {
+  const content = readFileSync(getHeadPath, 'utf8')
+  if (!content.includes("'Content-Length':")) {
+    const patchPath = resolve(root, 'patches', 'nephele.patch')
+    if (existsSync(patchPath)) {
+      try {
+        execSync(`patch -p0 < "${patchPath}"`, { cwd: resolve(root, 'node_modules', 'nephele'), stdio: 'pipe' })
+      } catch {
+        // patch wasn't applied, server still works
+      }
+    }
+  }
+}
+    }
+  }
+}
+
+// Auto-build if needed (first run from git clone)
+if (!existsSync(resolve(root, 'dist-server', 'index.js'))) {
+  const viteBin = resolve(root, 'node_modules', '.bin', 'vite')
+  const tscBin = resolve(root, 'node_modules', '.bin', 'tsc')
+  if (existsSync(viteBin) && existsSync(tscBin)) {
+    console.log('Building server and frontend...')
+    try {
+      execSync(`"${tscBin}" -p "${root}/tsconfig.server.json"`, { cwd: root, stdio: 'inherit' })
+      execSync(`"${viteBin}" build`, { cwd: root, stdio: 'inherit' })
+    } catch {
+      console.warn('Build failed — falling back to tsx source')
+    }
+  }
+}
+
+// Try compiled server first, fall back to tsx source
+let entryPoint = resolve(root, 'dist-server', 'index.js')
+if (!existsSync(entryPoint)) {
+  const tsxLoader = resolve(root, 'node_modules', 'tsx', 'dist', 'loader.mjs')
+  if (existsSync(tsxLoader)) {
+    entryPoint = resolve(root, 'server', 'index.ts')
+    spawn(process.execPath, ['--import', tsxLoader, entryPoint, ...process.argv.slice(2)], {
+      stdio: 'inherit',
+      env: { ...process.env, NODE_ENV: process.env.NODE_ENV || 'production' },
+    }).on('exit', (code) => process.exit(code ?? 1))
+  } else {
+    console.error('Server not built. Run: npm run build')
+    process.exit(1)
+  }
+} else {
+  spawn(process.execPath, [entryPoint, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    env: { ...process.env, NODE_ENV: process.env.NODE_ENV || 'production' },
+  }).on('exit', (code) => process.exit(code ?? 1))
+}