{"id":44898995,"url":"https://github.com/jordonh18/continuum","last_synced_at":"2026-02-17T21:05:16.635Z","repository":{"id":333673803,"uuid":"1137395561","full_name":"Jordonh18/continuum","owner":"Jordonh18","description":"Printer Proxy is a Linux-based service that transparently redirects print jobs from failed printers to available devices using iptables NAT, without requiring client reconfiguration.","archived":false,"fork":false,"pushed_at":"2026-02-04T11:22:32.000Z","size":701,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-04T23:42:50.484Z","etag":null,"topics":["debian","dnat","failover","high-availability","iptables","linux","nat","networking","printer","printer-management","python","self-hosted","selfhosted","sysadmin","ubuntu"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jordonh18.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-19T10:09:52.000Z","updated_at":"2026-01-26T09:57:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Jordonh18/continuum","commit_stats":null,"previous_names":["jordonh18/printer-proxy","jordonh18/continuum"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/Jordonh18/continuum","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jordonh18%2Fcontinuum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jordonh18%2Fcontinuum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jordonh18%2Fcontinuum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jordonh18%2Fcontinuum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jordonh18","download_url":"https://codeload.github.com/Jordonh18/continuum/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jordonh18%2Fcontinuum/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29558101,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T20:52:40.164Z","status":"ssl_error","status_checked_at":"2026-02-17T20:48:10.325Z","response_time":100,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["debian","dnat","failover","high-availability","iptables","linux","nat","networking","printer","printer-management","python","self-hosted","selfhosted","sysadmin","ubuntu"],"created_at":"2026-02-17T21:05:15.736Z","updated_at":"2026-02-17T21:05:16.629Z","avatar_url":"https://github.com/Jordonh18.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Continuum\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)\n[![Platform](https://img.shields.io/badge/platform-linux-lightgrey.svg)](https://ubuntu.com/)\n[![GitHub release](https://img.shields.io/github/v/release/Jordonh18/continuum)](https://github.com/Jordonh18/continuum/releases)\n[![GitHub issues](https://img.shields.io/github/issues/Jordonh18/continuum)](https://github.com/Jordonh18/continuum/issues)\n[![CodeRabbit Pull Request Reviews](https://img.shields.io/coderabbit/prs/github/Jordonh18/continuum?utm_source=oss\u0026utm_medium=github\u0026utm_campaign=Jordonh18%2Fcontinuum\u0026labelColor=171717\u0026color=FF570A\u0026link=https%3A%2F%2Fcoderabbit.ai\u0026label=CodeRabbit+Reviews)](https://coderabbit.ai)\n\nA modern network printer management platform with transparent traffic redirection. When a printer fails, Continuum automatically redirects print jobs to working printers using NAT/iptables, no client reconfiguration required.\n\n## Features\n\n### Printer Management\n- **Automatic Discovery**: Find printers via mDNS, SNMP scanning, or manual entry\n- **Health Monitoring**: Real-time status tracking with ICMP and TCP checks\n- **Job Tracking**: Monitor print jobs and page counts via SNMP\n- **Statistics \u0026 Analytics**: Historical data and uptime reports\n\n### Network Redirection\n- **Transparent Failover**: Automatically redirect traffic from failed printers to working replacements\n- **Secondary IP Assignment**: Dynamically claims failed printer IPs as network aliases\n- **NAT/DNAT Rules**: iptables-based traffic forwarding for seamless redirection\n- **Protocol Support**: RAW (9100), IPP (631), LPR (515)\n- **Group Redirects**: Schedule redirects for multiple printers simultaneously\n\n### Workflow Automation\n- **Visual Workflow Builder**: Drag-and-drop interface for creating automation\n- **Triggers**: Schedule-based, event-based, or manual workflow execution\n- **Actions**: Printer operations, redirects, notifications, HTTP requests, email\n- **Conditions**: Branch logic based on printer status, time, or custom variables\n\n### Notifications \u0026 Alerts\n- **Multi-Channel**: Email, Slack, Discord, Microsoft Teams, webhooks\n- **Event Types**: Printer offline/online, redirect changes, job completion, workflow events\n- **Custom Rules**: Configure notification preferences per event type\n\n### Security \u0026 Access\n- **JWT Authentication**: Secure API access with token-based auth\n- **User Management**: Create users, set passwords, manage permissions\n- **MFA Support**: TOTP-based two-factor authentication\n- **Account Lockout**: Brute-force protection with configurable thresholds\n- **API Tokens**: Generate tokens for programmatic access\n- **Rate Limiting**: Protect against abuse with configurable rate limits\n\n### Modern Web Interface\n- **React + TypeScript**: Fast, responsive single-page application\n- **Dark Mode**: System-aware theme switching\n- **Real-Time Updates**: Live status updates via polling\n- **Mobile-Friendly**: Responsive design for any device\n\n### System \u0026 Deployment\n- **APT Repository**: Easy installation and automatic updates\n- **Systemd Integration**: Native service management\n- **Nginx Reverse Proxy**: Production-ready HTTPS setup\n- **Self-Signed Certificates**: Auto-generated SSL for development\n\n## Installation\n\n### Via APT Repository (Recommended)\n\n```bash\n# Add the GPG signing key\ncurl -fsSL https://apt.jordonh.me/gpg-key.asc | sudo gpg --dearmor -o /usr/share/keyrings/continuum.gpg\n\n# Add the repository\necho \"deb [signed-by=/usr/share/keyrings/continuum.gpg] https://apt.jordonh.me stable main\" | sudo tee /etc/apt/sources.list.d/continuum.list\n\n# Install Continuum\nsudo apt update\nsudo apt install continuum\n```\n\n### Manual Installation\n\n```bash\n# Download the latest .deb package\nwget https://github.com/Jordonh18/continuum/releases/latest/download/continuum_VERSION_all.deb\n\n# Install\nsudo dpkg -i continuum_VERSION_all.deb\nsudo apt-get install -f  # Install dependencies\n```\n\n## Quick Start\n\n1. **Access the Web UI**: Navigate to `https://\u003cserver-ip\u003e` (accept the self-signed certificate warning)\n2. **Create Admin Account**: Complete the initial setup wizard\n3. **Discover Printers**: Use the discovery tool to find printers on your network\n4. **Create Redirect**: Select a failed printer and redirect it to a working one\n\n## How It Works\n\n```\n                           ┌──────────────────────────────────────┐\n                           │       Continuum Server           │\n                           │                                      │\n                           │  1. Claims 192.168.1.10 as secondary │\n                           │  2. Applies DNAT rule in iptables    │\n                           │  3. Forwards traffic to target       │\n                           └──────────────────────────────────────┘\n                                          ▲           │\n                       Print to           │           │ Forwarded\n                    192.168.1.10:9100     │           │ to target\n                                          │           ▼\n┌──────────────────┐                      │           ┌───────────────────────┐\n│   Client PC      │──────────────────────┘           │   Working Printer     │\n│                  │                                  │   192.168.1.20        │\n│  No changes      │                                  │   Receives jobs       │\n│  required        │                                  └───────────────────────┘\n└──────────────────┘\n```\n\nContinuum operates at the network layer, intercepting TCP print traffic destined for a failed printer and transparently redirecting it to a working replacement. The proxy server claims the failed printer's IP address as a secondary interface and applies DNAT rules to forward connections, clients continue printing without any configuration changes.\n\n## Upgrading\n\n```bash\nsudo apt update\nsudo apt upgrade continuum\n```\n\nThe service will automatically restart after upgrade.\n\n## Development\n\n### Prerequisites\n- Python 3.9+\n- Node.js 18+ and npm\n- Linux with iptables support\n\n### Setup\n\n```bash\n# Clone repository\ngit clone https://github.com/Jordonh18/continuum.git\ncd continuum\n\n# Backend setup\npython3 -m venv venv\nsource venv/bin/activate\npip install -r requirements.txt\n\n# Frontend setup\ncd frontend\nnpm install\nnpm run build\n\n# Run development server (backend on :8080)\ncd ..\npython run.py\n```\n\n### Building\n\n```bash\n# Build .deb package\n./scripts/build-deb.sh\n\n# Package will be in builds/\n```\n\n## System Requirements\n\n- **OS**: Ubuntu 20.04+ or Debian 11+\n- **Python**: 3.9 or higher\n- **Permissions**: Root/sudo access for iptables manipulation\n- **Network**: Interface capable of multiple IP addresses\n\n## Project Structure\n\n```\ncontinuum/\n├── app/                    # Backend application\n│   ├── models/            # Database models\n│   ├── routes/            # API endpoints\n│   ├── services/          # Business logic (health check, discovery, etc.)\n│   └── utils/             # Authentication, rate limiting, etc.\n├── frontend/              # React + TypeScript SPA\n│   └── src/\n│       ├── components/    # UI components\n│       ├── pages/         # Page components\n│       └── lib/           # API client, utilities\n├── scripts/               # Build and utility scripts\n├── debian/                # Debian packaging files\n└── config/                # Application configuration\n\n```\n\n## Contributing\n\nContributions are welcome! Please:\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Links\n\n- **Documentation**: [GitHub Wiki](https://github.com/Jordonh18/continuum/wiki)\n- **Issue Tracker**: [GitHub Issues](https://github.com/Jordonh18/continuum/issues)\n- **APT Repository**: [https://apt.jordonh.me](https://apt.jordonh.me)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjordonh18%2Fcontinuum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjordonh18%2Fcontinuum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjordonh18%2Fcontinuum/lists"}