maneki 0.10.0__tar.gz

maneki-0.10.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Morten Hansen
+
+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.

maneki-0.10.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: maneki
+Version: 0.10.0
+Summary: Self-hosted media toolkit: audio today (convert / audit / retag rips, Textual TUI, Subsonic-compatible HTTP server), video next (folder-first metadata, HLS streaming).
+Keywords: audio,music,video,hls,media-server,ffmpeg,subsonic,tui,library-manager,musicbrainz,airplay,tailscale
+Author: Morten Hansen
+Author-email: Morten Hansen <morten@winterop.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Multimedia :: Sound/Audio :: Conversion
+Classifier: Topic :: Multimedia :: Sound/Audio :: Players
+Classifier: Topic :: Multimedia :: Video
+Classifier: Typing :: Typed
+Requires-Dist: typer>=0.24.2
+Requires-Dist: mutagen>=1.47.0
+Requires-Dist: rich>=14.0.0
+Requires-Dist: pillow>=11.0.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: pydantic-settings>=2.6.0
+Requires-Dist: fastapi>=0.136.1
+Requires-Dist: uvicorn[standard]>=0.46.0
+Requires-Dist: zeroconf>=0.148.0
+Requires-Dist: watchdog>=6.0.0
+Requires-Dist: paho-mqtt>=2.1.0
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: itsdangerous>=2.2.0
+Requires-Dist: python-multipart>=0.0.27
+Requires-Dist: structlog>=25.5.0
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/winterop-com/maneki
+Project-URL: Repository, https://github.com/winterop-com/maneki
+Project-URL: Documentation, https://winterop-com.github.io/maneki
+Project-URL: Issues, https://github.com/winterop-com/maneki/issues
+Project-URL: Changelog, https://github.com/winterop-com/maneki/releases
+Description-Content-Type: text/markdown
+
+# Maneki
+
+[![CI](https://github.com/winterop-com/maneki/actions/workflows/ci.yml/badge.svg)](https://github.com/winterop-com/maneki/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/maneki)](https://pypi.org/project/maneki/)
+[![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://winterop-com.github.io/maneki/)
+
+Python 3.13 CLI for a self-hosted media library — audio (convert rips + serve via Subsonic) and video (HLS streaming with on-demand segments, sidecar + embedded subtitles, contact-sheet posters, click-in folder browser). Point `maneki serve` at one directory; it scans recursively, auto-detects what's audio and what's video, and serves both kinds plus the web SPA on one port. The Subsonic mount appears only when audio is present, the video mount only when video is present.
+
+## The name
+
+**Maneki** (招き, *mah-neh-kee*) is the Japanese word for *beckoning*. It's the verb-form of *maneki-neko* (招き猫) — the small ceramic cat with a raised paw you've seen on shop counters and restaurant windows across Japan. The cat sits there quietly all day; when you walk in, its paw is already up, inviting you in. Whoever placed it didn't have to do anything; the cat does the welcoming.
+
+A self-hosted media server has the same job. It lives on a box in the corner. You don't see it, you don't manage it, you don't poke at it. When you open the app on your phone or laptop and want to watch a film or play music, your library should already be there, ready, waving you in. No URL to type, no port to remember, no "is the server up?" — just open and play.
+
+That's what `maneki serve <library>` aims to be: the cat on the shelf.
+
+## Install
+
+The lowest-friction way is [`uvx`](https://docs.astral.sh/uv/) — it downloads, caches, and runs the latest published `maneki` in one step. No install step required:
+
+```bash
+uvx maneki --help
+```
+
+For daily / persistent use (PATH-installed, no per-run network check):
+
+```bash
+uv tool install maneki
+maneki --help
+```
+
+You'll also need `ffmpeg` and `ffprobe` on `$PATH` for the convert pipeline:
+
+```bash
+brew install ffmpeg            # macOS
+sudo apt install ffmpeg        # Debian / Ubuntu
+```
+
+## Quickstart
+
+```bash
+# One process, one URL, both protocols. Point at any directory - maneki
+# scans recursively and only mounts the kinds with content.
+uvx maneki serve ~/Downloads/library                     # audio on /audio/rest/*, video on /video/*
+uvx maneki serve ~/Downloads/library --ui                # also serve the web SPA at /
+
+# Shared across audio + video:
+uvx maneki library info    ~/Downloads/library           # kind counts (audio + video)
+uvx maneki library list    ~/Downloads/library           # full file inventory (or `ls`)
+uvx maneki library inspect ~/Downloads/library/some.mkv  # tags + cover (audio) or ffprobe streams (video)
+
+# Audio tooling:
+uvx maneki audio convert ./input ./output                          # convert rips
+uvx maneki audio library audit ./output                            # audit
+uvx maneki audio playlist gen ./output --seed <track> --minutes 60 # auto-generate a mix
+```
+
+## Screenshots
+
+The browser SPA — bordered panels with floating titles, same palette across audio + video. Vertical AUDIO / VIDEO rail on the left switches modes; the rail self-hides when only one kind is mounted at the library root.
+
+Audio — Artists → Albums → Tracks plus Now Playing top band with the FFT spectrum visualizer:
+
+![Browser UI — audio library, Daft Punk · Homework](docs/screenshots/web-audio.png)
+
+Video — folder browser, instant-paint row thumbnails, sticky breadcrumb. Click into any season for the episode list:
+
+![Browser UI — video folder browse](docs/screenshots/web-video-browse.png)
+
+Video player — video.js v8 on the HLS source, contact-sheet poster (16:9, generated server-side from 9 sample frames + header strip with codec / resolution / duration / size), `t` for theater mode, `f` for browser fullscreen, captions menu auto-prefers English / English-SDH:
+
+![Browser UI — video player with contact-sheet poster](docs/screenshots/web-video-player.png)
+
+More in the [serve guide](https://winterop-com.github.io/maneki/guides/serve-unified/) and the [video guide](https://winterop-com.github.io/maneki/guides/video/).
+
+## Documentation
+
+Full docs are at **[docs/](docs/index.md)** — built with MkDocs Material. Run them locally:
+
+```bash
+make docs-serve     # http://127.0.0.1:8000
+```
+
+Or jump straight to:
+
+- [Architecture](docs/architecture.md) — how all the pieces fit together (process model, data flow, audio subprocess, SQLite index, FFT visualizer)
+- [Quickstart](docs/guides/quickstart.md) — end-to-end walkthrough including iPhone + Tailscale + Amperfy
+- [maneki serve](docs/guides/serve-unified.md) — single-library mode, auto-detect, web SPA
+- [maneki library](docs/guides/library.md) — cross-cutting info / list / inspect against any root
+- [maneki audio convert](docs/guides/convert.md) — codec / bitrate / enrichment matrix
+- [maneki audio library](docs/guides/audio-library.md) — audit rules + auto-fix + SQLite index
+- [maneki video](docs/guides/video.md) — HLS, subtitles, posters, folder browser
+- [maneki audio playlist](docs/guides/playlist.md) — auto-generated `.m3u8` mixes anchored to a seed track
+- [Desktop apps](docs/guides/desktop.md) — Tauri + Electron generic Subsonic clients
+- [Mobile (Subsonic)](docs/guides/mobile.md) — play:Sub / Amperfy / Symfonium / DSub / Tempo
+- [Edge cases](docs/edge-cases.md) — every weirdness encountered on real rips
+- [Roadmap](docs/roadmap.md) — what's next
+- [Development](docs/guides/development.md) — directory layout + test patterns + commit style
+
+## Status
+
+v0.9.0 · audio (Subsonic-compat) + video (HLS, sidecar + embedded subtitles, 16:9 contact-sheet posters, folder browser, watcher hot-reload) share one `maneki serve` and the web SPA at `/`. ruff + mypy + pyright clean, full pytest suite green (648 tests).
+
+**Audio**: OpenSubsonic-compatible (`multipleGenres`, `transcodeOffset`, `songLyrics` extensions), backs heart / star buttons with a persistent `<root>/.maneki/stars.toml`, returns sub-ms FTS5-ranked `/search3` results, promotes LRC lyrics to `synced: true`, tested against Symfonium / Amperfy / play:Sub / Feishin on iOS / Android / desktop. Persistent SQLite library index at `<root>/.maneki/index.db` keeps cold starts under a second; the filesystem watcher does per-album incremental rescans.
+
+**Video**: on-demand HLS with bounded foreground concurrency (rapid seeks don't wedge the player), single-ffmpeg multi-stream subtitle extraction (a 45-track .mkv opens in ~2s instead of stalling on 45 parallel ffmpegs), instant-paint row thumbnails + 16:9 contact-sheet posters with hash-derived cache filenames (deeply-nested rel paths don't blow NAME_MAX), `--no-cover-images` to skip contact sheets entirely on slow disks, `--prewarm-cache` to fill thumbs / posters / subtitles at startup, watcher hot-reload of the SQLite-backed scan index so adds / deletes / renames appear without a restart. Same `index.db` file as the audio side, separate `videos` table.
+
+## License
+
+See LICENSE in the repo root.

maneki-0.10.0/README.md

@@ -0,0 +1,112 @@
+# Maneki
+
+[![CI](https://github.com/winterop-com/maneki/actions/workflows/ci.yml/badge.svg)](https://github.com/winterop-com/maneki/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/maneki)](https://pypi.org/project/maneki/)
+[![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://winterop-com.github.io/maneki/)
+
+Python 3.13 CLI for a self-hosted media library — audio (convert rips + serve via Subsonic) and video (HLS streaming with on-demand segments, sidecar + embedded subtitles, contact-sheet posters, click-in folder browser). Point `maneki serve` at one directory; it scans recursively, auto-detects what's audio and what's video, and serves both kinds plus the web SPA on one port. The Subsonic mount appears only when audio is present, the video mount only when video is present.
+
+## The name
+
+**Maneki** (招き, *mah-neh-kee*) is the Japanese word for *beckoning*. It's the verb-form of *maneki-neko* (招き猫) — the small ceramic cat with a raised paw you've seen on shop counters and restaurant windows across Japan. The cat sits there quietly all day; when you walk in, its paw is already up, inviting you in. Whoever placed it didn't have to do anything; the cat does the welcoming.
+
+A self-hosted media server has the same job. It lives on a box in the corner. You don't see it, you don't manage it, you don't poke at it. When you open the app on your phone or laptop and want to watch a film or play music, your library should already be there, ready, waving you in. No URL to type, no port to remember, no "is the server up?" — just open and play.
+
+That's what `maneki serve <library>` aims to be: the cat on the shelf.
+
+## Install
+
+The lowest-friction way is [`uvx`](https://docs.astral.sh/uv/) — it downloads, caches, and runs the latest published `maneki` in one step. No install step required:
+
+```bash
+uvx maneki --help
+```
+
+For daily / persistent use (PATH-installed, no per-run network check):
+
+```bash
+uv tool install maneki
+maneki --help
+```
+
+You'll also need `ffmpeg` and `ffprobe` on `$PATH` for the convert pipeline:
+
+```bash
+brew install ffmpeg            # macOS
+sudo apt install ffmpeg        # Debian / Ubuntu
+```
+
+## Quickstart
+
+```bash
+# One process, one URL, both protocols. Point at any directory - maneki
+# scans recursively and only mounts the kinds with content.
+uvx maneki serve ~/Downloads/library                     # audio on /audio/rest/*, video on /video/*
+uvx maneki serve ~/Downloads/library --ui                # also serve the web SPA at /
+
+# Shared across audio + video:
+uvx maneki library info    ~/Downloads/library           # kind counts (audio + video)
+uvx maneki library list    ~/Downloads/library           # full file inventory (or `ls`)
+uvx maneki library inspect ~/Downloads/library/some.mkv  # tags + cover (audio) or ffprobe streams (video)
+
+# Audio tooling:
+uvx maneki audio convert ./input ./output                          # convert rips
+uvx maneki audio library audit ./output                            # audit
+uvx maneki audio playlist gen ./output --seed <track> --minutes 60 # auto-generate a mix
+```
+
+## Screenshots
+
+The browser SPA — bordered panels with floating titles, same palette across audio + video. Vertical AUDIO / VIDEO rail on the left switches modes; the rail self-hides when only one kind is mounted at the library root.
+
+Audio — Artists → Albums → Tracks plus Now Playing top band with the FFT spectrum visualizer:
+
+![Browser UI — audio library, Daft Punk · Homework](docs/screenshots/web-audio.png)
+
+Video — folder browser, instant-paint row thumbnails, sticky breadcrumb. Click into any season for the episode list:
+
+![Browser UI — video folder browse](docs/screenshots/web-video-browse.png)
+
+Video player — video.js v8 on the HLS source, contact-sheet poster (16:9, generated server-side from 9 sample frames + header strip with codec / resolution / duration / size), `t` for theater mode, `f` for browser fullscreen, captions menu auto-prefers English / English-SDH:
+
+![Browser UI — video player with contact-sheet poster](docs/screenshots/web-video-player.png)
+
+More in the [serve guide](https://winterop-com.github.io/maneki/guides/serve-unified/) and the [video guide](https://winterop-com.github.io/maneki/guides/video/).
+
+## Documentation
+
+Full docs are at **[docs/](docs/index.md)** — built with MkDocs Material. Run them locally:
+
+```bash
+make docs-serve     # http://127.0.0.1:8000
+```
+
+Or jump straight to:
+
+- [Architecture](docs/architecture.md) — how all the pieces fit together (process model, data flow, audio subprocess, SQLite index, FFT visualizer)
+- [Quickstart](docs/guides/quickstart.md) — end-to-end walkthrough including iPhone + Tailscale + Amperfy
+- [maneki serve](docs/guides/serve-unified.md) — single-library mode, auto-detect, web SPA
+- [maneki library](docs/guides/library.md) — cross-cutting info / list / inspect against any root
+- [maneki audio convert](docs/guides/convert.md) — codec / bitrate / enrichment matrix
+- [maneki audio library](docs/guides/audio-library.md) — audit rules + auto-fix + SQLite index
+- [maneki video](docs/guides/video.md) — HLS, subtitles, posters, folder browser
+- [maneki audio playlist](docs/guides/playlist.md) — auto-generated `.m3u8` mixes anchored to a seed track
+- [Desktop apps](docs/guides/desktop.md) — Tauri + Electron generic Subsonic clients
+- [Mobile (Subsonic)](docs/guides/mobile.md) — play:Sub / Amperfy / Symfonium / DSub / Tempo
+- [Edge cases](docs/edge-cases.md) — every weirdness encountered on real rips
+- [Roadmap](docs/roadmap.md) — what's next
+- [Development](docs/guides/development.md) — directory layout + test patterns + commit style
+
+## Status
+
+v0.9.0 · audio (Subsonic-compat) + video (HLS, sidecar + embedded subtitles, 16:9 contact-sheet posters, folder browser, watcher hot-reload) share one `maneki serve` and the web SPA at `/`. ruff + mypy + pyright clean, full pytest suite green (648 tests).
+
+**Audio**: OpenSubsonic-compatible (`multipleGenres`, `transcodeOffset`, `songLyrics` extensions), backs heart / star buttons with a persistent `<root>/.maneki/stars.toml`, returns sub-ms FTS5-ranked `/search3` results, promotes LRC lyrics to `synced: true`, tested against Symfonium / Amperfy / play:Sub / Feishin on iOS / Android / desktop. Persistent SQLite library index at `<root>/.maneki/index.db` keeps cold starts under a second; the filesystem watcher does per-album incremental rescans.
+
+**Video**: on-demand HLS with bounded foreground concurrency (rapid seeks don't wedge the player), single-ffmpeg multi-stream subtitle extraction (a 45-track .mkv opens in ~2s instead of stalling on 45 parallel ffmpegs), instant-paint row thumbnails + 16:9 contact-sheet posters with hash-derived cache filenames (deeply-nested rel paths don't blow NAME_MAX), `--no-cover-images` to skip contact sheets entirely on slow disks, `--prewarm-cache` to fill thumbs / posters / subtitles at startup, watcher hot-reload of the SQLite-backed scan index so adds / deletes / renames appear without a restart. Same `index.db` file as the audio side, separate `videos` table.
+
+## License
+
+See LICENSE in the repo root.

maneki-0.10.0/pyproject.toml

@@ -0,0 +1,175 @@
+[project]
+name = "maneki"
+version = "0.10.0"
+description = "Self-hosted media toolkit: audio today (convert / audit / retag rips, Textual TUI, Subsonic-compatible HTTP server), video next (folder-first metadata, HLS streaming)."
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "Morten Hansen", email = "morten@winterop.com" },
+]
+keywords = [
+  "audio",
+  "music",
+  "video",
+  "hls",
+  "media-server",
+  "ffmpeg",
+  "subsonic",
+  "tui",
+  "library-manager",
+  "musicbrainz",
+  "airplay",
+  "tailscale",
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: End Users/Desktop",
+  "Operating System :: MacOS",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Multimedia :: Sound/Audio",
+  "Topic :: Multimedia :: Sound/Audio :: Conversion",
+  "Topic :: Multimedia :: Sound/Audio :: Players",
+  "Topic :: Multimedia :: Video",
+  "Typing :: Typed",
+]
+dependencies = [
+  "typer>=0.24.2",
+  "mutagen>=1.47.0",
+  "rich>=14.0.0",
+  "pillow>=11.0.0",
+  "httpx>=0.28.1",
+  "pydantic>=2.10.0",
+  "pydantic-settings>=2.6.0",
+  "fastapi>=0.136.1",
+  "uvicorn[standard]>=0.46.0",
+  "zeroconf>=0.148.0",
+  "watchdog>=6.0.0",
+  "paho-mqtt>=2.1.0",
+  "jinja2>=3.1.6",
+  "itsdangerous>=2.2.0",
+  "python-multipart>=0.0.27",
+  "structlog>=25.5.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/winterop-com/maneki"
+Repository = "https://github.com/winterop-com/maneki"
+Documentation = "https://winterop-com.github.io/maneki"
+Issues = "https://github.com/winterop-com/maneki/issues"
+Changelog = "https://github.com/winterop-com/maneki/releases"
+
+[project.scripts]
+maneki = "maneki.cli:app"
+
+[dependency-groups]
+dev = [
+  "coverage[toml]>=7.13.5",
+  "mypy>=1.20.2",
+  "pytest>=9.0.3",
+  "pytest-cov>=7.1.0",
+  "pytest-asyncio>=1.3.0",
+  "ruff>=0.15.12",
+  "pyright>=1.1.409",
+  "mkdocs>=1.6.1",
+  "mkdocs-material>=9.7.6",
+  "mkdocstrings[python]>=1.0.4",
+  "mkdocs-claude-theme",
+]
+
+[build-system]
+requires = ["uv_build>=0.9.0,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.uv.sources]
+mkdocs-claude-theme = { git = "https://github.com/mortenoh/mkdocs-claude-theme.git" }
+
+[tool.ruff]
+target-version = "py313"
+line-length = 120
+
+[tool.ruff.lint]
+fixable = ["ALL"]
+select = ["E", "W", "F", "I", "D"]
+ignore = ["D203", "D213"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["D"]
+"**/__init__.py" = ["D104"]
+"src/**/*.py" = ["D102", "D105", "D107"]
+"src/maneki/audio/_ui_static/**" = []
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+docstring-code-format = true
+docstring-code-line-length = "dynamic"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+norecursedirs = [".git", ".venv", "__pycache__", "desktop", "src/maneki/audio/_ui_static"]
+filterwarnings = [
+  "ignore:Pydantic serializer warnings:UserWarning",
+]
+markers = [
+  "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+]
+
+[tool.coverage.run]
+branch = true
+dynamic_context = "test_function"
+relative_files = true
+source = ["maneki"]
+omit = ["*/cli/*"]
+
+[tool.coverage.report]
+exclude_also = ["if TYPE_CHECKING:"]
+precision = 2
+show_missing = true
+skip_covered = true
+
+[tool.mypy]
+python_version = "3.13"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+warn_unused_ignores = true
+strict_equality = true
+mypy_path = ["src"]
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+
+[[tool.mypy.overrides]]
+module = ["mutagen.*"]
+ignore_missing_imports = true
+
+[tool.pyright]
+include = ["src", "tests"]
+exclude = ["src/maneki/audio/_ui_static", "**/.venv"]
+pythonVersion = "3.13"
+typeCheckingMode = "strict"
+useLibraryCodeForTypes = true
+reportPrivateUsage = false
+reportUnusedFunction = false
+reportUnknownMemberType = false
+reportUnknownArgumentType = false
+reportUnknownParameterType = false
+reportUnknownVariableType = false
+reportMissingTypeArgument = false
+reportMissingTypeStubs = false
+reportUnknownLambdaType = false
+reportMissingImports = "warning"
+reportMissingModuleSource = false

maneki-0.10.0/src/maneki/__init__.py

@@ -0,0 +1,15 @@
+"""Self-hosted media toolkit — audio (and video, planned).
+
+The top-level package exposes only the version. Audio capabilities live
+under `maneki.audio.*`; video capabilities will live under
+`maneki.video.*` once they land.
+"""
+
+from __future__ import annotations
+
+try:
+    from importlib.metadata import version as _get_version
+
+    __version__ = _get_version("maneki")
+except Exception:  # pragma: no cover - uninstalled / dev tree
+    __version__ = "unknown"

maneki-0.10.0/src/maneki/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for `python -m maneki`."""
+
+from maneki.cli import app
+
+if __name__ == "__main__":
+    app()

maneki-0.10.0/src/maneki/_ui_static/README.md

@@ -0,0 +1,71 @@
+# Maneki Design v2 (Claude Designer prototype)
+
+The Maneki desktop UI. The source files in `src/` are the raw output
+of Claude Designer — sibling JSX modules that share state via
+`window.MK_*` globals. `index.html` loads them in dependency order via
+Babel-standalone so the prototype runs with no build step (same
+runtime model as the Claude Designer preview).
+
+Wiring to the real Subsonic API lives in the `_`-prefixed files
+(`_api.js`, `_audio.js`, `_md5.js`, `_wiring.jsx`) which survive
+design-zip drops; designer-authored files (`app.jsx`, `chrome.jsx`,
+etc.) get replaced wholesale on each iteration.
+
+## Layout
+
+```
+desktop/react/
+├── index.html          ← entry — boots React UMD + Babel + script tags
+├── main.jsx            ← renders <window.MK_App /> into #root
+├── maneki.css        ← all styles, theme tokens, layout variants
+├── favicon.svg
+└── src/
+    ├── data.jsx           mock library data → window.MK_DATA
+    ├── covers.jsx         procedural album-cover generator
+    ├── visualizer.jsx     Canvas FFT (bars / mirror / radial / ambient)
+    ├── views.jsx          LoginView, StarBtn, ConnectionBanner, ...
+    ├── overlays.jsx       Shortcuts panel, command palette, search dropdown, lyrics overlay
+    ├── tweaks-panel.jsx   Designer-time tweak controls (layout / accent / viz / density / ...)
+    ├── chrome.jsx         TopBar, Sidebar, NowPlaying, MainArea, FullscreenViz, ...
+    └── app.jsx            <App /> — wires state + actions, registers window.MK_App
+```
+
+## Run
+
+```bash
+make desktop-react-tauri-dev          # Tauri wrapper (separate app bundle)
+make desktop-react-electron-dev       # Electron wrapper (separate app bundle)
+
+# Or as a plain webpage:
+cd desktop/react && python3 -m http.server 1900
+open http://127.0.0.1:1900/
+```
+
+The prototype uses mock data (`src/data.jsx`) — no Subsonic server
+required. Wiring to the real `/rest/*` API comes after the design
+direction is locked.
+
+## Why no build step
+
+The Claude Designer artifact uses sibling globals on `window` rather
+than ES module imports. Loading via `<script type="text/babel">` in
+the same order as the design preview means every new iteration can
+be dropped in with `cp -r`. When the design stabilises we can swap
+to Vite + TypeScript without touching the JSX source.
+
+## What's wired
+
+- Real Subsonic auth (`/rest/ping` with salted token)
+- Library load: `getArtists` -> per-artist `getArtist` -> per-album `getAlbum`
+- Track playback via `/rest/stream` driven by an `<audio>` element
+- Star toggle via `/rest/star` / `/rest/unstar`
+- Cover art via `/rest/getCoverArt`
+- Internet radio via `getInternetRadioStations`
+- Session persistence in localStorage; auto-resume on next launch
+
+## Not (yet) wired
+
+- Server-side search (`/rest/search3`) — currently filters the in-memory tree
+- Playlists (`/rest/getPlaylists`)
+- Lyrics fetching (`/rest/getLyrics`)
+- ICY now-playing metadata for radio streams