PyCriCodecsEx 0.0.1__cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

pycricodecsex-0.0.1.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: PyCriCodecsEx
+Version: 0.0.1
+Summary: Criware formats library for Python
+Home-page: https://github.com/mos9527/PyCriCodecsEx
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: usm
+Requires-Dist: ffmpeg-python; extra == "usm"
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-python
+Dynamic: summary
+
+# PyCriCodecsEx
+A continuation of @Youjose's work on Criware formats. Feautres are still in flux and subject to change. When in doubt, Refer to the [original repo](https://github.com/Youjose/PyCriCodecs) for more information.
+
+# Installation
+```bash
+pip install PyCriCodecsEx
+```
+
+For USM features, you need `ffmpeg` installed and available in your PATH. See also https://github.com/kkroening/ffmpeg-python?tab=readme-ov-file#installing-ffmpeg
+
+## Features
+If not otherwise mentioned, all features marked with [x] are considered working, and has been verified with official tools.
+
+### ACB Cue sheets (also AWB)
+- [x] Editing & Saving (Scripting APIs. Helper functions TODO. see examples in [Tests](https://github.com/mos9527/PyCriCodecsEx/tree/main/Tests))
+### USM Sofdec2 (Encode & Decode)
+#### Audio Stream
+For audio to be muxed in, you need a PCM WAV sample with NO metadata, which can be produced with e.g.:
+```bash
+ffmpeg -i input.mp3 -vn -c:a pcm_s16le -map_metadata -1 output.wav
+```
+Decoding and Encoded format can be the following:
+- [x] HCA
+- [x] ADX
+#### Video Stream
+**NOTE**: You definitely want to tweak these encode settings a bit.
+- [x] Sofdec Prime (MPEG1, from `.m1v` container)
+    - Prepare source file with: `ffmpeg -i <input_file> -c:v mpeg1video -an <output_file>.m1v`
+- [x] H264 (from `.h264` raw container)
+    - Prepare source file with: `ffmpeg -i <input_file> -c:v libx264 -an <output_file>.h264`
+- [x] VP9 (from `.ivf` container)
+    - Prepare source file with: `ffmpeg -i <input_file> -c:v libvpx -an <output_file>.ivf`
+### HCA Audio Codec
+- [x] Decoding (up to version 3.0)
+- [x] Encoding (up to version 3.0)
+### ADX Audio Codec
+- [x] Decoding
+- [x] Encoding
+### CPK
+- [x] Unpacking
+- [x] Packing
+
+## Roadmap
+- [ ] ACB Extraction (Massive TODO. see also https://github.com/mos9527/PyCriCodecsEx/blob/main/Research/ACBSchema.py)
+- [ ] Interface for encode tasks (CLI then maybe GUI?)
+- [ ] Documentation
+- [ ] C/C++ port + FFI
+## Currently Known Bugs
+- USM seeking does not work. Though most games don't use it anyways.
+- Not important, and might not fix: ADX encoding and decoding at higher bitdepths (11-15) adds popping noise.
+- Some CPK's that has the same filename for every file in the entry will overwrite each other.
+- Probably many more I am unaware of, report if you find any.
+
+# Credits
+- https://github.com/Youjose/PyCriCodecs
+- https://github.com/Mikewando/PyCriCodecs ([PR#1 on USM](https://github.com/mos9527/PyCriCodecsEx/pull/1))
+- https://github.com/donmai-me/WannaCRI
+- https://github.com/vgmstream/vgmstream
+- https://github.com/K0lb3/UnityPy (For CI script)

pycricodecsex-0.0.1.dist-info/RECORD

@@ -0,0 +1,15 @@
+CriCodecsEx.cpython-310-x86_64-linux-gnu.so,sha256=tcXltf6wyi6553A-mJqgJwJgxNjroKVpOuEe4Mzwdzw,371912
+PyCriCodecsEx/cpk.py,sha256=bSbEZFUI7SfJlVgPWLtzrUpHBIbEOzoGc_D0DyqjdBI,36961
+PyCriCodecsEx/hca.py,sha256=4OE0YQDox5PwKuzu8ekWmj8LqKsWbSQJaTFAaqSlxg4,13890
+PyCriCodecsEx/utf.py,sha256=QDbU0odoDvlLWVKgWQm_P3IM-MmH56ft__1PUVhyj6I,27552
+PyCriCodecsEx/adx.py,sha256=dKv1HcBoe4Wkfot4Y2bfViBV2wJe1rrTzM325VA6RKk,762
+PyCriCodecsEx/awb.py,sha256=nl9manXuPU4pF_Rr2z36ERVJ2PFyXiMnIzkSGxhtdzE,5507
+PyCriCodecsEx/chunk.py,sha256=O_ibqWMnIGGiItMykwgIOoAddljRktzCquz8bEBfu80,2430
+PyCriCodecsEx/acb.py,sha256=LYRp3buMC-JCyDdzCD90HcirVEjZk9V8ZiYIN0p6RlQ,2606
+PyCriCodecsEx/usm.py,sha256=acEFVev9G5DYuWz9Um0U7gm7zi7E3VUJd9B4xoElTx4,44950
+PyCriCodecsEx/__init__.py,sha256=sXLh7g3KC4QCFxcZGBTpG2scR7hmmBsMjq6LqRptkRg,22
+pycricodecsex-0.0.1.dist-info/RECORD,,
+pycricodecsex-0.0.1.dist-info/METADATA,sha256=SDTfklRPINDNe2zC6yf3L2rHDctNGNdMtcF6qo8Ddqo,3243
+pycricodecsex-0.0.1.dist-info/top_level.txt,sha256=mSrrEse9hT0s6nl-sWAQWAhNRuZ6jo98pbFoN3L2MXk,26
+pycricodecsex-0.0.1.dist-info/WHEEL,sha256=DTnKjM5OInJxWADod3iQyWxWcdG-eRwxzGww236swpY,151
+pycricodecsex-0.0.1.dist-info/licenses/LICENSE,sha256=GyZb4dzF2tM3LU5I_tJXpHtUDz8297zeUuCJ5qz8io0,1063

pycricodecsex-0.0.1.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp310-cp310-manylinux_2_17_x86_64
+Tag: cp310-cp310-manylinux2014_x86_64
+

pycricodecsex-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 mos9527
+
+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.

pycricodecsex-0.0.1.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+CriCodecsEx
+PyCriCodecsEx