lvthn-codec 1.0.0__tar.gz

lvthn_codec-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FreshLend Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lvthn_codec-1.0.0/PATENTS

@@ -0,0 +1,30 @@
+LVTHN-CODEC — Patent Notice
+
+This software is released under the MIT License.
+
+The author is not aware of any patents that cover the algorithms implemented 
+here. The core techniques used are:
+
+Audio:
+  - MDCT / IMDCT with sine window (Princen-Bradley, 1986–87; expired)
+  - TDAC (Time-Domain Aliasing Cancellation, 1986; expired)
+  - Mid/Side stereo coding (Blumlein, 1930s; classic technique)
+  - Bark-scale band partitioning (Barkhausen 1960s, public domain)
+  - Absolute Threshold of Hearing (Terhardt 1979, public domain)
+  - Rice coding (Golomb 1966, Rice 1979; expired)
+  - Adaptive per-band quantization (basic idea, expired)
+
+Images:
+  - Oklab color space (Björn Ottosson, 2020; public domain)
+  - Block DCT (discrete cosine transform; expired)
+  - Run-Length Encoding (RLE; public domain)
+  - Zstandard compression (Yann Collet, 2015; BSD/GPLv2, patent-free)
+
+This is NOT a legal guarantee of patent non-infringement. No warranty is
+provided. If you distribute binaries based on this code commercially,
+consult a patent attorney about your jurisdiction.
+
+The author has intentionally avoided:
+  - Full psychoacoustic masking models identical to MP3/AAC
+  - SBR / PS / HE-AAC extensions
+  - Any code from FFmpeg, LAME, Opus, Vorbis, or other existing codecs

