How youssef-rahmouni/vocalrecovery works
Project type and purpose
• Vocal-Recovery is a small, open-source Python CLI tool whose sole purpose is to recover and extract audio recordings from arbitrary file system locations by scanning metadata (duration, size, date, optional keywords).
• It is not a web app or microservice: it’s a single-process command-line utility with a clear focus on file I/O and metadata filtering.
File structure
• Top-level scripts:
• main.py – the entry point that parses user choices (Auto vs Manual), invokes the core logic, and orchestrates I/O.
• tools.py – houses the core functions for scanning directories, reading metadata, applying filters, and copying matched files.
• Data/config:
• CallsList.csv – example CSV input for Auto Search mode (drives batch criteria).
• Supporting directories:
• others/legacys and others/ToDo – legacy code and backlog items (not part of runtime).
• tests/ – unit tests across three levels (test_lvl0.py, testlvl1.py, testlvl2.py).
• out_record/items_finds/ – the runtime output folder where matched audio files are placed.
README for additional insights
• Describes two modes (Auto vs Manual) and the end-to-end flow: user chooses mode → tool scans file system → filters by metadata → copies matches into out_record.
• Mentions future features tracked in ToDo.
• No explicit external service dependencies; uses local Python libs to read metadata and copy files.
Elements
• Blue for user-facing components (CLI, msg.py)
• Green for business logic (tools.py)
• Orange for data sources/sinks (file system, CSV)
• Gray for tests and legacy/backlog modules