[arteeh]

What does this change?

Adds a README-linked Hidamari setup guide explaining how to copy the shipped Bluefin movie into the user's XDG Videos/Hidamari folder and select it in Local Video. The command respects localized paths and asks before replacing an existing file. Updates the maintainer skill with the same sandbox constraint.

Why?

PR #1207 shipped the movie but deliberately left #1158 open because Hidamari cannot discover the system copy. Its review explicitly offered documented copy instructions as a resolution. This supplies that manual setup path, including troubleshooting and removal instructions.

Closes #1158.

Validation

• just check passed.
• pre-commit run --all-files passed, including the new guide.
• Executed the documented copy snippet with the repository movie as its source and a temporary localized Videos path containing spaces; verified byte-for-byte copying and that declining replacement preserves existing contents.
• Checked the Flathub manifest's xdg-videos/Hidamari:create permission.
• Hidamari GUI playback was not tested in this environment. This is documentation only; no automatic first-run behavior is added.

Checklist

• Conventional Commits title
• Local lint and pre-commit checks pass
• Relevant skill updated and internal links validated
• CI results pending after PR creation

— hive: backend=codex model=gpt-6-astra effort=medium

---

🐝 Hive Agent: contributor | SHA: 6364878

[hivecommons-hive]

correctness

• (low) docs/hidamari.md:13-14 — xdg-user-dir VIDEOS never prints an empty string: when XDG_VIDEOS_DIR is unconfigured it falls back to $HOME, so the test -n guard cannot trigger and the snippet silently creates ~/Hidamari. The Flatpak's --filesystem=xdg-videos/Hidamari:create does not map to $HOME in that case, so the copy lands where Hidamari cannot see it. Consider guarding test "$videos_dir" != "$HOME" (or telling the user to run xdg-user-dirs-update first). Rare on Bluefin GNOME logins, so non-blocking.

docs-currency

• (low) docs/skills/hidamari-wallpaper.md:4 — front matter still says last_updated: "2026-09-24" though this PR adds a new section (lines 33-42). Bump it so the skill index reflects the change.

No findings from: security, intent-alignment, style.

Confidence: 5/5 (safe)

— hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

[Danathar]

Reviewed at 6364878. This adds a short guide for using the movie Bluefin ships with Hidamari, plus a README link and a maintainer note. The movie exists at the path the guide copies from (system_files/bluefin/usr/share/backgrounds/bluefin/bluefin-hidamari.webm), and the Flathub manifest grants xdg-videos/Hidamari, so copying instead of symlinking is right. The doc link, skill front matter and skill index checks pass locally, and CI is green.

Two small suggestions, not blocking:

• xdg-user-dir VIDEOS prints $HOME when no Videos folder is configured, not an empty string, so the test -n guard never fires and the copy would land in ~/Hidamari, which the Flatpak can't see. Checking != "$HOME" would catch that.
• last_updated in docs/skills/hidamari-wallpaper.md still says 2026-09-24.

Not tried: the steps in a live Hidamari install.

[castrojo]

LGTM, docs update