Media Importer Project

This repository contains the development and testing resources for the media-importer.sh script, which is the main product of this project.

Project Structure

• media-importer.sh: The primary script under development and testing.
• AGENTS.md: Safety rules for agents or unattended automation that copy, derive, or run the importer.
• INCIDENTS.md: Postmortems for data-loss or near-data-loss incidents and the regression rules derived from them.
• sample/: Contains local media fixtures used for development and testing. Note: Scripts and functions are not imported from sample directories.

Version Control

Version control is implemented for all files except the samples/ directory. The samples/ directory is excluded from version control to avoid tracking test resources and sample files.

To exclude the samples/ directory, the following entry should be added to the .gitignore file:

samples/

Contribution Guidelines

• All development should focus on media-importer.sh.
• Do not import, source, or derive importer behavior from sample directories.
• Use sample media only for testing and development reference.
• Do not use removed Raspberry Pi / unattended wrapper prototypes as a reference design; they were based on an outdated, unvalidated importer copy.
• Destination conflicts must never be delegated to copy/move tools. In unattended runs the importer appends numeric suffixes (_1, _2, ...); in interactive runs it asks the user and supports applying the choice to all similar conflicts.

License

Specify your license here.

For details on recent changes, including the removal of fallback date handling, see CHANGELOG.md.

This file is intended for GitHub Copilot and contributors to understand the project structure and guidelines.