Web-based printing service using CUPS/IPP.

• List available printers from CUPS
• Display all printer options (from PPD)
• Upload PDF files for printing
• Configure print options (page size, copies, duplex, etc.)
• Monitor job status with real-time updates
• View pages printed (job-impressions-completed)
• OIDC Authentication
• Page count reports

# Debian/Ubuntu
sudo apt install cups libcups2-dev python3-dev

# Fedora/RHEL
sudo dnf install cups cups-devel python3-devel

CUPS must be installed and running with at least one printer configured.

Python 3.10+ required.

1. Clone the repository:

git clone <repo-url>
cd ippweb

1. Create and activate a virtual environment:

python3 -m venv venv
source venv/bin/activate

1. Install dependencies:

pip install -r requirements.txt

1. Copy environment configuration:

cp .env.example .env
# Edit .env as needed

python run.py

Or with Flask CLI:

flask --app app run --debug

The application will be available at http://localhost:5000

See the Dockerfile and docker-compose.prod.yml

Environment variables (see .env.example):

Planned features (not in MVP):

• Option filtering UI (show only common options)
• Additional file format support (PostScript, images)
• Multi-user support with quotas

MIT