rollingpebble 0.6.2__tar.gz

rollingpebble-0.6.2/CHANGELOG.md

@@ -0,0 +1,217 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format loosely follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project uses Semantic Versioning.
+
+## [0.6.2] - 2026-05-20
+
+### Changed
+
+- Added Harmonese author information to the About dialog credits section.
+- Added official website, GitHub, and Bandcamp links for Harmonese.
+- Split author links and project repository links into separate rows in the About dialog.
+
+## [0.6.1] - 2026-05-20
+
+### Added
+
+- Added a GitHub Actions workflow that publishes Python distributions to PyPI when a GitHub Release is published.
+- Added frontend build and package-data preparation steps to the release workflow so wheels include the built WebUI.
+- New `README.md` for users.
+
+### Changed
+
+- Converted this changelog to a Keep a Changelog style structure.
+- Updated the release process documentation for GitHub Releases plus PyPI trusted publishing.
+
+## [0.6.0] - 2026-05-20
+
+### Added
+
+- Initial release to GitHub Releases.
+- Added a unified backend-to-frontend message i18n path and expanded UI translations across settings, runtime, storage, project, upload, and utility flows.
+- Added isolated runtime dependency management and model cache controls for Auto Timing.
+- Added reusable frontend primitives for modal shells, segmented tabs, panel messages, settings rows, Auto Timing fields, and settings refresh handling.
+- Added storage service support for local migration, cleanup previews, app data classification, and runtime/model/project cleanup metadata.
+
+### Changed
+
+- Raised the isolated Auto Timing runtime requirement to `py-roller>=0.6.2,<0.8`.
+- Reworked Settings with a dedicated Storage & Cleanup area, storage usage summaries, local storage location migration controls, project auto-delete settings, and safer cleanup actions.
+- Improved project deletion stability, undo/restore behavior, and recent-project ordering interactions.
+- Polished Synchronizer & Editor, Storage & Cleanup, Auto Timing, LRC Utilities, About, and Settings UI consistency.
+- Improved toast/message lifetimes so operation-scoped messages clear when the related task completes instead of relying on fixed timeouts.
+- Improved dialog and panel animations, including About, Settings, LRC Utilities, project cards, panel messages, and main UI transitions.
+- Improved browser-tab/background audio handling and audio decode error reporting.
+
+### Fixed
+
+- Fixed the Theme Color picker focus/revert behavior.
+
+## [0.5.5]
+
+### Changed
+
+- Reworked the Synchronizer/Editor workspace artwork as a non-interactive background layer instead of a large image card.
+- Removed the rounded green-bordered workspace avatar image from the empty Synchronizer state.
+- Added a borderless workspace background asset and responsive positioning for shorter or narrower screens.
+
+## [0.5.4]
+
+### Changed
+
+- Polished Auto Timing settings terminology and kept matching controls aligned between Settings and the main Auto Timing panel.
+- Reduced processing presets to the currently supported Quick and Full flows.
+- Moved model download options into their own Advanced Parameters section and removed one-click network preset buttons from the UI.
+- Changed the default Auto Timing BY tag to `LRC Roller`.
+- Refined the startup avatar presentation to remove the framed rounded-rectangle treatment and scale more safely on shorter displays.
+
+## [0.5.3]
+
+### Changed
+
+- Refined isolated py-roller runtime upgrade and diagnostics behavior.
+- Changed runtime creation/repair to upgrade `py-roller>=0.5.6,<0.6` when using the PyPI runtime source.
+- Centralized the py-roller runtime version requirement to avoid drift between status and installer code.
+- Updated `rollingpebble doctor --run-pyroller-doctor` to run doctor inside the isolated runtime instead of PATH.
+- Persisted failed runtime install/check results so Settings can show the latest failure after refresh.
+- Kept pip raw output in logs while preventing `install_subprocess_output` events from crowding out structured install steps.
+- Added a simple guard to avoid repairing the runtime while Auto Timing is running, and to avoid starting Auto Timing during runtime repair.
+- Removed redundant runtime action notices; the runtime terminal now provides the task state.
+
+## [0.5.2]
+
+### Added
+
+- Added structured runtime step rendering in Settings.
+- Added doctor/install JSON reports in runtime diagnostics.
+
+### Changed
+
+- Integrated py-roller 0.5.6 runtime install JSONL progress and JSON doctor reports.
+- Changed isolated runtime creation to call `py-roller install --progress-format jsonl --output-format json`.
+- Changed Runtime Check to call `py-roller doctor --output-format json`.
+- Moved runtime notices next to the runtime terminal.
+- Folded raw runtime logs behind a details panel.
+- Raised the isolated runtime package requirement to `py-roller>=0.5.6,<0.6`.
+
+## [0.5.1]
+
+### Fixed
+
+- Fixed isolated runtime installation failing before the installer starts when the runtime directory does not exist yet.
+- Improved subprocess job error logging when a command cannot be started.
+
+## [0.5.0] - 2026-05-13
+
+### Added
+
+- Added runtime liveness metadata to jobs, including PID, elapsed time, last output time, and return code.
+- Added runtime task cancellation using process groups on POSIX systems.
+
+### Changed
+
+- Moved Auto Timing to an isolated py-roller runtime virtual environment under the rollingpebble data directory.
+- Changed Runtime install/repair to create or repair that isolated runtime instead of modifying the rollingpebble backend `.venv`.
+- Changed Auto Timing command generation to call the runtime Python with `-m pyroller.cli.main`, avoiding PATH-based py-roller resolution.
+
+## [0.4.3] - 2026-05-12
+
+### Changed
+
+- Reworked the Synchronizer & Editor metadata option so it controls whether metadata tags are written into the LRC text, while keeping the metadata editor visible.
+- Preserved metadata values when editing lyric text with metadata tags hidden from the text area.
+
+### Fixed
+
+- Fixed a React hook-order crash when changing the editor metadata setting.
+
+## [0.4.2] - 2026-05-12
+
+### Added
+
+- Introduced an editor metadata setting, later corrected in 0.4.3 to control metadata tag writing.
+
+### Changed
+
+- Simplified Lyrics Import settings by removing automatic imported-LRC cleanup from the UI; imported lyrics now remain unchanged by default.
+- Cleaned up Auto Timing settings copy and runtime controls; runtime logs now appear directly under the runtime action buttons.
+
+### Fixed
+
+- Fixed the Recent projects limit setting so it persists and updates the project list as expected.
+
+## [0.4.1] - 2026-05-12
+
+### Added
+
+- Added an About dialog with project purpose, current version, credits, core hotkeys, and rights note.
+- Added a dedicated About button in the header.
+
+### Changed
+
+- Reorganized Settings into General, Project, Lyrics Import, Synchronizer & Editor, Auto Timing, and Upload sections.
+- Moved About out of Settings.
+- Removed the Settings subtitle line and kept only implemented settings in each section.
+
+## [0.4.0] - 2026-05-12
+
+### Added
+
+- Added avatar-based startup branding, browser title, manifest metadata, themed LRC circle favicon assets, and splash animation to match LRC Roller.
+
+### Changed
+
+- Polished the local UI ahead of the v0.4.0 milestone.
+- Refined Recent Projects controls with a slimmer remove button and removed the explanatory limit line.
+- Simplified Local Files import wording in Lyrics Import.
+- Moved the manual LRC cleanup action into Settings and kept the Editor focused on lyrics editing.
+- Unified Settings form controls, checkbox styling, fonts, focus states, and button hover states.
+- Removed the temporary splash preview page after review.
+- Changed Auto Timing task settings in Settings to save automatically instead of requiring a manual save button.
+- Tightened Recent Projects row layout and improved model folder browse button styling.
+- Replaced active legacy Akari image assets with LRC Roller avatar-based placeholders while keeping parser/local-storage compatibility where needed.
+
+## [0.3.15] - 2026-05-12
+
+### Changed
+
+- Updated Auto Timing progress parsing for py-roller 0.5.4 structured events.
+- Prefer canonical `progress` values while keeping compatibility with earlier `percent` events.
+- Normalize progress stages such as `preflight` and `model_download` so the stage checklist remains stable across py-roller progress protocol updates.
+
+## [0.3.12] - 2026-05-12
+
+### Added
+
+- Added restricted-network Hugging Face download presets that keep SOCKS proxies and prefer `socks5h://` for remote DNS.
+
+### Changed
+
+- Updated model download proxy placeholders and preview warnings to catch `socks5://` misconfiguration.
+- Clarified that CLI-like download defaults are for direct/public network access only.
+
+## [0.3.11] - 2026-05-12
+
+### Changed
+
+- Kept Auto Timing task controls and Settings defaults in parity, including Apple Silicon/MPS visibility for Torch-based transcriber backends.
+- Changed default HF model download mode to XET off for new settings.
+- Reworked model download presets to match a known-good py-roller CLI style: XET off, no proxy, and py-roller default timeouts/workers.
+- Added command-preview warnings for proxy, XET auto, and single-worker HF downloads.
+
+## [0.3.10] - 2026-05-12
+
+### Added
+
+- Added Direct, Split, Realign, and Rewrite processing presets in the Auto Timing UI.
+
+### Changed
+
+- Required `py-roller>=0.5.2` for the Hugging Face timeout environment fix.
+- Normalized Hugging Face timeout and worker options as positive integers before building `py-roller` commands.
+- Built `py-roller` commands from the selected stage range, only passing inputs and options that are valid for those stages.
+- Persisted reusable py-roller artifacts in each project under `artifacts/` so realign and rewrite-only flows can reuse prior work.
+- Removed MPS from faster-whisper device choices because ctranslate2 does not accept PyTorch MPS device names.
+- Rendered Command Preview as a scrollable terminal-style block that does not stretch the side panel.

