ClimbSnail/HoloCubic_AIO logo

ClimbSnail/HoloCubic_AIO

Free

HoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等

FreeFree tier
Inputs: image, video, textOutputs: image, video, text
Type
Open Source

About ClimbSnail/HoloCubic_AIO

HoloCubic_AIO is an open-source, all-in-one firmware for the HoloCubic hardware (originally designed by ZhiHuiJun). Built on the ESP32-ARDUINO platform, it integrates multiple applications into a single device including weather clock, photo album, video player, desktop screen projection, web server, Bilibili fan display, and more. The firmware features a modular, low-coupling architecture that allows easy addition of new apps. It provides a web-based configuration interface for network setup and settings, supports file upload to SD card via browser, and offers a dedicated host computer tool (CubicAIO_Tool) for firmware flashing without needing an IDE. The project has over 20,000 lines of firmware code and 4,000 lines of host computer code, and welcomes community contributions via QQ groups.

Key Features

Aggregates multiple apps: weather clock, photo album, video player, desktop screen projection, web server, Bilibili fans, and more
Web-based configuration interface for network and settings (accessible via IP or http://holocubic)
Supports file upload to SD card through browser (no need to remove card)
Modular and low-coupling framework for easy app development
Boots without TF card, MPU6050, or WiFi (but some apps require them)
Provides open-source host computer tool (CubicAIO_Tool) for firmware flashing
Includes file manager via FTP for wireless SD card management
Gesture control (shake to switch apps, tilt to enter/exit)

Pros & Cons

Pros
  • Free and open source with permissive license
  • No IDE required for beginners – uses dedicated flashing tool
  • Rich set of built-in apps covering various needs
  • Active community with multiple QQ groups for support
  • Regular updates and new features added by contributors
  • Web interface makes configuration and file management easy
  • Modular design allows developers to add custom apps
Cons
  • Requires specific HoloCubic hardware (not a general-purpose tool)
  • Some features (photo album, video) need a TF card with FAT32 filesystem
  • WiFi only supports 2.4 GHz (not 5 GHz)
  • Gesture control depends on correctly functioning MPU6050 sensor
  • Initial setup may require calibration (keep device still for 3 seconds)
  • Documentation and community primarily in Chinese, though English README available

Best For

Personal weather clock and information displayDigital photo frame with automatic slideshowVideo player for short clips on a small screenDesktop screen projection for monitoring PC resourcesWeb server for configuration and file managementBilibili fan counter displayLearning and experimenting with ESP32 firmware development

FAQ

Does the firmware work without a TF card?
Yes, the firmware boots and basic apps (weather clock, web server) work without a TF card. However, apps that rely on external files such as photo album and video player require a TF card with the necessary folders and files.
How do I configure WiFi on the HoloCubic?
Use the Web Server app: after powering on, the device creates an AP named 'HoloCubic_AIO' (no password). Connect your computer to that WiFi, then open a browser and go to http://192.168.4.2 or http://holocubic to access the configuration page. There you can enter your WiFi credentials and adjust other settings.
Why does my device keep switching apps unintentionally?
The MPU6050 gyroscope/accelerometer needs proper initialization. On power-up, keep the device still (not in hand) for about 3 seconds until the RGB LED fully lights up. After that, gesture controls work normally. If the sensor is faulty, the device may continuously switch apps.
How can I flash the firmware without using Arduino IDE?
Download the CubicAIO_Tool.exe from the repository. Place the bootloader (bootloader_dio_40m.bin), partitions.bin, boot_app0.bin, and the latest HoloCubic_AIO_XXX.bin in the same folder as the tool. Run the tool, select the latest firmware file, and flash.
Can I add my own photos to the photo album?
Yes, either place .jpg or .bin files in the 'image/' folder on the TF card, or use the web interface (Web Server app) to upload images directly to the SD card. The firmware supports both JPEG and pre-converted binary formats.