BOTAN Satellite

The BOTAN satellite is an ultra-small satellite built by students at the Chiba Institute of Technology in Japan. It is equipped with a camera and amateur radio capabilities, and its mission is to photograph specific features on Earth, such as pumice rafts and aurora borealis.

🛰️ BOTAN Image Decoder

BOTAN Satellite Frame Decoder is a Python-based tool that reads raw image transmission frames from the BOTAN CubeSat and reconstructs them into a complete JPEG image.

The satellite transmits its image data as hex-encoded or binary frame packets, which are stored in a CSV file during signal reception. This program parses those frames, detects valid JPEG headers and end markers, and rebuilds the original image automatically.

Cam data format is given below,

🚀 Features

📄 Reads frame data from CSV file (hex or binary format)

🧩 Automatically detects JPEG start (FFD8) and end (FFD9) markers

🖼️ Reconstructs the full image from fragmented frames

🔍 Detects missing/corrupted frames and allows zero or neutral-fill recovery

🌈 Supports color correction to fix green-tinted or incomplete images

💾 Outputs recovered image as .jpg

🧰 Requirements

Python 3.8+

Libraries:

🧾 Example Usage

In terminal run this command:

python3 main.py

Output:

Enter Image Number (Eg:90) Output:

🖼️ Output Example

📚 License

This project is licensed under the MIT License — free for personal and research use.