README

Thingino
--------

Thingino (_/θinˈdʒiːno/_, _thin-jee-no_) is an open-source firmware for Ingenic SoC IP cameras.

![Thingino Web UI][10]

 Supported Hardware

Please find the full list of supported cameras
in a separate document. Visit [our website][0] for an illustrated version of
the list.

---

 Thingino Repository Branches Explaned

We've split the Thingino repository into two branches: stable and master, to better manage development and provide reliable releases for users.

Ciao Branch

Provides a reliable, tested version of Thingino for general use. It includes carefully selected, stable changes. It uses the original ONVIF server and Prudynt with libconfig.
The ciao branch will receive critical fixes. New features will only be added once they are thoroughly tested and mature in the master branch.

For users who want a dependable version of Thingino without needing to build or contribute to development.

Master Branch

The development hub for new features and experimental changes. Includes advanced features, and uses the new [raptor][13] streamer. These are still in development and may not be stable.

Only for developers and contributors who can build the project themselves and actively participate in improving the code.

 [!WARNING]
 The master branch uses a highly experimental maineline U-Boot.
 - Having access to the UART port on the camera and unbricking skills is highly recommended when building images from the master branch.

This structure allows us to maintain a reliable version (stable) for most users while continuing to innovate and test new features (master). Critical fixes and matured features from master will be gradually integrated into stable for broader use.

 [!NOTE]
 If you’re not contributing to development, we recommend sticking with the stable branch.

Thank you for using Thingino! For questions or contributions, please join our Discord community or check the GitHub issues page.

 Building


git clone --recurse-submodules https://github.com/themactep/thingino-firmware
cd thingino-firmware
make update
make


Read [Building from sources][7] article for more info.

 Building in a Container


git clone --recurse-submodules https://github.com/themactep/thingino-firmware
cd thingino-firmware
./build-container.sh


The build uses a prebuilt image from
ghcr.io/themactep/thingino-builder-image,
pulled automatically on first run. Requires Podman or Docker.

Read Building in a container for more info.

 Documentation

- Firmware Image Structure - Partition layout and image assembly
- Firmware Dumping - How to backup existing firmware
- Camera Recovery - Recovering from failed updates
- Local Build Settings - Layered user-specific settings from THINGINO_USER_DIR/common, per camera, and per device IP

 Resources

- [Project Website][0]
- [Project Wiki][1]
- Buildroot Manual [HTML][5] [PDF][6]
- [Discord channel][3]
- [Telegram group][4]

 GitHub CI Status

[![toolchain-x86_64][11]][8]
[![firmware-stable][12]][9]

[0]: https://thing

Top issues

Discussions

Latest release

Changes in this release:
- 5a2631c dfu: bump to 2.0.1
- 7d4a2a1 cameras: move cinnado d1 t32lq to experimental
- 90e7f1a linux: build only uImage.lzma for T32 4.4.94 kernels  Backport 727f16228. uImage is a symlink to its first prerequisite, so uImage.lzma is the only image ever shipped. Building the lzo, zrt and jzlzma variants just discards the result, and jzlzma runs the prebuilt x86-64 helpers under scripts/ingenic_hardlzma/, which fail with "Exec format error" on aarch64 build hosts.  Signed-off-by: Paul Philippov 
- d6dded4 add divinus streamer package