Scene Subtree Mover moves chapters with their child scenes

Move chapters with their child scenes.

MIT · no telemetry · core features free

The preview places a chapter and its descendants after the other chapters.
Open larger
version
1.2.0
released
downloads
24
review
Passed
health
Excellent
license
MIT
listed for
Desktop, Mobile
obsidian
1.13.4 or later

Desktop app tests do not prove phone or tablet behavior. Live GitHub sign-in and payment were not tested.

Directory facts fetched from community.obsidian.md/users/theluckystrike.

About Scene Subtree Mover

You write with a Longform manuscript index and want to reorder a chapter without leaving its scenes behind.

A chapter name and its following child array belong together in a Longform index. Scene Subtree Mover moves that unit within a sibling group or under another parent. Check the resulting order before applying a change with a full source backup.

A chapter moves with its nested scenes after a preview and a full source backupPlay demo

Free features

Read the manuscript tree

Open a Markdown index with a longform.scenes array. The window shows numbered siblings and indented descendants. Invalid scene-array structure stops the operation without changing the index.

The manuscript tree shows chapters with numbered siblings and nested scenes.
Open larger

Preview one complete move

Choose a chapter or nested scene and its final position among its siblings. The preview keeps its descendants with it and shows the complete proposed order. Reset preview returns to the order read when the window opened.

Move a subtree to another parent

Choose Destination parent to place a chapter or scene under another chapter, or select Manuscript root to promote it. The subtree keeps its descendants, and a single move is free. The destination list excludes the selected scene and its descendants.

The resulting order places Arrival and its descendants under Pursuit.
Open larger

Back up and apply a checked update

Apply creates a complete .md.bak source backup beside the index before writing. Backup failure leaves the index unchanged. The write rejects a source that differs from the preview source when its checked update starts.

The completed update reports the full source backup path in the window.
Open larger

The free version previews one move at a time; several moves in one preview need Pro.

Pro features

Pro costs $5 a month or $15 one time through GitHub Sponsors. One sponsorship turns on Pro in every plugin that has it.

Several moves in one preview Pro

Add successive moves to the proposed tree while the current-order panel stays at the source order. Apply uses one backup and one checked update. Losing Pro before Apply blocks the combined update.

The proposed order combines two chapter moves in one preview.
Open larger

Named orders and checked restore Pro

Save a named order in local plugin data without changing the index. Restore requires matching scenes and parent relationships, though siblings can have a different order. Apply makes a new backup and checks the current source.

A named Alternative ending order appears in the manuscript order controls.
Open larger

Set up Scene Subtree Mover

needs

  • Obsidian 1.13.4 or later
  • A Markdown manuscript index with a nested longform.scenes array.

steps

  1. Open your manuscript index.

  2. Run Move a chapter with its scenes from the command palette.

  3. Select the chapter, destination parent and final position within that group.

  4. Select Preview move and check both order panels.

  5. Select Back up and apply, then keep the reported backup.

If the app can't find a new plugin yet, try again later. Obsidian says a plugin that passes the review shows in the app within 24 hours.

Why this exists

Longform issue 161 asks for a parent move to carry its children. Scene Subtree Mover now previews moves between parent groups with the descendants attached.

Read the request

How to move Longform chapters with their scenes

Known limits of Scene Subtree Mover

  • Moves stay within the selected scene’s sibling group; moves between parent groups and drag controls are outside this version.
  • YAML serialization can change comments, spacing, quotes and aliases in the updated index.
  • The source comparison checks the text when the write starts; later sync writes remain outside that check.
  • Saved orders belong to the index path and do not follow a renamed index.
  • Saved orders restore a sequence, rather than body edits or original YAML comments.
  • The reader rejects more than 10,000 array entries or more than 64 child levels.
  • Physical mobile devices, the Longform interface and multi-device sync were not tested.

Need a change for your team? I build custom Obsidian plugins and features.

Questions about Scene Subtree Mover

Can I move a chapter into a different chapter?

Yes, select the destination chapter in Destination parent, then choose the final position. Manuscript root promotes a nested scene. The selected scene and its descendants cannot be destination parents.

Does the move change scene files?

The operation changes longform.scenes in the index. It does not rename scene notes or move folders.

Does it preserve YAML comments?

The backup preserves the full original source, including comments and body text. The index update keeps unrelated frontmatter data, but YAML serialization can change comments, spacing, quotes and aliases.

Do I need Longform enabled?

Longform need not be enabled to read the index. The file still needs its nested scene-array format, and the Longform interface was not tested.

Network use

Before GitHub sign-in, the plugin sends nothing; sign-in sends a public client ID and read:user to github.com, then polls for authorization. api.github.com receives an authenticated query for your account, sponsorship tier and total payment; no note content, file names or vault data leaves. Successful checks last 7 days; failed checks retry after 6 hours, and Refresh requests an earlier check.

Read the full network disclosure

Questions or ideas?

Tell me what is broken in Scene Subtree Mover, or what it should do next.

Send feedback

Scene Subtree Mover 1.2.0, MIT license

MIT · no telemetry · core features free