How m000gg/camougg works
camougg is a local-first terminal application for password-protecting arbitrary files hidden in PNG or JPEG images, then extracting them. The main workflow is user → TUI → file selection and password/output choices → service → format-specific image handling and steganography → saved carrier or recovered payload. The graph also preserves the documented audio/video placeholder screens and a separate message-oriented engine path present in the source index. Evidence is limited to the README and shown excerpts or source-index references; unsampled implementation details are not inferred.
Main entry points: service.py File service · photo_stego_screen.py Photo workflow · app.py TUI app · main_menu_screen.py Main menu
Components 18
Terminal interface
- TUI app
src/camougg/tui/app.py - Main menu
src/camougg/tui/screens/main/main_menu_screen.py - Photo workflow
src/camougg/tui/screens/photo/photo_stego_screen.py - File picker
src/camougg/tui/screens/other/file_picker_screen.py - Audio/video screens
src/camougg/tui/screens/other/to_be_done_screen.py
File workflow
- File service
src/camougg/core/service.py - Payload I/O
src/camougg/core/payload_io.py
Steganography
- Steganography
src/camougg/core/steganography.py - Password permutation
src/camougg/crypto/CSPRN_generator.py - Message engine
src/camougg/core/camougg_engine.py - Message writer
src/camougg/core/steg/steg_write.py - Message reader
src/camougg/core/steg/steg_read.py - Pixel permutation
src/camougg/crypto/CSPRNGenerator.py
Image formats
- PNG handler
src/camougg/formats/png_handler.py - JPEG handler
src/camougg/formats/jpeg_handler.py
Other components
- User
- PNG/JPEG carrier
- Recovered payload
Connections 20
- User → TUI app: uses
README.md - TUI app → Main menu: opens
src/camougg/tui/app.py - TUI app → Photo workflow: registers
src/camougg/tui/app.py - TUI app → Audio/video screens: registers
src/camougg/tui/app.py - Main menu → Photo workflow: opens
src/camougg/tui/screens/main/main_menu_screen.py - Main menu → Audio/video screens: opens
src/camougg/tui/screens/main/main_menu_screen.py - User → Photo workflow: chooses operation
README.md - Photo workflow → File picker: opens picker
src/camougg/tui/screens/photo/photo_stego_screen.py - Photo workflow → File service: invokes embed/extract
src/camougg/tui/screens/photo/photo_stego_screen.py - File service → Payload I/O: reads/writes payload
src/camougg/core/service.py - File service → Steganography: embeds/extracts data
src/camougg/core/service.py - File service → PNG handler: loads/saves PNG
src/camougg/core/service.py - File service → JPEG handler: loads/saves JPEG
src/camougg/core/service.py - Steganography → Password permutation: uses permutation
src/camougg/core/steganography.py - Steganography → PNG/JPEG carrier: writes/reads carrier data
README.md - Payload I/O → Recovered payload: writes extracted file
- Message engine → Message writer: calls writer
src/camougg/core/camougg_engine.py - Message engine → Message reader: calls reader
src/camougg/core/camougg_engine.py - Message writer → Pixel permutation: uses permutation
src/camougg/core/steg/steg_write.py - Message reader → Pixel permutation: uses permutation
src/camougg/core/steg/steg_read.py