AUDIOBoxx — Audio Fingerprinting Studio

# AUDIOBoxx

Verifying license…

License Key

This key is bound to another machine — transfer it here (the other machine will be deactivated).

Hardware ID: —

# AUDIOBoxx

Checking LAN access…

Username Password

Your role controls which tabs you see (data entry = Results tab only).

### LAN sign in

Sign in with your LAN account. Your role controls which tabs and actions are available (analysts can classify play kind; supervisors can export reports).

Loading fingerprint library… Preparing in-memory index. Fingerprint & Identify will be enabled when ready.

## System Overview

Live dashboard aggregating library, monitoring, recording and system-health metrics.

♪
Tracks
0
∞
Sub-fingerprints
0
◉
Active monitors
0
⌕
Total checks (24h)
0
✓
Airtime (24h)
00:00:00
%
Match rate (24h)
0%
⚡
CPU
0%
◰
RAM
0%
⚙
App memory
—
◱
Disk free
—
⧗
Uptime
—
●
Active recordings
0
◎
Avg confidence (24h)
—
♪
Unique matched (24h)
0
◱
Recording folder
—
⇌
Stream links
0
⇩
Backed up files
0
⎗
Backup size
—

### 💡Capacity suggestions

—
Streams (license)
—
—
Monitoring
—
—
Recording
—
—

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

No matches yet.

### ℹEnvironment

Machine—
OS—
.NET—
Processors—
Server started—
Threads—

### ⎗Backup Recordings

Destination path
Channel filter
Older than (days)
Delete source files after successful copy

### ⟳Backup History

Files moved
0
Total size
0 B
No backups yet.

### ▦Track metadata catalogue

Not loaded

Upload 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: …`.

Metadata file (.xlsx or .csv)
File—
Rows0
Title column—
Album / Folder column—
Extra columns—

### 📡 JioTV-Go —

URL—
Port (effective)—
Binary—
Last exit—
Updating…

###
🔓 LAN access —

LAN access On
Your IP—
Mode—
Share with LAN—
Public tabs—
Signed in—
Note—
Break-glass credentials Legacy single admin password (full access)
Username New password
LAN users

Role-based LAN accounts. Data entry = Results tab only (play kind / EPG). Analyst+ adds Overview, Report, Recording, About.

Username Password Display name Role

Username | Display | Role | Enabled |
--- | --- | --- | --- | ---

Recent audit log

### ◆Recent Matches

Top 10
No recent matches.

### 💾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.

Backend

Applies the new backend selection.

### 🗄️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.

Active library
Create new library

## Add track to reference library

Upload a WAV file. AUDIOBoxx computes acoustic hashes and stores them locally.

Drop audio file here or click to browse
Track ID Title Album / folder
Chunk file & store one track per chunk Chunk length (seconds) Chunk overlap (seconds)

## 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.

Folder path
Audio formats —
ID prefix (optional) Re-fingerprint tracks that already exist
Chunk each file & store one track per chunk Chunk length (seconds) Chunk overlap (seconds)

## Identify unknown audio

Upload a short clip to match against the reference library.

Drop audio file here or click to browse
Fingerprint library
Chunk file & identify each chunk Chunk length (seconds) Chunk overlap (seconds)

## 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.

Folder path
Recent scans
Audio formats —
Top N matches per file Min confidence Threshold votes Processing power
Fingerprint library
Chunk each file (segment-by-segment report; leave off for faster whole-file identify) Chunk length (seconds) Chunk overlap (seconds)
Offline: …
0%

### 📜Identify report

Time | Source file | Chunk (HH:MM:SS) | Total duration | Type | Play kind | Song | Album / Folder | Confidence | Match start (HH:MM:SS) | Match end (HH:MM:SS) | Plays
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
Run a folder scan to see the report.

## 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`).

0active
0matches
0no-match
0errors
○live feed
JioTV Go server
Embedded Indian-TV channel gateway. When running, you can add streams with URLs like `http://127.0.0.1:5001/live/<channelId>.m3u8`.
unknown
Open UI

### Live log

Filter stream
Type

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

Stream
Date
No recordings yet.

## 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

AUDIOBoxx
Recording player
—
MATCH
0:00
0:00
Select an event to start playback.
Play kind
EPG program
Set play kind and EPG program for this event. Values are saved to the database and appear in CSV, Excel, and PDF reports.
Edit dropdown options

Stored in your browser only.

### ⧗Day timeline

No events for this date.
match no-match error now playing

### ≡Detection events

No data. Pick a stream and date.

## 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.