lvthn_codec-1.0.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: lvthn-codec
+Version: 1.0.0
+Summary: Universal LVTHN media codec: audio (MDCT + Bark + Psy) and images (Oklab + DCT + zstd)
+Author: FreshGame
+Maintainer: FreshLend Studio
+License-Expression: MIT
+Keywords: audio,codec,image,compression,mdct,dct,psychoacoustics,oklab,lvn,patent-free
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: PATENTS
+Requires-Dist: numpy==2.2.6
+Requires-Dist: scipy==1.15.3
+Requires-Dist: numba==0.68.1
+Requires-Dist: zstandard==0.25.0
+Requires-Dist: Pillow==12.3.0
+Dynamic: license-file
+
+# LVTHN-CODEC [RU](README.md) | **EN**
+
+A modular, patent-clean, and highly efficient media codec written in Python. 
+It uses a universal container (`.lvn`) that supports both **Audio** and **Images**, applying modern psychoacoustic and psychovisual models to outperform industry standards like MP3 and PNG.
+
+## Features
+
+*   **Universal container (`.lvn`):** One format for everything. The decoder automatically detects what is inside.
+*   **Audio codec:** MDCT + Mid/Side stereo + Bark scale bands + Absolute Threshold of Hearing (ATH) + Adaptive quantization.
+*   **Image codec:** Oklab color space + Block DCT + RLE + Zstandard.
+*   **Performance:** 
+    *   Audio outperforms MP3 in size by **~15%** at the same perceived quality.
+    *   Images outperform PNG in size by **6 to 7 times** with visually indistinguishable quality.
+    *   High speed: Audio RTF < 0.02, 4K image decoding takes about 3 seconds.
+
+## Installation
+
+Ensure you have Python 3.10+ installed.
+
+```bash
+pip install numpy scipy numba zstandard Pillow sounddevice PySide6
+```
+*(Note: For `converter.py` to work with formats like MP3 or JPG, you need to install `ffmpeg` and add it to the system PATH environment variable).*
+
+## Usage
+
+### 1. Codec CLI (`codec.py`)
+Direct encoding and decoding to and from the `.lvn` format.
+```bash
+# Audio
+python codec.py encode track.wav track.lvn compact
+python codec.py decode track.lvn out.wav
+
+# Images
+python codec.py encode-img image.png image.lvn fast
+python codec.py decode-img image.lvn out.png
+
+# File info
+python codec.py info track.lvn
+```
+
+### 2. Converter (`converter.py`)
+Converts any supported format (via ffmpeg) to `.lvn` and back.
+```bash
+python converter.py to-lvn track.mp3 track.lvn --profile default
+python converter.py from-lvn track.lvn track_out.mp3 --bitrate 192k
+```
+
+### 3. Player (`player.py`)
+Modern GUI player and image viewer based on PySide6.
+```bash
+python player.py track.lvn
+python player.py image.lvn
+```
+
+### 4. Benchmark (`benchmark.py`)
+Testing speed and compression ratio on your files.
+```bash
+python benchmark.py --audio audio.wav --image image.png --image-profiles fast max
+```
+
+## Profiles
+
+### Audio Profiles
+| Profile | Description | SNR | Best for |
+|---|---|---|---|
+| `compact` | Maximum compression | 20.0 | Everyday listening, saving space |
+| `default` | Balanced | 24.0 | High-quality music |
+| `speech` | Voice optimized | 20.0 | Podcasts, audiobooks |
+| `detail` | Preserves quiet details | 24.0 | Lo-Fi, acoustic, vinyl |
+| `master` | Archival quality | 30.0 | Mastering, studio archives |
+
+### Image Profiles
+| Profile | Quality | Zstd Level | Best for |
+|---|---|---|---|
+| `fast` | 85 | 1 | Quick preview, game textures |
+| `default` | 92 | 12 | Web images, everyday use |
+| `max` | 98 | 19 | Archiving, professional photography |
+
+## Benchmarks
+
+### Audio (179 sec track)
+| File | Profile | Bitrate | SNR | Enc RTF | Dec RTF | Compression |
+|---|---|---|---|---|---|---|
+| acoustic.wav | compact | 113 kbps | 27.5 dB | 0.022 | 0.009 | 13.5x |
+| acoustic.wav | master | 225 kbps | 40.8 dB | 0.020 | 0.010 | 6.8x |
+
+### Images (4K 8.29 MP)
+| File | Profile | PSNR | Enc Time | Dec Time | Compression |
+|---|---|---|---|---|---|
+| 4k_image.png | fast | 42.1 dB | 4.10s | 3.14s | 7.1x |
+| 4k_image.png | max | 48.3 dB | 29.32s | 3.14s | 4.3x |
+
+*(PSNR > 40 dB is considered visually indistinguishable from the original. RTF < 1.0 means faster than real time).*
+
+## Architecture
+
+*   `codec.py` - Main CLI and API.
+*   `core/container.py` - Universal LVTHN wrapper.
+*   `core/audio.py` - Audio math (MDCT, Bark, Psy).
+*   `core/image.py` - Image math (Oklab, DCT).
+*   `player.py` - GUI (PySide6).
+*   `converter.py` - FFmpeg wrapper.
+*   `benchmark.py` - Performance testing tool.
+
+## License and Patents
+
+The project is distributed under the **MIT** license. 
+It is built exclusively on patent-free algorithms (MDCT, Oklab, DCT, Rice coding, Zstandard). See the `PATENTS` file for a detailed breakdown.

lvthn_codec-1.0.0/README.EN.md

