Thingino

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

Supported Hardware

Please find the full list of supported cameras in a separate document. Visit our website 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 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 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
• Project Wiki
• Buildroot Manual HTML PDF
• Discord channel
• Telegram group

GitHub CI Status