themactep / thingino-firmware

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
 [code] 
Read [Building from sources][7] article for more info.
### Building in a Container
 [code] 
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://thingino.com/
[1]: https://github.com/themactep/thingino-firmware/wiki
[3]: https://discord.gg/xDmqS944zr
[4]: https://t.me/thingino
[5]: https://buildroot.org/downloads/manual/manual.html
[6]: https://nightly.buildroo