⏱
Total duration
00:00:00
✓
Matches
0
count
00:00:00
⏱ airtime
⨯
No match
0
count
00:00:00
⏱ airtime
%
Match rate
0%
◎
Avg confidence
0%
♪
Unique songs
0
⌀
Avg matches / day
0
⚠
Error rate
0%
⇅
24h change
—
◉
Active channels
0
⧗
Peak hour
—
📅
Peak day
—
▦
Busiest channel
—
★
Best day
—
☰
Weekday share
—
☼
Weekend share
—
☾
Quiet hours (0‑match)
0
≡
Longest dry streak
0d
⌀
Avg match length
00:00:00
⤒
Longest match
00:00:00
🏷
Top play kind
—
📺
Top program
—
🗣
Top language
—
🌐
Languages tracked
0

### 📈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)

Generate a report to see the top 10.

### ⚖Channel match-rate comparison

🎯Channel profile (rate · confidence · volume)

### ⤴Hourly match-rate %

### ◎Channel average confidence

### ◒Weekday vs Weekend

### ◀Last 7 days trend

### 🔥Hour × Day-of-week heatmap

matches by hour & weekday
Generate a report to see the heatmap.

### 🏆Top matched songs

Generate a report to see top songs.

### 📁Top Album / Folder

Generate a report to see top albums / folders.

### ▦Channel report cards

Generate a report to see channel stats.

### 📜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 Activated
License Key

Organization—
License Key —
Type—
Issued—
Expires—
Days Left—
Streams Allowed—
Offline Identify—
Machine—

### AUDIOBoxx

Audio Fingerprinting & Broadcast Monitoring Platform — Version 3.5.7 · Build May 2026

.NET 8 ASP.NET Core Chart.js ffmpeg RocksDB SQLite Commercial

### ✨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

Licensee—
License Key—
License Type—
Issued—
Expires—
Streams—

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_log` SQLite) regularly
- Use Mapping + Play Details for evidence clips; Reports for compliance exports

### ⚙Technical Rider

System Requirements

OSWindows 10+ (x64) / Linux / macOS
CPU4+ cores recommended
RAM8 GB min, 16 GB recommended
StorageSSD, 50 GB+ free
Runtime.NET 8 (bundled)
FFmpegRequired on PATH

Technology Stack

BackendASP.NET Core 8 Minimal API
FrontendVanilla JS · Tailwind · Chart.js
Fingerprint indexRocksDB (primary) + SQLite mirror
Monitor logSQLite (durable, persisted live feed)
Audio engineSoundFingerprinting · ffmpeg (piped PCM)
IdentificationRocksDB + in-memory query · configurable timeout
ReportingjsPDF · CSV/Excel/PDF airplay · raw + consolidated
TV StreamsJioTV Go (port 5001, auto-fallback + netsh reserve)
ConsoleLive monitor dashboard (3 s refresh)

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

Machine—
OS—
.NET—
Processors—
License streams (used/max)—
Offline identify (used/max hours)—
Configured streams—
Recording storage used—
Recording folder—
Disk free (data drive)—
Server started—
Uptime—

### 🏢Developer

CompanyKraft Junction
Website kraftjunction.com ↗
IndustryMedia Technology & Broadcast Solutions
HeadquartersIndia

### ✉Support & Contact

Technical Supportsupport@kraftjunction.com
Sales & Licensingsales@kraftjunction.com
Support HoursMon–Sat · 10 AM – 7 PM IST

### ✨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/fingerprint`
- `POST /api/fingerprint-folder`
- `GET /api/fingerprint-folder/status`
- `GET /api/fingerprint-folder/stream`
- `POST /api/fingerprint-folder/cancel`
- `POST /api/identify`
- `GET /api/library`
- `GET /api/monitor/stream`
- `GET /api/monitor/logs` (500 default, max 5000; newest window when `sinceId` omitted)
- `GET /api/monitor/logs.xlsx` (stream/type filters; raw by default)
- `DELETE /api/monitor/logs` (filtered)
- `POST /api/monitor/logs/{id}/playkind`
- `GET /api/recording/status`
- `GET /api/recording/clip/{...}`
- `GET /api/mapping`
- `GET /api/report`
- `GET /api/report/airplay.csv` (`?consolidate=false` raw)
- `GET /api/report/airplay.xlsx`
- `GET /api/report/airplay-duration`
- `GET /api/system/stats`

Configuration Keys

- `Monitor:DefaultIntervalSeconds` (20) / `DefaultCaptureSeconds` (20)
- `Monitor:IdentifyTimeoutSeconds` · `BlockCacheBytes`
- `Monitor:MaxParallelIdentificationsPerStream`
- `Dashboard:RefreshSeconds` · `Recording:Directory`
- `JioTv:Port` · `JioTv:AutoReservePort` · `JioTv:ExePath`
- `Storage:Backend` · `Storage:DatabaseFile`

Credits

- AUDIOBoxx (MIT)
- Chart.js (MIT)
- Tailwind CSS (MIT)
- jsPDF & jspdf-autotable (MIT)
- ffmpeg (LGPL)
- Microsoft.Data.Sqlite (MIT)

🔔

### License Server