How shrad2911/audiotrace works
AudioTrace is a Flask-based forensic audio analyzer. A user uploads an audio file; the application saves it, computes hashes and file size, extracts metadata, analyzes signal characteristics and anomalies, then presents findings and generates a downloadable PDF. The README documents waveform, spectrogram, FFT, RMS, zero-crossing, silence, energy-variation, and transition analysis. The sampled code confirms the main orchestration and analysis calls; templates and storage directories were not sampled, so their internal behavior is not expanded here.
Main entry points: app.py Flask workflow · report.py PDF report generation · index.html Upload page · audio_analysis.py Signal analysis
Components 12
Web workflow
- Upload page
templates/index.html - Flask workflow
app.py - Results page
templates/result.html
File integrity
- Hash analysis
modules/hash_analysis.py - Metadata extraction
modules/metadata.py
Audio examination
- Signal analysis
modules/audio_analysis.py - Anomaly analysis
modules/anomaly_analysis.py
Findings and reporting
- PDF report generation
modules/report.py - Report download
app.py
Other components
- Investigator
- FFprobe
- FFmpeg
Connections 16
- Investigator → Upload page: selects audio
README.md - Upload page → Flask workflow: submits audio
README.md - Flask workflow → Upload page: renders
app.py - Flask workflow → Hash analysis: calculates hashes
app.py - Flask workflow → Metadata extraction: requests metadata
app.py - Metadata extraction → FFprobe: probes file
modules/metadata.py - Flask workflow → Signal analysis: analyzes audio
app.py - Signal analysis → FFmpeg: converts audio
modules/audio_analysis.py - Flask workflow → Anomaly analysis: checks anomalies
app.py - Anomaly analysis → FFmpeg: converts audio
modules/anomaly_analysis.py - Flask workflow → PDF report generation: generates report
app.py - PDF report generation → Signal analysis: uses analysis results
modules/report.py - PDF report generation → Anomaly analysis: uses findings
modules/report.py - Flask workflow → Results page: renders findings
app.py - Investigator → Results page: views results
README.md - Investigator → Report download: requests report
app.py