@@ -0,0 +1,109 @@
+# LVTHN-CODEC [RU](README.md) | **EN**
+
+A modular, patent-clean, and highly efficient media codec written in Python. 
+It uses a universal container (`.lvn`) that supports both **Audio** and **Images**, applying modern psychoacoustic and psychovisual models to outperform industry standards like MP3 and PNG.
+
+## Features
+
+*   **Universal container (`.lvn`):** One format for everything. The decoder automatically detects what is inside.
+*   **Audio codec:** MDCT + Mid/Side stereo + Bark scale bands + Absolute Threshold of Hearing (ATH) + Adaptive quantization.
+*   **Image codec:** Oklab color space + Block DCT + RLE + Zstandard.
+*   **Performance:** 
+    *   Audio outperforms MP3 in size by **~15%** at the same perceived quality.
+    *   Images outperform PNG in size by **6 to 7 times** with visually indistinguishable quality.
+    *   High speed: Audio RTF < 0.02, 4K image decoding takes about 3 seconds.
+
+## Installation
+
+Ensure you have Python 3.10+ installed.
+
+```bash
+pip install numpy scipy numba zstandard Pillow sounddevice PySide6
+```
+*(Note: For `converter.py` to work with formats like MP3 or JPG, you need to install `ffmpeg` and add it to the system PATH environment variable).*
+
+## Usage
+
+### 1. Codec CLI (`codec.py`)
+Direct encoding and decoding to and from the `.lvn` format.
+```bash
+# Audio
+python codec.py encode track.wav track.lvn compact
+python codec.py decode track.lvn out.wav
+
+# Images
+python codec.py encode-img image.png image.lvn fast
+python codec.py decode-img image.lvn out.png
+
+# File info
+python codec.py info track.lvn
+```
+
+### 2. Converter (`converter.py`)
+Converts any supported format (via ffmpeg) to `.lvn` and back.
+```bash
+python converter.py to-lvn track.mp3 track.lvn --profile default
+python converter.py from-lvn track.lvn track_out.mp3 --bitrate 192k
+```
+
+### 3. Player (`player.py`)
+Modern GUI player and image viewer based on PySide6.
+```bash
+python player.py track.lvn
+python player.py image.lvn
+```
+
+### 4. Benchmark (`benchmark.py`)
+Testing speed and compression ratio on your files.
+```bash
+python benchmark.py --audio audio.wav --image image.png --image-profiles fast max
+```
+
+## Profiles
+
+### Audio Profiles
+| Profile | Description | SNR | Best for |
+|---|---|---|---|
+| `compact` | Maximum compression | 20.0 | Everyday listening, saving space |
+| `default` | Balanced | 24.0 | High-quality music |
+| `speech` | Voice optimized | 20.0 | Podcasts, audiobooks |
+| `detail` | Preserves quiet details | 24.0 | Lo-Fi, acoustic, vinyl |
+| `master` | Archival quality | 30.0 | Mastering, studio archives |
+
+### Image Profiles
+| Profile | Quality | Zstd Level | Best for |
+|---|---|---|---|
+| `fast` | 85 | 1 | Quick preview, game textures |
+| `default` | 92 | 12 | Web images, everyday use |
+| `max` | 98 | 19 | Archiving, professional photography |
+
+## Benchmarks
+
+### Audio (179 sec track)
+| File | Profile | Bitrate | SNR | Enc RTF | Dec RTF | Compression |
+|---|---|---|---|---|---|---|
+| acoustic.wav | compact | 113 kbps | 27.5 dB | 0.022 | 0.009 | 13.5x |
+| acoustic.wav | master | 225 kbps | 40.8 dB | 0.020 | 0.010 | 6.8x |
+
+### Images (4K 8.29 MP)
+| File | Profile | PSNR | Enc Time | Dec Time | Compression |
+|---|---|---|---|---|---|
+| 4k_image.png | fast | 42.1 dB | 4.10s | 3.14s | 7.1x |
+| 4k_image.png | max | 48.3 dB | 29.32s | 3.14s | 4.3x |
+
+*(PSNR > 40 dB is considered visually indistinguishable from the original. RTF < 1.0 means faster than real time).*
+
+## Architecture
+
+*   `codec.py` - Main CLI and API.
+*   `core/container.py` - Universal LVTHN wrapper.
+*   `core/audio.py` - Audio math (MDCT, Bark, Psy).
+*   `core/image.py` - Image math (Oklab, DCT).
+*   `player.py` - GUI (PySide6).
+*   `converter.py` - FFmpeg wrapper.
+*   `benchmark.py` - Performance testing tool.
+
+## License and Patents
+
+The project is distributed under the **MIT** license. 
+It is built exclusively on patent-free algorithms (MDCT, Oklab, DCT, Rice coding, Zstandard). See the `PATENTS` file for a detailed breakdown.

lvthn_codec-1.0.0/README.md

