1 contributor
# 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:
```gitignore
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](./CHANGELOG.md).
This file is intended for GitHub Copilot and contributors to understand the project structure and guidelines.