rollingpebble-0.6.2/MANIFEST.in

@@ -0,0 +1,3 @@
+include CHANGELOG.md
+include README.md
+recursive-include backend/lrc_roller/frontend_dist *

rollingpebble-0.6.2/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: rollingpebble
+Version: 0.6.2
+Summary: Local WebUI frontend for py-roller and pylrclib.
+Author: Harmonese
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn[standard]>=0.27
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: pylrclib-cli>=0.4.6
+Provides-Extra: roller
+Provides-Extra: full
+Provides-Extra: dev
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+
+# Rolling Pebble
+
+[![PyPI](https://img.shields.io/pypi/v/rollingpebble.svg)](https://pypi.org/project/rollingpebble/)
+[![Python](https://img.shields.io/pypi/pyversions/rollingpebble.svg)](https://pypi.org/project/rollingpebble/)
+
+Rolling Pebble is a local lyrics workstation for searching, editing, timing, organizing, and publishing LRC lyrics.
+
+It gives you a browser-based interface backed by a local Python server. Your projects, audio, lyrics, runtime environments, and model caches stay on your machine. Auto Timing is powered by `py-roller` in an isolated runtime so large audio dependencies do not pollute the main app environment.
+
+## What It Does
+
+- **Import** audio and lyrics from local files, LRCLIB, and supported online sources.
+- **Edit** metadata and lyric text in a focused LRC editor.
+- **Synchronize** timestamps manually when you want frame-level control.
+- **Auto-time** lyrics with `py-roller` using isolated CPU/CUDA runtime profiles.
+- **Review and clean up** projects, model caches, runtime environments, and app data.
+- **Publish** prepared lyrics through LRCLIB workflows.
+- **Use multiple languages** through the built-in i18n layer.
+
+## Typical Workflow
+
+1. Create or import a project with an audio file.
+2. Import lyrics from LRCLIB, a local file, or the editor.
+3. Clean up the lyric text and metadata.
+4. Use the Synchronizer for manual timing, or Auto Timing for py-roller based alignment.
+5. Review the generated LRC, export it, or publish it through LRCLIB.
+
+## Install
+
+Rolling Pebble requires Python 3.10 or newer. Auto Timing additionally needs a Python 3.12 executable available on your system because the isolated `py-roller` runtime is built on Python 3.12.
+
+Recommended install:
+
+```bash
+python -m venv rollingpebble-env
+. rollingpebble-env/bin/activate
+python -m pip install -U pip
+python -m pip install rollingpebble
+rollingpebble
+```
+
+On Windows PowerShell:
+
+```powershell
+py -m venv rollingpebble-env
+.\rollingpebble-env\Scripts\Activate.ps1
+python -m pip install -U pip
+python -m pip install rollingpebble
+rollingpebble
+```
+
+Then open:
+
+```text
+http://127.0.0.1:6789
+```
+
+## First Run
+
+Start Rolling Pebble:
+
+```bash
+rollingpebble
+```
+
+Then open:
+
+```text
+http://127.0.0.1:6789
+```
+
+The default server binds to `127.0.0.1`, so it is intended for local use.
+
+## Auto Timing
+
+Auto Timing uses `py-roller` for lyric alignment. Rolling Pebble does not install Torch, Demucs, faster-whisper, or other heavy audio dependencies into the main app environment. Instead, it creates a separate runtime under the app data directory.
+
+To set it up:
+
+1. Open **Settings -> Auto Timing -> Runtime**.
+2. Choose a runtime profile.
+3. Click **Create Runtime**.
+4. Run **Runtime Check** after creation completes.
+
+If Python 3.12 is not detected automatically, set:
+
+```bash
+export LRC_ROLLER_RUNTIME_PYTHON=/path/to/python3.12
+```
+
+The current supported py-roller range is:
+
+```text
+py-roller>=0.6.2,<0.8
+```
+
+## Storage and Privacy
+
+Rolling Pebble is local-first. It stores data under the user data directory, for example:
+
+```text
+~/.local/share/rollingpebble
+```
+
+Inside the app, **Settings -> Storage & Cleanup** shows project data, model caches, runtime environments, and other app data. Model caches are stored separately from runtime environments so they can be reused across runtime repairs.
+
+Rolling Pebble only contacts external services when you use features that need them, such as LRCLIB lookup/publishing, supported online source import, or model downloads for Auto Timing.
+
+## Developer Notes
+
+For source development:
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install -U pip setuptools wheel
+python -m pip install -e .
+pnpm install
+```
+
+Run the backend and frontend together:
+
+```bash
+. .venv/bin/activate
+rollingpebble dev
+```
+
+Or use two terminals:
+
+```bash
+# terminal 1
+. .venv/bin/activate
+rollingpebble serve --reload
+
+# terminal 2
+pnpm dev
+```
+
+Release packaging details live in [RELEASE.md](./RELEASE.md).

rollingpebble-0.6.2/README.md

@@ -0,0 +1,139 @@
+# Rolling Pebble
+
+[![PyPI](https://img.shields.io/pypi/v/rollingpebble.svg)](https://pypi.org/project/rollingpebble/)
+[![Python](https://img.shields.io/pypi/pyversions/rollingpebble.svg)](https://pypi.org/project/rollingpebble/)
+
+Rolling Pebble is a local lyrics workstation for searching, editing, timing, organizing, and publishing LRC lyrics.
+
+It gives you a browser-based interface backed by a local Python server. Your projects, audio, lyrics, runtime environments, and model caches stay on your machine. Auto Timing is powered by `py-roller` in an isolated runtime so large audio dependencies do not pollute the main app environment.
+
+## What It Does
+
+- **Import** audio and lyrics from local files, LRCLIB, and supported online sources.
+- **Edit** metadata and lyric text in a focused LRC editor.
+- **Synchronize** timestamps manually when you want frame-level control.
+- **Auto-time** lyrics with `py-roller` using isolated CPU/CUDA runtime profiles.
+- **Review and clean up** projects, model caches, runtime environments, and app data.
+- **Publish** prepared lyrics through LRCLIB workflows.
+- **Use multiple languages** through the built-in i18n layer.
+
+## Typical Workflow
+
+1. Create or import a project with an audio file.
+2. Import lyrics from LRCLIB, a local file, or the editor.
+3. Clean up the lyric text and metadata.
+4. Use the Synchronizer for manual timing, or Auto Timing for py-roller based alignment.
+5. Review the generated LRC, export it, or publish it through LRCLIB.
+
+## Install
+
+Rolling Pebble requires Python 3.10 or newer. Auto Timing additionally needs a Python 3.12 executable available on your system because the isolated `py-roller` runtime is built on Python 3.12.
+
+Recommended install:
+
+```bash
+python -m venv rollingpebble-env
+. rollingpebble-env/bin/activate
+python -m pip install -U pip
+python -m pip install rollingpebble
+rollingpebble
+```
+
+On Windows PowerShell:
+
+```powershell
+py -m venv rollingpebble-env
+.\rollingpebble-env\Scripts\Activate.ps1
+python -m pip install -U pip
+python -m pip install rollingpebble
+rollingpebble
+```
+
+Then open:
+
+```text
+http://127.0.0.1:6789
+```
+
+## First Run
+
+Start Rolling Pebble:
+
+```bash
+rollingpebble
+```
+
+Then open:
+
+```text
+http://127.0.0.1:6789
+```
+
+The default server binds to `127.0.0.1`, so it is intended for local use.
+
+## Auto Timing
+
+Auto Timing uses `py-roller` for lyric alignment. Rolling Pebble does not install Torch, Demucs, faster-whisper, or other heavy audio dependencies into the main app environment. Instead, it creates a separate runtime under the app data directory.
+
+To set it up:
+
+1. Open **Settings -> Auto Timing -> Runtime**.
+2. Choose a runtime profile.
+3. Click **Create Runtime**.
+4. Run **Runtime Check** after creation completes.
+
+If Python 3.12 is not detected automatically, set:
+
+```bash
+export LRC_ROLLER_RUNTIME_PYTHON=/path/to/python3.12
+```
+
+The current supported py-roller range is:
+
+```text
+py-roller>=0.6.2,<0.8
+```
+
+## Storage and Privacy
+
+Rolling Pebble is local-first. It stores data under the user data directory, for example:
+
+```text
+~/.local/share/rollingpebble
+```
+
+Inside the app, **Settings -> Storage & Cleanup** shows project data, model caches, runtime environments, and other app data. Model caches are stored separately from runtime environments so they can be reused across runtime repairs.
+
+Rolling Pebble only contacts external services when you use features that need them, such as LRCLIB lookup/publishing, supported online source import, or model downloads for Auto Timing.
+
+## Developer Notes
+
+For source development:
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install -U pip setuptools wheel
+python -m pip install -e .
+pnpm install
+```
+
+Run the backend and frontend together:
+
+```bash
+. .venv/bin/activate
+rollingpebble dev
+```
+
+Or use two terminals:
+
+```bash
+# terminal 1
+. .venv/bin/activate
+rollingpebble serve --reload
+
+# terminal 2
+pnpm dev
+```
+
+Release packaging details live in [RELEASE.md](./RELEASE.md).

rollingpebble-0.6.2/backend/rollingpebble/__init__.py

@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+from rollingpebble.version import __version__, app_version
+
+__all__ = ["__version__", "app_version"]