@@ -0,0 +1,109 @@
+# LVTHN-CODEC **RU** | [EN](README.EN.md)
+
+Модульный, патентно-чистый и высокоэффективный медиа-кодек, написанный на Python. 
+Он использует универсальный контейнер (`.lvn`), который поддерживает как **Аудио**, так и **Изображения**, применяя современные психоакустические и психовизуальные модели, чтобы превзойти промышленные стандарты вроде MP3 и PNG.
+
+## Особенности
+
+*   **Универсальный контейнер (`.lvn`):** Один формат для всего. Декодер автоматически определяет, что внутри.
+*   **Аудиокодек:** MDCT + Mid/Side стерео + полосы Барка + Абсолютный порог слышимости (ATH) + Адаптивное квантование.
+*   **Кодек изображений:** Цветовое пространство Oklab + Блочный DCT + RLE + Zstandard.
+*   **Производительность:** 
+    *   Аудио превосходит MP3 по размеру на **~15%** при том же воспринимаемом качестве.
+    *   Изображения превосходят PNG по размеру в **6-7 раз** при визуально неотличимом качестве.
+    *   Высокая скорость: RTF аудио < 0.02, декодирование 4К-картинки ~3 секунды.
+
+## Установка
+
+Убедитесь, что у вас установлен Python 3.10+.
+
+```bash
+pip install numpy scipy numba zstandard Pillow sounddevice PySide6
+```
+*(Примечание: Для работы `converter.py` с форматами вроде MP3 или JPG необходимо установить `ffmpeg` и добавить его в системную переменную PATH).*
+
+## Использование
+
+### 1. CLI кодек (`codec.py`)
+Прямое кодирование и декодирование в/из формата `.lvn`.
+```bash
+# Аудио
+python codec.py encode track.wav track.lvn compact
+python codec.py decode track.lvn out.wav
+
+# Изображения
+python codec.py encode-img image.png image.lvn fast
+python codec.py decode-img image.lvn out.png
+
+# Информация о файле
+python codec.py info track.lvn
+```
+
+### 2. Конвертер (`converter.py`)
+Конвертирует любые поддерживаемые форматы (через ffmpeg) в `.lvn` и обратно.
+```bash
+python converter.py to-lvn track.mp3 track.lvn --profile default
+python converter.py from-lvn track.lvn track_out.mp3 --bitrate 192k
+```
+
+### 3. Плеер (`player.py`)
+Современный GUI-плеер и просмотрщик картинок на PySide6.
+```bash
+python player.py track.lvn
+python player.py image.lvn
+```
+
+### 4. Бенчмарк (`benchmark.py`)
+Тестирование скорости и степени сжатия на ваших файлах.
+```bash
+python benchmark.py --audio audio.wav --image image.png --image-profiles fast max
+```
+
+## Профили
+
+### Профили аудио
+| Профиль | Описание | SNR | Для чего лучше всего |
+|---------|-------------|-----|----------|
+| `compact` | Максимальное сжатие | 20.0 | Повседневное прослушивание, экономия места |
+| `default` | Сбалансированный | 24.0 | Музыка высокого качества |
+| `speech` | Оптимизация под голос | 20.0 | Подкасты, аудиокниги |
+| `detail` | Сохраняет тихие детали | 24.0 | Lo-Fi, акустика, винил |
+| `master` | Архивное качество | 30.0 | Мастеринг, студийные архивы |
+
+### Профили изображений
+| Профиль | Качество | Уровень Zstd | Для чего лучше всего |
+|---------|---------|------------|----------|
+| `fast` | 85 | 1 | Быстрый просмотр, текстуры для игр |
+| `default` | 92 | 12 | Картинки для веба, повседневное использование |
+| `max` | 98 | 19 | Архивация, профессиональная фотография |
+
+## Бенчмарки
+
+### Аудио (трек 179 сек)
+| Файл | Профиль | Битрейт | SNR | Enc RTF | Dec RTF | Сжатие |
+|---|---|---|---|---|---|---|
+| acoustic.wav | compact | 113 kbps | 27.5 dB | 0.022 | 0.009 | 13.5x |
+| acoustic.wav | master | 225 kbps | 40.8 dB | 0.020 | 0.010 | 6.8x |
+
+### Изображения (4K 8.29 Мп)
+| Файл | Профиль | PSNR | Время Enc | Время Dec | Сжатие |
+|---|---|---|---|---|---|
+| 4k_image.png | fast | 42.1 dB | 4.10s | 3.14s | 7.1x |
+| 4k_image.png | max | 48.3 dB | 29.32s | 3.14s | 4.3x |
+
+*(PSNR > 40 dB считается визуально неотличимым от оригинала. RTF < 1.0 означает работу быстрее реального времени).*
+
+## Архитектура
+
+*   `codec.py` - Основной CLI и API.
+*   `core/container.py` - Универсальная обёртка LVTHN.
+*   `core/audio.py` - Математика аудио (MDCT, Bark, Psy).
+*   `core/image.py` - Математика изображений (Oklab, DCT).
+*   `player.py` - Графический интерфейс (PySide6).
+*   `converter.py` - Обёртка над FFmpeg.
+*   `benchmark.py` - Инструмент тестирования производительности.
+
+## Лицензия и Патенты
+
+Проект распространяется под лицензией **MIT**. 
+Он построен исключительно на алгоритмах, свободных от патентов (MDCT, Oklab, DCT, Rice coding, Zstandard). Подробный разбор смотрите в файле `PATENTS`.

