BookScan
Scanner (ATScanner) — ensemble Atelier pour numériser des livres : application Android bookscan (capture) + companion bureau bookscan-companion (réception LAN, pipeline image, UI Livescan) + scripts utilitaires.
📸 Aperçu
| Companion | Capture |
|---|---|
 |
 |
📖 À propos
BookScan — ensemble Atelier pour numériser des livres : application Android bookscan (capture) + companion bureau bookscan-companion (réception LAN, pipeline image, UI Livescan) + scripts utilitaires.
🧩 Composants
| Élément | Technologie | Rôle |
|---|---|---|
bookscan/ |
Android (Gradle) | Capture (modes auto / semi / manuel), envoi vers le companion |
bookscan-companion/ |
Rust (eframe/egui, axum) | Serveur LAN (port 7842), pipeline CPU, export PDF, UI |
protocol/ |
WebSocket JSON | Schéma /v1/ws (capture_now, set_mode, point_state…) |
atscanner/ |
Python (OpenCV…) | Prototype UI déprécié |
scripts/ |
bat / Python | Pare-feu, smoke test companion |
✨ Pipeline (companion)
Réception des pages → détection de document (quad) → redressement / crop → amélioration → bibliothèque locale → export PDF. Le companion expose aussi des étapes type retrait de doigts / écriture manuscrite côté pipeline.
⬇️ Installation / lancement
Companion PC
run_companion.bat- Lance
bookscan-companion/target/release/bookscan-companion.exes’il existe - Sinon (ou avec
--rebuild) :cargo build --releasepuis exécution - Port par défaut : 7842 (
BOOKSCAN_PORTpour le changer)
Pare-feu Windows (règle TCP 7842) :
scripts\open-firewall-bookscan.batApplication Android bookscan
cd bookscan
gradlew.bat assembleDebugInstaller l’APK, connecter le téléphone et le PC sur le même Wi‑Fi, pointer l’app vers l’IP du companion.
Ancien lanceur Python
run_atscanner.bat et python -m atscanner sont dépréciés et redirigent vers le companion.
📚 Dépendances Python (prototype / outils)
Fichier requirements.txt :
opencv-python,numpy,Pillow,img2pdf,pytesseract
📜 Scripts
| Script | Rôle |
|---|---|
run_companion.bat |
Build/lancement du companion Rust |
run_atscanner.bat |
Déprécié → appelle run_companion.bat |
scripts/open-firewall-bookscan.bat |
Ouvre le port TCP 7842 |
scripts/smoke_companion.py |
Smoke test du companion |
🔗 Ressources
| 🌐 l’Atelier | atelier.atechnologie.fr |
📸 Vorschau
| Companion | Aufnahme |
|---|---|
|
|
📖 Über
BookScan — Atelier-Werkzeugsatz zum Buchscannen: Android-App bookscan (Aufnahme) + Desktop-bookscan-companion (LAN-Empfang, Bildpipeline, Livescan-UI) + Hilfsskripte.
🧩 Komponenten
| Teil | Technik | Rolle |
|---|---|---|
bookscan/ |
Android (Gradle) | Aufnahme (auto / semi / manuell), Versand an Companion |
bookscan-companion/ |
Rust (eframe/egui, axum) | LAN-Server (Port 7842), CPU-Pipeline, PDF-Export, UI |
protocol/ |
WebSocket JSON | Schema /v1/ws (capture_now, set_mode, point_state…) |
atscanner/ |
Python (OpenCV…) | Veralteter UI-Prototyp |
scripts/ |
bat / Python | Firewall-Hilfe, Companion-Smoke-Test |
✨ Pipeline (Companion)
Seiten empfangen → Dokumenterkennung (Quad) → Entzerren / Zuschneiden → Verbessern → lokale Bibliothek → PDF-Export. Die Pipeline enthält auch Stufen zur Finger-/Handschriftentfernung.
⬇️ Installation / Start
PC-Companion
run_companion.bat- Startet
bookscan-companion/target/release/bookscan-companion.exe, falls vorhanden - Sonst (oder mit
--rebuild):cargo build --release, dann Start - Standardport: 7842 (
BOOKSCAN_PORTzum Ändern)
Windows-Firewall (TCP-7842-Regel):
scripts\open-firewall-bookscan.batAndroid-App bookscan
cd bookscan
gradlew.bat assembleDebugAPK installieren, Telefon und PC im selben WLAN halten, App auf die Companion-IP zeigen.
Alter Python-Starter
run_atscanner.bat und python -m atscanner sind veraltet und leiten zum Companion weiter.
📚 Python-Abhängigkeiten (Prototyp / Tools)
requirements.txt:
opencv-python,numpy,Pillow,img2pdf,pytesseract
📜 Skripte
| Skript | Rolle |
|---|---|
run_companion.bat |
Build/Start des Rust-Companions |
run_atscanner.bat |
Veraltet → ruft run_companion.bat auf |
scripts/open-firewall-bookscan.bat |
Öffnet TCP-Port 7842 |
scripts/smoke_companion.py |
Companion-Smoke-Test |
🔗 Ressourcen
| 🌐 l’Atelier | atelier.atechnologie.fr |
📸 Preview
| Companion | Capture |
|---|---|
|
|
📖 About
BookScan — Atelier toolkit for book scanning: Android bookscan app (capture) + desktop bookscan-companion (LAN receive, image pipeline, Livescan UI) + utility scripts.
🧩 Components
| Piece | Stack | Role |
|---|---|---|
bookscan/ |
Android (Gradle) | Capture (auto / semi / manual), send to companion |
bookscan-companion/ |
Rust (eframe/egui, axum) | LAN server (port 7842), CPU pipeline, PDF export, UI |
protocol/ |
WebSocket JSON | /v1/ws schema (capture_now, set_mode, point_state…) |
atscanner/ |
Python (OpenCV…) | Deprecated UI prototype |
scripts/ |
bat / Python | Firewall helper, companion smoke test |
✨ Pipeline (companion)
Receive pages → document detection (quad) → warp / crop → enhance → local library → PDF export. The companion pipeline also includes finger / handwriting removal stages.
⬇️ Install / run
PC companion
run_companion.bat- Runs
bookscan-companion/target/release/bookscan-companion.exeif present - Otherwise (or with
--rebuild):cargo build --releasethen run - Default port: 7842 (
BOOKSCAN_PORTto override)
Windows firewall (TCP 7842 rule):
scripts\open-firewall-bookscan.batAndroid bookscan app
cd bookscan
gradlew.bat assembleDebugInstall the APK, keep phone and PC on the same Wi‑Fi, point the app at the companion IP.
Legacy Python launcher
run_atscanner.bat and python -m atscanner are deprecated and redirect to the companion.
📚 Python dependencies (prototype / tools)
requirements.txt:
opencv-python,numpy,Pillow,img2pdf,pytesseract
📜 Scripts
| Script | Role |
|---|---|
run_companion.bat |
Build/run the Rust companion |
run_atscanner.bat |
Deprecated → calls run_companion.bat |
scripts/open-firewall-bookscan.bat |
Opens TCP port 7842 |
scripts/smoke_companion.py |
Companion smoke test |
🔗 Resources
| 🌐 l’Atelier | atelier.atechnologie.fr |
📸 Vista previa
| Companion | Captura |
|---|---|
|
|
📖 Acerca de
BookScan — conjunto Atelier para digitalizar libros: app Android bookscan (captura) + companion de escritorio bookscan-companion (recepción LAN, pipeline de imagen, UI Livescan) + scripts de utilidad.
🧩 Componentes
| Elemento | Tecnología | Función |
|---|---|---|
bookscan/ |
Android (Gradle) | Captura (auto / semi / manual), envío al companion |
bookscan-companion/ |
Rust (eframe/egui, axum) | Servidor LAN (puerto 7842), pipeline CPU, export PDF, UI |
protocol/ |
WebSocket JSON | Esquema /v1/ws (capture_now, set_mode, point_state…) |
atscanner/ |
Python (OpenCV…) | Prototipo UI obsoleto |
scripts/ |
bat / Python | Firewall, smoke test del companion |
✨ Pipeline (companion)
Recepción de páginas → detección de documento (quad) → enderezado / recorte → mejora → biblioteca local → export PDF. El pipeline incluye también etapas de retirada de dedos / escritura manuscrita.
⬇️ Instalación / lanzamiento
Companion PC
run_companion.bat- Lanza
bookscan-companion/target/release/bookscan-companion.exesi existe - Si no (o con
--rebuild):cargo build --releasey ejecución - Puerto por defecto: 7842 (
BOOKSCAN_PORTpara cambiarlo)
Firewall Windows (regla TCP 7842):
scripts\open-firewall-bookscan.batApp Android bookscan
cd bookscan
gradlew.bat assembleDebugInstale el APK, mantenga teléfono y PC en la misma Wi‑Fi, apunte la app a la IP del companion.
Lanzador Python antiguo
run_atscanner.bat y python -m atscanner están obsoletos y redirigen al companion.
📚 Dependencias Python (prototipo / herramientas)
requirements.txt:
opencv-python,numpy,Pillow,img2pdf,pytesseract
📜 Scripts
| Script | Función |
|---|---|
run_companion.bat |
Build/lanzamiento del companion Rust |
run_atscanner.bat |
Obsoleto → llama a run_companion.bat |
scripts/open-firewall-bookscan.bat |
Abre el puerto TCP 7842 |
scripts/smoke_companion.py |
Smoke test del companion |
🔗 Recursos
| 🌐 l’Atelier | atelier.atechnologie.fr |