movie-narrator-web
Web UI (FastAPI + React) for movie-narrator.
Versioning: This package uses an independent version line, separate from the core engine (
movie-narrator). Compatibility is guaranteed by theCONTRACT_VERSIONcheck at import time — you do not need to match version numbers between the two packages.
This is a separate package from the core engine. Install it only if you need the web interface:
pip install movie-narrator-web
This automatically pulls in movie-narrator (core engine) and all web
dependencies (FastAPI, uvicorn).
Prerequisites
- Python >= 3.10
- ffmpeg (required by the core engine for audio/video processing)
Usage
mn-web --host 127.0.0.1 --port 8760
For development with auto-reload:
mn-web --reload
CLI Options
| Option | Default | Description |
|---|---|---|
--host |
127.0.0.1 |
Bind address |
--port |
8760 |
Port to listen on |
--reload |
off | Enable auto-reload (development mode) |
Or programmatically:
from movie_narrator_web import launch_web_api
launch_web_api(host="127.0.0.1", port=8760)
Development
The frontend source is in webui/ (React + Vite + TypeScript + shadcn/ui).
Build the SPA before packaging:
cd webui
npm ci
npm run build
The build output lands in src/movie_narrator_web/static/ and is served
by FastAPI in production mode.
Internationalization
The Web UI is bilingual (Chinese / English). A language switcher in the header
lets you toggle between the two; the default follows your browser language and
your choice is remembered in localStorage. The selected language is also sent
to the backend as a lang (zh | en) form field and passed downstream to the
pipeline, so narration can be generated in the active language.
Architecture
This package depends on movie-narrator exclusively through the public
contract layer (movie_narrator.contract). No internal module imports.
Documentation
License
Licensed under the AGPL-3.0-or-later License.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file movie_narrator_web-1.0.4.tar.gz.
File metadata
- Download URL: movie_narrator_web-1.0.4.tar.gz
- Upload date:
- Size: 129.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
47772adb37928b5c75082812e68b10ee726dc2aaa72c5a3cc417d8ac95e710ee
|
|
| MD5 |
c433cc432650ea57aea022f559a1cab5
|
|
| BLAKE2b-256 |
ebed6e89d8687ef81427658887909edb0f3630b65e747cf51defabbdc28b2e12
|
Provenance
The following attestation bundles were made for movie_narrator_web-1.0.4.tar.gz:
Publisher:
publish.yml on zcbacxc/movie-narrator-web
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
movie_narrator_web-1.0.4.tar.gz -
Subject digest:
47772adb37928b5c75082812e68b10ee726dc2aaa72c5a3cc417d8ac95e710ee - Sigstore transparency entry: 2339538431
- Sigstore integration time:
-
Permalink:
zcbacxc/movie-narrator-web@097f5feaf2b0115b8225ced56d89d11655946616 -
Branch / Tag:
refs/tags/v1.0.4 - Owner: https://github.com/zcbacxc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@097f5feaf2b0115b8225ced56d89d11655946616 -
Trigger Event:
push
-
Statement type:
File details
Details for the file movie_narrator_web-1.0.4-py3-none-any.whl.
File metadata
- Download URL: movie_narrator_web-1.0.4-py3-none-any.whl
- Upload date:
- Size: 127.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
411a0f62d48dbdd0a127aea9e15a7ca236990200f05b47d4e26e2c4ff9ead98d
|
|
| MD5 |
e912e01294d42ab0bed1ccad31993bfc
|
|
| BLAKE2b-256 |
d3659ba1b117a90d6bf118e0f3f7eb742702383e3a6c96bf6f1ed32df796d4f4
|
Provenance
The following attestation bundles were made for movie_narrator_web-1.0.4-py3-none-any.whl:
Publisher:
publish.yml on zcbacxc/movie-narrator-web
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
movie_narrator_web-1.0.4-py3-none-any.whl -
Subject digest:
411a0f62d48dbdd0a127aea9e15a7ca236990200f05b47d4e26e2c4ff9ead98d - Sigstore transparency entry: 2339538441
- Sigstore integration time:
-
Permalink:
zcbacxc/movie-narrator-web@097f5feaf2b0115b8225ced56d89d11655946616 -
Branch / Tag:
refs/tags/v1.0.4 - Owner: https://github.com/zcbacxc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@097f5feaf2b0115b8225ced56d89d11655946616 -
Trigger Event:
push
-
Statement type:
