mediatuna 1.21.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Catalyst Forge LLC
+
+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,65 @@
+<p align="center">
+  <img src="site/static/logo.png" alt="MediaTuna" width="440">
+</p>
+
+# MediaTuna
+
+The old files are hard to play, hard to date, and hard to find. MediaTuna is the local workflow that turns that pile into playable **MP4** and **MP3** without losing the dates, tags, or work you've already done.
+
+A home archive is mixed types, interlaced DV, missing tags, and Windows dates that broke after a copy. One pass. A preflight table. Skip of work that is already done. Deletes only after you confirm.
+
+**Docs:** [mediatuna.dev/docs](https://mediatuna.dev/docs) · **Site:** [mediatuna.dev](https://mediatuna.dev)
+
+Your **local agent** can run this for you — dry-run, sample, convert. It should call `mediatuna`, not invent an ffmpeg command line. [Agents](docs/agents.md).
+
+## Install
+
+[Node.js](https://nodejs.org/) 18+ and **ffmpeg** / **ffprobe** on PATH. [Full install](docs/install.md).
+
+```bash
+pnpm install
+npm link
+mediatuna --version
+```
+
+## Quick start
+
+Keep a backup you can restore. Preview, then write somewhere other than the source folder.
+
+```bash
+mediatuna "./archives/media" --dry-run
+mediatuna "./archives/media" --sample 20 --output "./samples"
+mediatuna "./archives/media" --output "./converted"
+```
+
+More examples: [docs/usage.md](docs/usage.md). Every flag: [docs/options.md](docs/options.md).
+
+## What you get
+
+- One pass over video and audio (or `--video-only` / `--audio-only`)
+- Safe defaults — dry-run, duration verify, Recycle Bin, hash before recup cleanup
+- Dates survive container tags, filenames, and Windows Created/Modified
+- Skip normalized MP3s and existing outputs; `--resume` a long batch
+- AAC copy when the source is already AAC LC (`--reencode-audio` to force 192k)
+- Recovery helpers — Everything dupes, PhotoRec folder rebuild
+
+Stays 100% local. Flags, logging, dates, and recovery live in the [docs](docs/README.md).
+
+## Safety
+
+Hardening is care, not a guarantee. Encoding is lossy; “same file” is usually size or duration. **Keep a backup you can restore from.** Details: [docs/safety.md](docs/safety.md).
+
+`pnpm test` is assurance the safety rules still mean what we think they mean, not a certificate for your files. [specs/testing.md](specs/testing.md).
+
+## Development
+
+```bash
+pnpm test           # unit suite; ffmpeg cases run only if ffmpeg is on PATH
+pnpm test:ffmpeg    # synthetic encode checks
+```
+
+Core logic is in `lib/`; `index.js` is the CLI. Site (FilePress + docs mount): `pnpm site:dev`. [Install / development](docs/install.md).
+
+## Roadmap
+
+Shipped work and open items: [specs/improvements.md](specs/improvements.md), [specs/mediatuna.md](specs/mediatuna.md), [specs/partial/hardening.md](specs/partial/hardening.md), [specs/testing.md](specs/testing.md). Parked: [output formats](specs/output-formats.md), [agents](specs/agents.md).