diff --git a/README.md b/README.md index 27c9ac5..da79453 100644 --- a/README.md +++ b/README.md @@ -18,18 +18,20 @@ ScriptCut is different from a cloud-first editor because local processing is the See [the Product Vision](docs/PRODUCT_VISION.md) for the canonical product direction. -ScriptCut screenshot +![ScriptCut export workspace with edited preview, transcript, timeline, export preflight, output presets, and caption delivery](docs/assets/scriptcut-alpha4-export.png) ## Start Here The intended creator path is the **ScriptCut desktop app**: -1. Open the [ScriptCut GitHub Releases page](https://github.com/FernandoAbishai/ScriptCut/releases). -2. Choose a release explicitly identified in its notes and manifest as a self-contained macOS arm64 prerelease, then download its tagged DMG. +1. [Download ScriptCut v0.1.0-alpha.4 for macOS Apple Silicon](https://github.com/FernandoAbishai/ScriptCut/releases/download/v0.1.0-alpha.4/ScriptCut-v0.1.0-alpha.4-arm64.dmg). +2. Open the DMG and install ScriptCut. 3. If macOS blocks the first launch, use **System Settings → Privacy & Security → Open Anyway**, then confirm the prompt. -4. Choose **Edit full video** or **Create a short**, then select local media. +4. Choose **Edit a Video** or **Create Clips**, then select local media. 5. Review the transcript and export when the preflight panel is ready. +For release notes, checksums, the manifest, and attestations, see the [v0.1.0-alpha.4 release page](https://github.com/FernandoAbishai/ScriptCut/releases/tag/v0.1.0-alpha.4). + For a short, non-technical walkthrough, read the [First Export Guide](docs/FIRST_EXPORT.md). If a release asset is not available, ScriptCut can be run from source using the contributor setup below. The complete release process is documented in [docs/RELEASE.md](docs/RELEASE.md). diff --git a/docs/FIRST_EXPORT.md b/docs/FIRST_EXPORT.md index df57d86..c8d0cc2 100644 --- a/docs/FIRST_EXPORT.md +++ b/docs/FIRST_EXPORT.md @@ -1,38 +1,39 @@ -# Your First ScriptCut Export +# Your First ScriptCut Export with v0.1.0-alpha.4 -This guide is for a creator using a self-contained ScriptCut desktop alpha explicitly identified in its release notes, not for contributors building from source. +This guide matches the verified v0.1.0-alpha.4 ScriptCut desktop alpha. It is for creators using the packaged app, not contributors building from source. ## Before You Start - Use a macOS Apple Silicon Mac (M1 or newer). -- Download a self-contained macOS arm64 DMG from the official [ScriptCut Releases feed](https://github.com/FernandoAbishai/ScriptCut/releases), as identified by that release's notes and manifest, then open ScriptCut and select a video. +- [Download ScriptCut-v0.1.0-alpha.4-arm64.dmg](https://github.com/FernandoAbishai/ScriptCut/releases/download/v0.1.0-alpha.4/ScriptCut-v0.1.0-alpha.4-arm64.dmg), then open the DMG and install ScriptCut. +- For release notes, checksums, the manifest, and attestations, see the [v0.1.0-alpha.4 release page](https://github.com/FernandoAbishai/ScriptCut/releases/tag/v0.1.0-alpha.4). - If macOS blocks the first launch, use **System Settings → Privacy & Security → Open Anyway** for the official download. -A qualifying public alpha bundles portable Python, the pinned core runtime, FFmpeg, and FFprobe for the supported baseline path. On the first transcription, ScriptCut downloads and verifies the baseline model with progress, then stores it in app-managed local storage for later offline reuse. No system Python or separate FFmpeg installation is required for that packaged app. Older alpha releases may predate this self-contained path. +A qualifying public alpha bundles portable Python, the pinned core runtime, FFmpeg, and FFprobe for the supported baseline path. On the first transcription, ScriptCut downloads and verifies the baseline model with progress, then stores it in app-managed local storage for later offline reuse. No system Python or separate FFmpeg installation is required for this packaged release. Older alpha releases may predate this self-contained path. -## Edit A Full Video +## Edit a Video -1. Click **Edit full video**. +1. Click **Edit a Video**. 2. Choose a local video or audio file. -3. Wait for the transcript to finish. +3. Wait for transcription and any required model preparation to finish. 4. Select unwanted words and press Delete. 5. Press Space to preview the edited playback. 6. Open **Export**. 7. Check the compact export preflight. It should show a source, destination, renderer, and caption delivery method. 8. Click **Export**, then use **Reveal in Finder** when it completes. -## Create A Short +## Create Clips -1. Click **Create a short**. -2. Choose a local video file and wait for the transcript. -3. Open **AI**, then **Clips**. -4. Create or draft the moment you want to review. -5. Trim the in/out times, preview it, approve it, and package its title and caption. +1. Click **Create Clips**. +2. Choose a local video file and wait for transcription and any required model preparation to finish. ScriptCut opens the Create Clips workspace after transcription. +3. Find moments with AI, or select transcript words and choose **Draft clip** yourself. An AI provider is optional for manual drafting. +4. Review the draft, trim it, and set its frame and captions. +5. Approve the prepared clip. 6. Export the approved draft. Batch export only runs approved drafts, so one failed clip does not stop the rest. ## Captions -ScriptCut checks caption support before export. When burn-in captions are available, they are rendered directly into the video. When this alpha's FFmpeg build cannot render them, ScriptCut exports the video plus a matching `.srt` caption file. The export panel tells you which result you will get before you start. +ScriptCut checks caption support before export. When burn-in captions are available, they are rendered directly into the video. When the packaged FFmpeg build cannot render them, ScriptCut exports the video plus a matching `.srt` caption file. The export preflight tells you which result you will get before you start, including **Video + .srt sidecar** when that fallback applies. ## When Export Is Blocked diff --git a/docs/INSTALL.md b/docs/INSTALL.md index 7870754..30482ac 100644 --- a/docs/INSTALL.md +++ b/docs/INSTALL.md @@ -4,16 +4,17 @@ ScriptCut is a local-first Electron app with a React frontend and FastAPI backen ## Recommended Alpha Install -For non-technical use, install the desktop app from the official [GitHub Releases feed](https://github.com/FernandoAbishai/ScriptCut/releases): +For non-technical use, install the already-qualified v0.1.0-alpha.4 desktop app: -1. Open the official ScriptCut Releases feed and choose a prerelease explicitly identified as self-contained for macOS Apple Silicon. -2. Download that tagged **macOS Apple Silicon (arm64)** `.dmg`. -3. Open the DMG, open ScriptCut, and select a video when the app is ready. -4. If macOS blocks the first launch, use **System Settings → Privacy & Security → Open Anyway** after confirming that the DMG came from the official ScriptCut Releases feed. +1. [Download `ScriptCut-v0.1.0-alpha.4-arm64.dmg`](https://github.com/FernandoAbishai/ScriptCut/releases/download/v0.1.0-alpha.4/ScriptCut-v0.1.0-alpha.4-arm64.dmg) for macOS Apple Silicon. +2. Open the DMG, install ScriptCut, and select a workflow when the app is ready. +3. If macOS blocks the first launch, use **System Settings → Privacy & Security → Open Anyway** after confirming that the DMG came from the official ScriptCut Releases feed. + +See the [v0.1.0-alpha.4 release page](https://github.com/FernandoAbishai/ScriptCut/releases/tag/v0.1.0-alpha.4) for release notes, checksums, the manifest, and attestations. The supported self-contained public-alpha path bundles portable Python, the pinned core runtime, FFmpeg, and FFprobe. ScriptCut manages the baseline transcription model on first use; creators do not install system Python, pip, FFmpeg, or a virtual environment for a qualifying packaged release. The app uses an ad-hoc code signature for package integrity, but is not signed with Apple Developer ID or notarized, so the macOS approval step above may be required. Older alpha releases may predate this runtime; check the individual release notes and manifest. -Read [Platform Support](./PLATFORM_SUPPORT.md) before downloading. If no qualifying self-contained release is attached yet, use the source setup below. +Read [Platform Support](./PLATFORM_SUPPORT.md) for the current support matrix. For source development, use the setup below. ## Source Development Requirements diff --git a/docs/assets/scriptcut-alpha4-export.png b/docs/assets/scriptcut-alpha4-export.png new file mode 100644 index 0000000..3d05b66 Binary files /dev/null and b/docs/assets/scriptcut-alpha4-export.png differ