How sosoj92/signal-matin works
Signal Matin turns selected personal and public sources into a dated, normalized morning newspaper, then offers browser, PDF, print, and e-reader outputs. The graph follows the documented CLI workflow and preserves the major content, pagination, and delivery branches. Evidence is limited to the README, SOURCE INDEX references, and excerpts provided; unsampled implementation details are not inferred.
Main entry points: cli.py Command interface · pipeline.py Live collection · pdf.py A4 and e-ink PDF · renderer.py HTML newspaper
Components 23
Entry and configuration
- Command interface
src/signal_matin/cli.py - Local settings
src/signal_matin/config.py
Edition content
- Live collection
src/signal_matin/pipeline.py - Demo edition
src/signal_matin/mock_data.py - Weather source
src/signal_matin/connectors/weather.py - ICS calendar
src/signal_matin/connectors/calendar_ics.py - Google Calendar
src/signal_matin/connectors/google_calendar.py - Tasks and reminders
src/signal_matin/connectors/tasks.py - RSS news and tech
src/signal_matin/connectors/rss.py - Daily learning
src/signal_matin/daily_learning.py - Edition model
src/signal_matin/models.py
Composition and files
- Validate and normalize
src/signal_matin/normalizer.py - HTML newspaper
src/signal_matin/renderer.py - Adaptive pagination
src/signal_matin/assets/signal_matin_pagination.js - A4 and e-ink PDF
src/signal_matin/pdf.py - Edition JSON
src/signal_matin/normalizer.py
Reading and delivery
- Browser preview
src/signal_matin/cli.py - Printer output
src/signal_matin/printer.py - EPUB edition
src/signal_matin/ereader.py - Reader server
src/signal_matin/ereader_server.py
Other components
- User
- RSS feeds
- Google Calendar service
Connections 29
- User → Command interface: runs command
README.md - Command interface → Local settings: loads settings
src/signal_matin/cli.py - Command interface → Live collection: builds live edition
src/signal_matin/cli.py - Command interface → Demo edition: selects demo
src/signal_matin/cli.py - Live collection → Weather source: collects weather
src/signal_matin/pipeline.py - Live collection → ICS calendar: collects events
src/signal_matin/pipeline.py - Live collection → Google Calendar: collects optionally
src/signal_matin/pipeline.py - Live collection → Tasks and reminders: collects tasks
src/signal_matin/pipeline.py - Live collection → RSS news and tech: collects feeds
src/signal_matin/pipeline.py - Live collection → Daily learning: builds learning page
src/signal_matin/pipeline.py - Live collection → Edition model: creates edition
src/signal_matin/pipeline.py - Demo edition → Daily learning: builds demo content
src/signal_matin/mock_data.py - Command interface → Validate and normalize: normalizes edition
src/signal_matin/cli.py - Validate and normalize → Edition model: validates data
src/signal_matin/normalizer.py - Command interface → Edition JSON: writes edition
README.md - Command interface → HTML newspaper: renders preview
src/signal_matin/cli.py - HTML newspaper → Edition model: renders model
src/signal_matin/renderer.py - A4 and e-ink PDF → HTML newspaper: renders HTML
src/signal_matin/pdf.py - A4 and e-ink PDF → Adaptive pagination: runs pagination
src/signal_matin/pdf.py - Command interface → A4 and e-ink PDF: generates PDF
src/signal_matin/cli.py - Command interface → Printer output: sends confirmed print
src/signal_matin/cli.py - Command interface → EPUB edition: generates EPUB
src/signal_matin/cli.py - EPUB edition → A4 and e-ink PDF: generates e-ink PDF
src/signal_matin/ereader.py - Command interface → Reader server: starts reader service
src/signal_matin/cli.py - RSS news and tech → RSS feeds: reads feeds
src/signal_matin/connectors/rss.py - Google Calendar → Google Calendar service: queries events
src/signal_matin/connectors/google_calendar.py - User → Browser preview: views output
README.md - User → Printer output: prints newspaper
README.md - User → EPUB edition: reads edition
README.md