# Decoding
manhuntribber decode JOURNO.RIB JOURNO.WAV
# Encoding
manhuntribber encode JOURNO.WAV JOURNO.RIBA WAV-file should be PCM encoded 16-bit stereo 22050/44100 Hz (or mono 44100 Hz in case of mono stream) in order to be encoded to RIB format. See "File types" section for the reference.
Project requires any modern C++20 compiler (gcc 10, clang 10, msvc 2019) and cmake.
cmake -B build
cmake --build buildThe file is a stream of samples encoded by a variation of the ADPCM IMA
algorithm (in FFMPEG this algorithm is identified as ADPCM_IMA_QT, but the
implementation differs in detail).
Stream may be mono (1 channel) or stereo (2 channels).
Each of the channels is in turn encoded in an interleave of 0x10000 bytes in
size into frames of 0x400 (for frequency 44100 Hz) or 0x200 (for frequency
22050 Hz) bytes in size. Thus, in one interleave there are up
to 64 channel frames, encoded by a variation of the ADPCM_IMA_QT algorithm.
The key difference from the original implementation is the storage of data for
encoder initialization: while ADPCM_IMA_QT uses packed storage of predicor
and step_index in a 16-bit value, in the modified algorithm predictor is
stored in the first and second bytes of the frame as 16-bit number
(little-endian), and step_index is in the third byte as an 8-bit number.
The structure is aligned to four bytes, leaving the fourth byte unused and
equal to zero.
If there is fewer data than the frame size at the end of the file, the remaining frame and interleave space remains filled with zeros.
There also exists complex files format mainly for music environment (like
ASYLUM_M.RIB). These files are divided into six tracks. First four tracks
based on awareness of NPC about player (0 is calm music, where player is
undetected; 4 is intense music, where player is being in fight). Last two
tracks are reserved and used for some environmental sounds (like moaning and
screams of electrocuted captive in ASYLUM level). If there is no use for such
sounds in level, these tracks are filled with random tracks (white noise and
raining sound).
Each track is recorded in turn in an interleave sequence. Thus, to read the fourth track, you need to read the fourth in the sequence of six interleaves.
| File name | Mono/stereo | Frequency |
|---|---|---|
audio/PC/EXECUTE/*/*.RIB |
mono | 44100 |
audio/PC/MUSIC/*/*_D.RIB, audio/PC/MUSIC/*/*_S.RIB, audio/PC/SCRIPTED/*/*.RIB, |
stereo | 44100 |
audio/PC/MUSIC/*/*_C.RIB, audio/PC/MUSIC/*/*_L.RIB, audio/PC/MUSIC/*/*_M.RIB¹ |
stereo | 22050 |
¹ audio/PC/MUSIC/*/*_M.RIB are complex files (-c flag).
Project licensed under LGPL-2.1 or later license. See LICENSE file for more info.
ManhuntRIBber
Copyright (C) 2025 Azamat H. Hackimov
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
Project uses CLI11 library under a 3-Clause BSD license. See CLI11.hpp for additional info.
Project uses music samples from
"Galway" Kevin MacLeod (incompetech.com) Licensed under Creative Commons: By Attribution 3.0 http://creativecommons.org/licenses/by/3.0/