Initial commit

Author: 0KepOnline

README.md

@@ -0,0 +1,29 @@
+# Spore EP1 Steganography Encoder/Decoder in Python
+
+This is an implementation of the steganography algorithm, which is used by Spore EP1 (Spore: Galactic Adventures) to store large amounts of additional data in .PNG files alongside thumbnails. In the vanilla EP1 expansion pack, this method is only used for scenarios (adventures), but every other asset type can be imported in this way.
+
+Both encoding and decoding are supported.
+
+### How to use
+You must use Python 3.10 or newer.
+
+Clone the repository and install the requirements:
+
+```bash
+git clone https://github.com/Spore-Community/Spore_EP1Stegano-Python.git
+cd Spore_EP1Stegano-Python
+pip install -r requirements.txt
+```
+
+Here are examples of usage in the terminal:
+
+|                            **Encode**                           |                      **Decode**                      |
+|:---------------------------------------------------------------:|:----------------------------------------------------:|
+| `python spore_ep1stegano.py encode C:\thumb.png C:\stegano.bin` | `python spore_ep1stegano.py decode C:\adventure.png` |
+
+There is also a list of additional arguments:
+
+|         **Encode**         |           **Decode**           |
+|:--------------------------:|:------------------------------:|
+| `--output_png_path *path*` | `--output_stegano_path *path*` |
+| `--no_zopfli`              | `--no_validation`              |

requirements.txt

@@ -0,0 +1,3 @@
+crcmod>=1.7
+pypng>=0.20220715.0
+zopfli>=0.2.3