Skip to main content

Import Manuals and Documents into LaunchBox

šŸ“‹ Summary

Add an option to copy locally added manuals and documents into LaunchBox’s managed folders instead of only linking to their original locations.


ā— Problem

When users select or automatically discover a local manual or document, LaunchBox may continue referencing the file from its original location.

If that file is moved, renamed, or deleted, the document becomes unavailable in LaunchBox. This also makes portable installations and library transfers less reliable.


šŸ’” Proposal

When adding a manual or document, allow users to choose between:

  • Copy the file into LaunchBox

  • Keep the file in its current location

Files copied into LaunchBox should be organized into appropriate platform folders and referenced using portable paths.

The option should apply to files found during game imports as well as files added through game or platform editing.


🧩 Use Cases

  • Keep manuals available after cleaning up the original ROM folder

  • Move a LaunchBox installation without losing linked documents

  • Maintain one organized location for game-related media

  • Prevent links from breaking when source folders change


šŸ“¦ Benefits

  • Improves library portability

  • Reduces broken manual and document links

  • Provides more consistent media management

  • Makes backups and migrations more reliable


āš ļø Considerations

  • Copying should not delete or move the original file

  • Users should be able to retain externally managed document libraries

  • Duplicate filenames and existing files should be handled safely

  • A future migration tool could copy existing externally linked documents into LaunchBox

Status: Open To Community1 comment

Log in to comment and vote

Comments1

  • AstroBob changed status to Open To Community
    Team•

    Sep 21

    Pinned

    Hi there!

    Thanks so much for submitting this request and for taking the time to explain your use case — that context is always super helpful.

    I’ve gone ahead and fleshed out the main idea using the info you provided, and I’m opening it up to the community for further discussion and feedback. Please let me know if this fleshed-out version doesn’t match your original intended request.

    Feel free to let me know if you have any extra thoughts, examples, or edge cases you think might be relevant!

    Cheers,
    The LaunchBox team