ScanSync is a Python application designed to streamline document management by:

• Creating an SMB server with custom targets.
• Performing OCR (Optical Character Recognition) with OCRmyPdf on new documents in English (ENG) and German (GER).
• Syncing documents to a specified location within your OneDrive.
• Renaming files intelligently using OpenAI or your local Ollama server.
• Ensuring redundancy with RabbitMQ.
• Supporting multiple sync targets.

• SMB Server: Easily connect and manage your documents.
• OCR Support: Automatic text recognition in multiple languages.
• OneDrive Integration: Seamless syncing to your preferred location.
• AI-Powered File Renaming: Smart renaming using using OpenAI or your local Ollama server..
• Redundancy: Reliable document handling with RabbitMQ.
• Multiple Sync Targets: Flexibility to sync across various locations.

I ran into the following issue: I wanted to scan a document using a regular network scanner, OCR that file and move it automatically to SharePoint or OneDrive. There are ver expensive scanners that do have that option, but buying new hardware was out of scope. Then there also is 3rd party software, but it usually requires paid cloud services and subscriptions: Not suitable for a small business or even personal use. Therefore this application, that enables you to use a regular network scanner, make the document searchable by running OCR and then automatically pushing it into your desired OneDrive location. No big hastle, everything local and for free (except the optional OpenAI file naming, but the cost is in the cents.)

1. Clone the repository:

   git clone https://github.com/maxi07/ScanSync.git

2. Install dependencies:
   • Docker
   • Docker Compose
3. Start the application:

   docker compose up --build -d

Once started:

• Connect to the SMB server using:
  • Username: ocr
  • Password: ocr
  • Share: Scans
• Access the web server at your server's IP on port 5001.
• Setup your onedrive connection, add a smb share and start scanning

For development purposes, you can use the built-in Flask server:

1. Update the ENV variable in the docker-compose.yml file to development.
2. Restart the application to enable debug output and Flask development mode.
3. Run pytests via the run-tests.sh script (Spins up a docker test-service)

Returns aggregated document processing status including per-stage breakdowns, currently processing items, and recent completion history.

Response fields:

{
  "processed_pdfs": 10,
  "processing_pdfs": 3,
  "latest_processing_timestamp": "2024-06-01 12:00:00",
  "latest_completed_timestamp": "2024-06-01 11:30:00",
  "latest_created_name": "invoice.pdf",
  "latest_created_status": 2,
  "total_pdfs": 15,
  "failed_pdfs": 2,
  "avg_processing_seconds": 45.68,
  "processing_details": [
    {"status": "OCR Processing", "status_code": 2, "count": 2},
    {"status": "Reading Metadata", "status_code": 1, "count": 1}
  ],
  "currently_processing": [
    {
      "id": 12,
      "file_name": "scan1.pdf",
      "status": "OCR Processing",
      "status_code": 2,
      "created": "2024-06-01 12:00:00",
      "pdf_pages": 3
    }
  ],
  "recent_files": [
    {
      "id": 11,
      "file_name": "doc1.pdf",
      "status": "Completed",
      "status_code": 5,
      "created": "2024-06-01 10:00:00",
      "completed": "2024-06-01 10:01:00",
      "pdf_pages": 2
    }
  ]
}

• Notifications: Stay informed with real-time updates.
• OCR Settings: Take control of OCR settings in the web interface

Thank you for using ScanSync! If you encounter any issues or have feature requests, feel free to open an issue on the GitHub repository.