• Copy URL to clipboard
README

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.
  • INCIDENTS.md: Postmortems for data-loss or near-data-loss incidents and the regression rules derived from them.
  • RPI/: Raspberry Pi integration prototype. This area is currently frozen because Raspberry Pi 3B+ hardware with 1 GB RAM has not provided reliable validation capacity and may also be affected by hardware defects.
  • samples/code/autonas-media-importer.sh: The original script that serves as inspiration for this project.
  • samples/: Contains code samples, example files, and other resources used for development and testing. Note: Scripts and functions are not imported from this directory; it is strictly for reference and testing purposes.

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 or source scripts/functions from the samples/ directory.
  • Use resources in samples/ only for testing and development reference.
  • 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.