This project provides an integration between Doccle and Paperless, allowing you to automatically download new documents from Doccle and upload them to Paperless for easy organization and management.
- Automatically checks for new documents in Doccle at regular intervals
- Downloads new documents as PDF files with friendly filenames
- Saves document metadata as JSON files
- Uploads downloaded documents to Paperless
- Archives documents in Doccle after successful upload to Paperless
- Provides a health check endpoint for monitoring the application's status
- Supports running the application locally or using Docker
- Assign owner, tags, correspondents, and document types from Doccle's metadata
- Add push notifications
- Better scheduling
- Better logging
- Better status API
- Python 3.9 or later
- Docker and Docker Compose (optional, for running the application in a container)
- Doccle account with valid credentials
- Paperless instance with API access
-
Clone the repository and navigate to the project directory.
-
For local usage, create a
.envfile based on the provided.env.samplefile and fill in the required Doccle and Paperless credentials. -
For Docker usage, update the
docker-compose.yamlfile with the necessary Doccle and Paperless credentials in theenvironmentsection.
-
Install the required dependencies:
pip install -r requirements.txt -
Run the application:
python main.py
- Build the Docker image and start the container:
docker-compose up
The application will periodically check for new documents in Doccle, download them, and upload them to Paperless.
Detailed logs are generated in the logs directory with timestamped filenames. Each log entry includes the timestamp, log level, and message, covering events such as document downloads, uploads, and errors.
This project provides an integration between Doccle and Paperless, allowing you to automatically download new documents from Doccle and upload them to Paperless for easy organization and management.
- Automatically checks for new documents in Doccle at regular intervals
- Downloads new documents as PDF files with friendly filenames
- Saves document metadata as JSON files
- Uploads downloaded documents to Paperless
- Archives documents in Doccle after successful upload to Paperless
- Provides a health check endpoint for monitoring the application's status
- Supports running the application locally or using Docker
- Assign owner, tags, correspondents, and document types from Doccle's metadata
- Add push notifications
- Better scheduling
- Better logging
- Better status API
- Python 3.9 or later
- Docker and Docker Compose (optional, for running the application in a container)
- Doccle account with valid credentials
- Paperless instance with API access
-
Clone the repository and navigate to the project directory.
-
For local usage, create a
.envfile based on the provided.env.samplefile and fill in the required Doccle and Paperless credentials. -
For Docker usage, update the
docker-compose.yamlfile with the necessary Doccle and Paperless credentials in theenvironmentsection.
-
Install the required dependencies:
pip install -r requirements.txt -
Run the application:
python main.py
- Build the Docker image and start the container:
docker-compose up
The application will periodically check for new documents in Doccle, download them, and upload them to Paperless.
In case some documents fail to import automatically, you can manually retry importing all downloaded documents from the downloaded_documents folder:
-
Ensure your
.envfile includesPAPERLESS_URLandPAPERLESS_TOKEN. -
Run the manual import script:
python import_downloaded.py
Note: Depending on your Paperless instance settings, you may receive an OK response from the Paperless API, but the document might not import successfully if it already exists in Paperless. In such cases, check the Paperless application for any in-app error messages.
Detailed logs are generated in the logs directory with timestamped filenames. Each log entry includes the timestamp, log level, and message, covering events such as document downloads, uploads, and errors.
The application provides a health check endpoint at /health that returns the current status and uptime of the application.
Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.
This project is licensed under the GNU General Public License v3.0.
- Steve Gilissen, author of py-doccle
- Doccle for providing the document management platform
- Paperless-NGX for the community-supported open-source document management system