lvthn_codec-1.0.0/codec.py

@@ -0,0 +1,149 @@
+import sys
+import time
+from pathlib import Path
+import numpy as np
+from scipy.io import wavfile
+
+from core import container, audio, image
+
+PROFILES = {
+    'default': {'delta': 0.18, 'snr': 24.0},
+    'compact': {'delta': 0.25, 'snr': 20.0},
+    'detail':  {'delta': 0.05, 'snr': 24.0},
+    'speech':  {'delta': 0.10, 'snr': 20.0},
+    'master':  {'delta': 0.03, 'snr': 30.0},
+}
+
+IMG_PROFILES = {
+    'fast':    {'quality': 85, 'level': 1},
+    'default': {'quality': 92, 'level': 12},
+    'max':     {'quality': 98, 'level': 19},
+}
+
+def encode_pcm(pcm, sr, ch, delta, target_snr_db):
+    payload = audio.encode_audio(pcm, sr, ch, delta, target_snr_db)
+    return container.wrap(container.MEDIA_AUDIO, payload)
+
+def decode_lvn(data):
+    media_type, payload = container.unwrap(data)
+    if media_type == container.MEDIA_AUDIO:
+        return audio.decode_audio(payload)
+    elif media_type == container.MEDIA_IMAGE:
+        return image.decode_image(payload)
+    else:
+        raise ValueError(f'Unsupported media_type: 0x{media_type:02x}')
+
+def decode_lvn_info(data):
+    media_type, payload = container.unwrap(data)
+    if media_type == container.MEDIA_AUDIO:
+        info = audio.get_audio_info(payload)
+        info['media_type'] = media_type
+        info['total'] = len(data)
+        return info
+    elif media_type == container.MEDIA_IMAGE:
+        info = image.get_image_info(payload)
+        info['media_type'] = media_type
+        info['total'] = len(data)
+        return info
+    return dict(media_type=media_type, total=len(data))
+
+def read_wav(path):
+    sr, d = wavfile.read(path)
+    if d.dtype == np.int16:   d = d.astype(np.float64) / 32768.0
+    elif d.dtype == np.int32: d = d.astype(np.float64) / 2147483648.0
+    elif d.dtype == np.uint8: d = (d.astype(np.float64) - 128.0) / 128.0
+    else:                     d = d.astype(np.float64)
+    if d.ndim == 1: d = d[:, None]
+    return d, sr
+
+def write_wav(path, pcm, sr):
+    wavfile.write(path, sr, np.clip(pcm * 32767, -32768, 32767).astype(np.int16))
+
+def read_image(path):
+    from PIL import Image
+    img = Image.open(path)
+    if img.mode == 'RGBA':
+        return np.array(img), 4
+    else:
+        return np.array(img.convert('RGB')), 3
+
+def write_image(path, pixels, channels):
+    from PIL import Image
+    img = Image.fromarray(pixels)
+    img.save(path)
+
+def main():
+    if len(sys.argv) < 2:
+        print('LVTHN-CODEC')
+        print('Commands: encode | decode | info | encode-img | decode-img | profiles')
+        sys.exit(1)
+    cmd, args = sys.argv[1], sys.argv[2:]
+
+    if cmd == 'encode':
+        if len(args) < 2: sys.exit('usage: encode in.wav out.lvn [profile|delta] [target_snr_db]')
+        pcm, sr = read_wav(args[0])
+        arg2 = args[2] if len(args) > 2 else 'default'
+        if arg2 in PROFILES:
+            delta = PROFILES[arg2]['delta']
+            tsnr = PROFILES[arg2]['snr']
+            print(f'[audio profile: {arg2}]  delta={delta}  snr={tsnr}')
+        else:
+            delta = float(arg2)
+            tsnr = float(args[3]) if len(args) > 3 else 24.0
+        
+        t0 = time.time()
+        data = encode_pcm(pcm, sr, pcm.shape[1], delta, target_snr_db=tsnr)
+        Path(args[1]).write_bytes(data)
+        print(f'OK {args[1]}  {len(data)} bytes  ({pcm.size * 2 / len(data):.2f}x vs PCM)  encode={time.time() - t0:.2f}s')
+
+    elif cmd == 'decode':
+        if len(args) < 2: sys.exit('usage: decode in.lvn out.wav')
+        pcm, sr, ch, n = decode_lvn(Path(args[0]).read_bytes())
+        write_wav(args[1], pcm, sr)
+        print(f'OK {args[1]}  {n} samples, {ch} ch, {sr} Hz')
+
+    elif cmd == 'encode-img':
+        if len(args) < 2: sys.exit('usage: encode-img in.png out.lvn [profile|quality] [level]')
+        pixels, ch = read_image(args[0])
+        arg2 = args[2] if len(args) > 2 else 'default'
+        if arg2 in IMG_PROFILES:
+            q = IMG_PROFILES[arg2]['quality']
+            lvl = IMG_PROFILES[arg2]['level']
+            print(f'[image profile: {arg2}]  quality={q}  level={lvl}')
+        else:
+            q = int(arg2)
+            lvl = int(args[3]) if len(args) > 3 else 19
+            
+        t0 = time.time()
+        payload = image.encode_image(pixels, pixels.shape[1], pixels.shape[0], ch, q, lvl)
+        data = container.wrap(container.MEDIA_IMAGE, payload)
+        Path(args[1]).write_bytes(data)
+        print(f'OK {args[1]}  {len(data)} bytes  encode={time.time() - t0:.2f}s')
+
+    elif cmd == 'decode-img':
+        if len(args) < 2: sys.exit('usage: decode-img in.lvn out.png')
+        mt, payload = container.unwrap(Path(args[0]).read_bytes())
+        if mt != container.MEDIA_IMAGE: sys.exit('Not an image')
+        pixels = image.decode_image(payload)
+        write_image(args[1], pixels, pixels.shape[2] if len(pixels.shape) > 2 else 1)
+        print(f'OK {args[1]}')
+
+    elif cmd == 'info':
+        if not args: sys.exit('usage: info file.lvn')
+        info = decode_lvn_info(Path(args[0]).read_bytes())
+        if info['media_type'] == container.MEDIA_AUDIO:
+            print(f"LVTHN v1  audio  {info['sr']} Hz  {info['ch']} ch  {info['n_samples'] / info['sr']:.2f}s  delta={info['delta']:.4f}")
+            print(f"  target_snr_db: {info['target_snr_db']:.1f}  use_ms: {info['use_ms']}  total: {info['total']}")
+        elif info['media_type'] == container.MEDIA_IMAGE:
+            print(f"LVTHN v1  image  {info['width']}x{info['height']}  alpha={info['has_alpha']}  quality={info['quality']:.0f}  total: {info['total']}")
+
+    elif cmd == 'profiles':
+        print('Audio profiles:')
+        for name, p in PROFILES.items():
+            print(f'  {name:10s}  delta={p["delta"]:<6}  snr={p["snr"]}')
+        print('Image profiles:')
+        for name, p in IMG_PROFILES.items():
+            print(f'  {name:10s}  quality={p["quality"]:<4}  level={p["level"]}')
+
+if __name__ == '__main__':
+    main()