Home Original page

GitHub - Ali7med/PrintBridgeCore: "A lightweight, high-performance .NET 10 Print Server with Web UI and REST API. Supports silent PDF, Image, ZPL, and RAW printing with token-based security and SQLite history tracking.

🖨️ PrintBridge Core

.NET License: MIT

PrintBridge Core is a lightweight, high-performance Print Server built with .NET 10. It provides a modern Web Dashboard and a robust REST API to enable seamless printing from any device (Desktop, Mobile, or IoT) across your network.

✨ Key Features

  • 🚀 Lightweight & Fast: Minimal resource footprint, optimized for background execution.
  • 📄 PDF Printing: Silent printing using a dedicated lightweight engine (SumatraPDF).
  • 🖼️ Image Support: Print JPEG, PNG, and BMP directly to any system printer.
  • 📝 Text & RAW: Supports plain text and RAW/ZPL printing for label printers.
  • 🔒 Secure: Token-based authentication (X-Print-Token) to prevent unauthorized access.
  • 🌐 Web Dashboard: UI for managing settings, generating tokens, and viewing print history.
  • 📺 Live History: Track every print job with status, client IP, and error logs using SQLite.
  • 📡 Network Ready: Easily accessible across your local network.

🛠️ Tech Stack

  • Backend: ASP.NET Core (.NET 10)
  • Database: SQLite (Lightweight history & settings tracking)
  • Frontend: Vanilla HTML5, CSS3, and JavaScript (No heavy frameworks)
  • Printing Engine: Native Winspool & SumatraPDF for PDFs.

🚀 Getting Started

1. Prerequisites

  • .NET 10 SDK
  • A Windows environment (for printer driver access).

2. Installation

  1. Clone the repository: 
    git clone https://github.com/your-username/PrintBridge-Core.git
cd PrintBridge-Core
  2. Crucial: Copy SumatraPDF.exe to the application's runtime directory (e.g., PrinterServer.Api/bin/Debug/net10.0/ or the folder where the .exe resides). Without this file, PDF printing will not work.

3. Running the Server

To enable access from other devices on the network:

dotnet run --project PrinterServer.Api --urls "http://0.0.0.0:5166"

�️ API Route Map

The API is fully documented and can be interacted with using the following endpoints:

Print Operations

  • POST /print - Submit a print job (Content-Type: application/json or multipart/form-data).
    • Supports: pdf, image, text, raw.

Printers & Configuration

  • GET /printers - List all installed printers on the server.
  • GET /settings - Retrieve current server/printer settings.
  • POST /settings - Update global printing settings.

History & Logs

  • GET /history - Access the print audit trail.
    • Query Params: status, printer, from, to, limit.

Security & Tokens

  • GET /token - Retrieve token status and local access settings.
  • POST /token/generate - Generate a new secure API token.
  • POST /token/disable - Toggle token-free access for local network devices.

�🔌 API Usage Example (JSON)

Listing Printers

curl -X GET http://localhost:5166/printers -H "X-Print-Token: YOUR_TOKEN"

Printing a PDF (via Base64)

POST /print
{
  "type": "pdf",
  "printer": "Canon MF272",
  "base64File": "JVBERi0xLjQKJ..."
}

📸 Dashboard Preview

The dashboard is available at the root URL (e.g., http://localhost:5166).

  • Dashboard: View stats and available printers.
  • History: Audit trail of all print jobs.
  • Token Manager: Securely manage API access.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙌 Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.