Fzone Solo QR Code Tool

About the Fzone Solo Light

The Fzone Solo Nano LED Aquarium Light is a compact, high-performance LED light designed for planted aquariums, shrimp tanks, and Wabi-Kusa displays. It features full-spectrum WRGB lighting with 18 RGB LEDs and 18 White LEDs, allowing each color channel to be independently controlled.

The light offers three modes:

• Manual Mode: Direct brightness and color control
• Auto Mode: Simulates natural weather effects (cloudy, rainy, sunny days)
• Custom Mode: Program up to 24 time points per day to create personalized sunrise and sunset cycles, perfect for plant health and natural lighting rhythms

The Fzone Solo app (available for iOS and Android) connects via Bluetooth and allows you to design lighting schedules and share them via QR codes. However, creating and editing schedules directly in the app can be time-consuming, especially when you want to fine-tune multiple time points or share schedules with others.

Why Use This Tool?

This software makes it easy to:

• Design custom schedules - Create lighting schedules in a simple CSV format using any text editor or spreadsheet
• Edit existing schedules - Decode QR codes from the app, modify them, and generate new QR codes
• Share schedules - Export schedules as CSV files that can be easily shared, version-controlled, or backed up
• Batch operations - Work with multiple schedules programmatically
• Round-trip editing - Decode a QR code, modify the schedule, and generate a new QR code to import back into the app

Perfect for aquarium enthusiasts, planted tank hobbyists, or anyone who wants more control over their Fzone Solo lighting schedules than the app interface provides.

Using the Fzone Solo App

To import and export schedules using QR codes in the Fzone Solo app:

1. Access Import/Export: In the app's schedule screen (shown above), tap the "i" icon (or vertical bar) in the upper-right corner to open the import/export screen.

2. Export a Schedule:

   • Tap "Export" to generate a QR code of your current schedule
   • The QR code will be saved to your phone's image gallery
   • You can then transfer this image to your computer to decode it with this tool

3. Import a Schedule:

   • Tap "Reset" first to clear your current schedule (removes all time points)
   • Tap "Import" to scan a QR code
   • You can either take a picture of a QR code directly, or import a photo of a QR code from your gallery
   • The app will load the schedule from the QR code

This workflow allows you to:

• Export schedules from the app → Decode with this tool → Edit in CSV → Generate new QR code → Import back to app
• Share schedules with others by exchanging QR code images or CSV files
• Backup your schedules as CSV files for version control or safekeeping

Quick Start

Installation

pip install -e .

For QR code decoding, you'll also need OpenCV:

pip install opencv-python

Basic Usage

Decode a QR code from your Fzone Solo app:

fzone-solo-qr decode qr_code.png

Save decoded schedule as CSV:

fzone-solo-qr decode qr_code.png --csv > my_schedule.csv

Create a QR code from a CSV schedule:

fzone-solo-qr encode my_schedule.csv --out new_qr.png

Use the default schedule:

fzone-solo-qr encode --out default_qr.png

Pipe decode to encode (round-trip):

fzone-solo-qr decode qr.png --csv 2>/dev/null | fzone-solo-qr encode --out new_qr.png

CSV Schedule Format

Create your schedule in a CSV file with this format:

time,W,R,G,B
04:30,0,0,0,0
06:00,20,60,36,12
12:00,100,70,85,100
18:00,40,100,60,20
20:30,0,0,0,0

• time: 24-hour format (HH:MM), e.g., 04:30, 18:00
• W, R, G, B: Channel values from 0 to 100
• Maximum 24 schedule points
• Blank lines are ignored

See examples/exampleCSV.csv for a complete example.

Examples

Example files are in the examples/ directory:

• exampleCSV.csv - Sample schedule file
• exampleQR.png - Sample QR code

Contributing Your Own Schedules

Have a lighting schedule you'd like to share? We'd love to add it to the examples!

To submit a schedule:

1. Export your schedule from the Fzone Solo app as a QR code
2. Email the QR code image to batzel@gmail.com with:
   • Your name (for attribution)
   • A brief description of what the schedule does (e.g., "High-intensity midday boost for fast-growing plants" or "Gentle sunrise/sunset for low-light tank")
   • Any other relevant details (tank size, plant types, etc.)

Submitted schedules will be added to the examples/ directory with proper attribution, helping other users discover new lighting patterns for their aquariums!

Getting Help

fzone-solo-qr --help
fzone-solo-qr decode --help
fzone-solo-qr encode --help

Troubleshooting

"Could not decode QR code"

• Make sure the QR code image is clear and not too small
• Try cropping the image to show only the QR code
• Ensure OpenCV is installed: pip install opencv-python

"Command not found: fzone-solo-qr"

• Make sure you've installed the package: pip install -e .
• Or use the wrapper script: python3 fzone_solo_qr.py decode qr.png

System Information

This software was developed and tested with:

• Light Model: Fzone Solo Nano LED Aquarium Light
• Platform: Android
• Date: January 14, 2026

Developer: John B Batzel
Contact: batzel@gmail.com

License

MIT License