dsf

readme.md

@@ -2,14 +2,17 @@
 
 Medios-Macina is a CLI media manager and toolkit focused on downloading, tagging, and media storage (audio, video, images, and text) from a variety of providers and sources. It is designed around a compact, pipeable command language ("cmdlets") so complex workflows can be composed simply and repeatably.
 
-## Highlights ✅
-- Flexible pipeline-based CLI: chain cmdlets with `|` and use saved selections with `@N`.
-- Multi-store support: HydrusNetwork, local folders, and provider-backed stores.
-- Provider integrations: YouTube, OpenLibrary/Archive.org, Soulseek, LibGen, AllDebrid, and more.
-- Utility cmdlets: screenshots (Playwright), metadata extraction, merging, and automated tagging.
-- MPV-friendly: integrate with MPV playback and playlists for quick ingestion.
+## Features
+- **Flexible syntax structure:** chain commands with `|` and select options from tables with `@N`.
+- **Multiple file stores:** *HYDRUSNETWORK, FOLDER*
+- **Provider plugin integration:** *YOUTUBE, OPENLIBRARY/ARCHIVE.ORG, SOULSEEK, LIBGEN, ALLDEBRID, TELEGRAM, BANDCAMP*
+- **Module Mixing:** *[Playwright](https://github.com/microsoft/playwright), [yt-dlp](https://github.com/yt-dlp/yt-dlp), [aioslsk](https://github.com/JurgenR/aioslsk), [telethon](https://github.com/LonamiWebs/Telethon),[typer](https://github.com/fastapi/typer)*
+- **MPV Manager:** Play audio, video, and even images in a custom designed MPV with trimming, screenshotting, and more built right in! 
 
 ## Quick start ⚡
+
+Prefer an automated setup? See `docs/BOOTSTRAP.md` and use `scripts/bootstrap.ps1` (Windows) or `scripts/bootstrap.sh` (Linux/macOS) to create a venv and install the project. Alternatively, run the opinionated helper: `python ./scripts/setup.py` which creates a `.venv` at the repo root, installs dependencies into it, writes convenient `mm` launchers in the project root, and installs a global `mm` shim into your user PATH so you can run `mm` from anywhere.
+
 1. Install Python requirements:
 
 ```powershell
@@ -55,9 +58,21 @@ python cli.py
 
 ## Usage overview 🔧
 - Pipelines: chain cmdlets with `|`, e.g., `download-media <url> | add-file -storage local`.
+  - From your shell you can pass a fully-quoted pipeline so the shell doesn't interpret `|` as a pipe: e.g.
+    `mm "download-media <url> | add-file -storage local"`
+  - Format selection (non-interactive): When `download-media` shows multiple formats, you can select one non-interactively by re-running the pipeline and specifying the format:
+    - Use a format id: `mm "download-media '<url>' -format 243 | add-file -store local"`
+    - Or use the listed index (1-based): `mm "download-media '<url>' -query 'format:7' | add-file -store local"`
+    Note: The `@N` selection syntax works in the interactive REPL, but shells like PowerShell treat `@` specially — prefer `-query 'format:N'` when running a quoted pipeline from your shell.
 - Selections: search cmdlets populate a selectable ResultTable; refer to entries with `@<index>`.
 - Tagging & metadata: `add-tag` mutates piped results (temporary path items) or writes to a configured store when `-store` is provided.
 
+## Built-in image viewer 🎞️
+- MPV automatically detects still-image files and flips into an image viewer mode while leaving the IPC helper aware via `user-data/mpv/image`.
+- Arrow keys, `WASD`, or `h/j/k/l` pan the image (recently tuned to ±0.05 steps), `Shift+arrow` offers finer nudges, `=`/`-` zoom quickly (~45% per press), `+`/`_` zoom slowly, and `0` resets zoom/pan back to default.
+- Hit `f` while an image is active to take a screenshot (uses MPV's screenshot pipeline) and get an OSD confirmation.
+- When MPV loads a video again, the script restores the regular video shortcuts automatically.
+
 ## Common examples 💡
 
 Simple download with metadata (tags and URL registration):
@@ -99,10 +114,12 @@ download-media [URL] | add-file -store hydrus
 - For Playwright screenshots, run `python ./scripts/setup.py` (installs Chromium by default to save download space). To install all engines, run `python ./scripts/setup.py --browsers all`.
 - Note: the `screen-shot` cmdlet forces the Playwright **Chromium** engine and will not use Firefox or WebKit.
 - To run tests locally after removing `tests/conftest.py`, install the project in editable mode first so tests can import the package: `python -m pip install -e .` or run `python ./scripts/setup.py --install-editable`.
-- Deno: this setup script now **installs Deno by default**. To opt out, run `python ./scripts/setup.py --no-deno`. You can still pin a version: `python ./scripts/setup.py --deno-version v1.34.3`.
+- Deno: The bootstrap scripts will install Deno automatically if it's not already installed (using the official installers). If the installer completes but `deno` is not available in your shell, restart your shell or add `$HOME/.deno/bin` (Windows: `%USERPROFILE%\\.deno\\bin`) to your PATH.
+
+  After installation, restart your shell (or add Deno's bin directory to your PATH) so `deno` is available on the command line.
 - Use `--debug` to enable verbose logs when tracking down an error.
 
-## Contributing & docs ✨
+## Contributing & docs
 - Developer docs are generated under `docs/` and tests live alongside the code; please run the test suite before submitting changes.
 - Contributions welcome—open issues or pull requests with clear descriptions and small, focused diffs.