System Overview
Live dashboard aggregating library, monitoring, recording and system-health metrics.
💡Capacity suggestions
—Estimates assume radio/audio channels with monitor + record + identify (20s cycle). See the hardware guide below for tier sizing.
AUDIOBoxx hardware guide (10–50 channels)
Recommended specs for radio/audio monitor + record + identify (20s cycle, ~128 kbps MP3 recording). Recording disk is separate from the OS drive. Monthly ingest is approximate.
Detecting hardware…
This machine (comfortable max) · License limit
| Streams | CPU | RAM | OS / DB (NVMe) | Recording disk | Est. monthly ingest | Network | RocksDB cache |
|---|
⚡CPU Usage
0%◰RAM Usage
0%🏆Top matched songs
ℹEnvironment
⎗Backup Recordings
⟳Backup History
▦Track metadata catalogue
Not loadedUpload Excel/CSV: column A = track name, column B = album. Match 1) report Title (e.g. 04 - TAJA SAMACHARA - MALE → TAJA SAMACHARA - MALE), then 2) report Album / Folder vs column B. When both match, the full catalogue row is exported as Meta: ….
🔓 LAN access —
Role-based LAN accounts. Data entry = Results tab only (play kind / EPG). Analyst+ adds Overview, Report, Recording, About.
| Username | Display | Role | Enabled |
|---|
Recent audit log
◆Recent Matches
Top 10💾Storage Backend
—Choose where fingerprints are stored at query time. RocksDB keeps everything on disk — fast startup, lower memory (~300 MB), ~1–2 s identify. In-Memory rehydrates into RAM at startup — slow startup, higher memory (~1.5–2 GB), ~150–400 ms identify. SQLite is always kept as a durable backup, so switching is safe.
🗄️Fingerprint Libraries
—Each library is a separate fingerprint database. New fingerprints and identifications use the active library. Monitor logs and streams are shared across libraries.
Add track to reference library
Upload a WAV file. AUDIOBoxx computes acoustic hashes and stores them locally.
Bulk fingerprint from folder
Server scans the given path on this machine (recursively) and fingerprints every matching audio file. Track ID defaults to the relative path; artist defaults to the parent folder name.
Identify unknown audio
Upload a short clip to match against the reference library.
Bulk identify from folder
Server recursively scans a local folder and identifies every audio file against the reference library. Download CSV uses the same airplay schema as the Reports export, including Meta: columns when a track metadata catalogue is loaded on Overview.
Reference library
Stored tracks are persisted to ./data on disk.
| ID | Title | Album / folder | Type | |
|---|---|---|---|---|
| No tracks yet. | ||||
Live Monitor
Register broadcast/HLS/HTTP audio streams. A background worker captures an audio chunk at every interval, identifies it against the library, and appends results to an append-only log. Requires ffmpeg on PATH (override with Monitor:FfmpegPath).
http://127.0.0.1:5001/live/<channelId>.m3u8.Live log
Shows the latest 5,000 detections in this view; older rows remain in the database and in Report / Excel export.
Stream Management
Register broadcast/HLS/HTTP sources for live identification and recording. Requires ffmpeg on PATH (override with Monitor:FfmpegPath).
≡Configured streams
| Name | URL | Category | Library | Recording | Status | Duration | Matches | Last match | |
|---|---|---|---|---|---|---|---|---|---|
| No streams configured yet. | |||||||||
Recording Management
Continuously record configured streams to disk as hour-segmented files. Use the View Results tab to map detections to recorded segments and play them back.
📁Recorded files
View Results
Cross-reference detection events with recorded audio/video (live monitor) or folder-identify source files (offline). Pick a results source, filter by stream or scan folder, then play or download matched clips.
▶Recording player
⧗Day timeline
≡Detection events
Reports & Analytics
Aggregate analytics from live monitor events or folder-identify results saved in offline_results.db. Pick a results source, date range, and stream or scan folder, then generate KPIs, charts, and exports.
📈Daily trend
⧗Hourly distribution
⎍Confidence distribution
◔Match vs no-match
📅Day-of-week distribution
▥Channel comparison
📈Cumulative match trend
◕Channel contribution share
🗣Language distribution
≡Per-language airtime
| Language | Matches | Match airtime | Share |
|---|---|---|---|
| No language data yet. | |||
🔢Matches by language
▦Channel airtime by language
≡Channel × language airtime
| Channel | Language | Matches | Match airtime | % of total |
|---|---|---|---|---|
| No channel-language data yet. | ||||
🎵Top 10 songs (visual)
⚖Channel match-rate comparison
⤴Hourly match-rate %
◎Channel average confidence
◒Weekday vs Weekend
◀Last 7 days trend
🔥Hour × Day-of-week heatmap
matches by hour & weekday🏆Top matched songs
📁Top Album / Folder
▦Channel report cards
📜Airplay / compliance log
| Time | Channel | Program | Timing | Total duration | Type | Song | Album / Folder | Confidence | Match start (s) | Match end (s) |
|---|---|---|---|---|---|---|---|---|---|---|
| Generate a report to see airplay log. | ||||||||||
About AUDIOBoxx
Enterprise audio fingerprinting & broadcast monitoring platform.
🔑License
Not ActivatedAUDIOBoxx
Audio Fingerprinting & Broadcast Monitoring Platform — Version 3.5.7 · Build May 2026
✨What's New in 3.5.7 — May 2026
Monitor & Identification
- 20 s / 20 s monitor cycle — back-to-back capture windows (set interval = capture for gap-free reports)
- Per-stream min confidence — threshold from Streams tab only (default UI 0.20)
- Coverage < 3 s → NO MATCH — short hits no longer count as matches
- Scalable identify queue — global cap = active streams ×
MaxParallelIdentificationsPerStream - In-memory library query for live monitor + 4 GB RocksDB block cache option
- Terminal dashboard — live channel table, queue depth, fingerprint library track count
Reporting & Exports
- Airplay CSV / Excel / PDF — consolidated (default) or raw per-detection
- Live log Excel — export filtered monitor history from Streams tab
- Duration (HH:MM:SS) column — wall-clock span with corrected consolidated end times
- Track match start / end in-source offsets; Play Kind + metadata catalogue columns
- Excel-overflow split — exports over 1 M rows ship as PART1 / PART2 / PART3 in a ZIP
- Reports Duration column — HH:MM:SS total airtime per consolidated row
Workflow & UX
- Glass UI cues — breathing borders on Play Details, license banner, live/stop controls
- Streams Duration — HH:MM:SS = checks × capture length while monitoring
- JioTV port 5001 — auto netsh reserve (admin) + fallback ports if Hyper-V blocks
- Play Details classifier — Trailer / Full Song / Promo / Jingle / Snippet / custom
- Filtered live-log delete + Export Excel on Live log toolbar
- Auto-refresh Report every 60 s; Quick Range presets (Today / 7d / 30d / All)
📜End User License Agreement
🪪 License Summary
AUDIOBoxx Audio Fingerprinting System — EULA
1. Grant of License. Kraft Junction ("Licensor") grants the Licensee a non-exclusive, non-transferable, revocable license to use AUDIOBoxx ("Software") under license key —, subject to the terms herein. This subscription license permits installation on a single machine and allows concurrent monitoring of up to 1 audio stream(s).
2. Restrictions. Licensee shall not: (a) copy, modify, or distribute the Software; (b) reverse engineer, decompile, or disassemble the Software; (c) sublicense, rent, lease, or transfer the license to any third party; (d) use the Software for unlawful purposes; (e) remove or modify proprietary notices; (f) exceed the permitted concurrent stream limit of 1 stream(s) as defined by the license tier.
3. Ownership. All rights, title, and interest in the Software remain with Kraft Junction. The Software is protected by copyright laws and international treaties.
4. Data Collection. The Software may transmit license validation data (license key, machine identifier / HWID) to Kraft Junction servers for activation and periodic verification. No audio content or personal data is transmitted.
5. Term & Termination. This license is effective until the expiration date associated with the license key or until terminated by either party. Kraft Junction may revoke the license if terms are violated. Upon termination, Licensee must cease all use and destroy all copies.
6. Stream & Usage Limits. The license entitles the Licensee to monitor, record, and fingerprint up to 1 concurrent audio stream(s). Exceeding this limit will result in the Software rejecting additional streams until existing streams are released.
7. Warranty Disclaimer. THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. KRAFT JUNCTION LLP DISCLAIMS ALL WARRANTIES INCLUDING MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
8. Limitation of Liability. IN NO EVENT SHALL KRAFT JUNCTION LLP BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING FROM USE OF THE SOFTWARE.
9. Governing Law. This agreement shall be governed by the laws of the jurisdiction where Kraft Junction is registered.
📘Usage Guidelines
Permitted Use
- Audio content identification and monitoring for broadcast compliance
- Ad detection and verification on licensed broadcast channels
- Internal music library management and cataloguing
- Broadcast monitoring for regulatory compliance reporting
- Live stream recording and archival for review
- Detection-to-recording mapping for evidence retrieval
Prohibited Use
- Unauthorized surveillance or monitoring of private communications
- Copyright infringement or circumvention of digital rights
- Deployment in jurisdictions where audio monitoring is prohibited
- Sharing access credentials or license keys with unauthorized parties
- Creating derivative fingerprint databases for resale
Best Practices
- Fingerprint reference audio at original quality (WAV preferred)
- Default monitor cycle: 20 s interval, 20 s capture (keep equal for continuous timeline)
- Set min confidence per stream on the Streams tab before starting monitor
- Large libraries: enable RocksDB block cache and allow up to
IdentifyTimeoutSeconds(e.g. 360) - Back up
data/(fingerprint .db +monitor_logSQLite) regularly - Use Mapping + Play Details for evidence clips; Reports for compliance exports
⚙Technical Rider
System Requirements
Technology Stack
Recording & Clips
- Recording formats: MP3 (audio streams) · MP4/fMP4 (video streams) — ffmpeg segment mode
- Folder layout:
recordings/{channel}/{dd-MM-yyyy}/{Channel DD-MM-YYYY HH-MM-SS}.ext - Clip download (View Results): MP3 for audio streams · MP4 (H.264 + AAC) for video streams
- Auto-retry on stream drops, HLS-aware reconnect flags
💻Runtime
🏢Developer
✉Support & Contact
✨Platform Capabilities
- Drag-drop fingerprinting for individual WAV files
- Recursive folder scanning, parallel per-core workers
- Bulk scan survives browser refresh (server-side job manager)
- Offline identification with Top-N matches and CSV export
- Live monitor for HLS / HTTP / radio streams (in-memory PCM pipe)
- Continuous recording with time-segmented playback
- Detection-to-segment mapping with inline player
- Play Details classifier (Trailer / Full Song / Promo / Jingle / Snippet / custom)
- Clip download — MP3 for audio streams, MP4 for video
- Analytics: KPIs, airtime totals, top songs / channels / programs / play-kind
- Branded PDF report with charts + airplay log (consolidated or raw)
- Airplay CSV / Excel (consolidated + raw); Live log Excel export
- Report KPIs from consolidated airtime (HH:MM:SS)
- Live log persisted to monitor_log; filtered delete + Excel
- JioTV Go with port failover · EPG-aware consolidation
- License limits · terminal dashboard · system telemetry
🔗Key Endpoints & Configuration
REST Endpoints
POST /api/fingerprintPOST /api/fingerprint-folderGET /api/fingerprint-folder/statusGET /api/fingerprint-folder/streamPOST /api/fingerprint-folder/cancelPOST /api/identifyGET /api/libraryGET /api/monitor/streamGET /api/monitor/logs(500 default, max 5000; newest window whensinceIdomitted)GET /api/monitor/logs.xlsx(stream/type filters; raw by default)DELETE /api/monitor/logs(filtered)POST /api/monitor/logs/{id}/playkindGET /api/recording/statusGET /api/recording/clip/{...}GET /api/mappingGET /api/reportGET /api/report/airplay.csv(?consolidate=falseraw)GET /api/report/airplay.xlsxGET /api/report/airplay-durationGET /api/system/stats
Configuration Keys
Monitor:DefaultIntervalSeconds(20) /DefaultCaptureSeconds(20)Monitor:IdentifyTimeoutSeconds·BlockCacheBytesMonitor:MaxParallelIdentificationsPerStreamDashboard:RefreshSeconds·Recording:DirectoryJioTv:Port·JioTv:AutoReservePort·JioTv:ExePathStorage:Backend·Storage:DatabaseFile
Credits
- AUDIOBoxx (MIT)
- Chart.js (MIT)
- Tailwind CSS (MIT)
- jsPDF & jspdf-autotable (MIT)
- ffmpeg (LGPL)
- Microsoft.Data.Sqlite (MIT)