Operations

AquaLens App Handbook

The complete AquaLens feature reference — every tab, tool, and Lab explained, covering both freshwater and saltwater setups, from first-time setup through predictive alerts, health diagnosis, and reef mapping.

AquaLens App Handbook
Everything you need to set up, understand, and get the most out of AquaLens — from first launch through expert-level tank management.

Welcome to AquaLens

AquaLens is your AI-powered aquarium command centre. It brings together species identification, equipment analysis, stocking intelligence, water chemistry tracking, light schedule management, growth monitoring, health diagnosis, and predictive maintenance in one place.

The app works for both freshwater and saltwater tanks — and it adapts to your setup. Freshwater and saltwater have different hardware, different chemistry, different labs, and different visual mapping tools. This guide covers both and tells you which sections apply to each.

Two ways to use this guide:

Core principle: The more complete your data, the smarter every analysis. Tank specs, hardware, residents, logs, and photos all feed the AI — the value compounds every week you use it.


Part 1: Setup Journey

Follow these steps in order the first time you use AquaLens. Each step builds on the last.

Step 1 — Get Your Bearings

AquaLens has five main tabs at the bottom of the screen:

You can manage multiple tanks in AquaLens. Each gets its own complete set of views, data, and AI analysis — useful when you're running a display tank and a quarantine or breeding setup alongside it.



Part 2: Feature Reference

Use this section to go deep on any feature. Each section stands alone — jump to what you need.

The My Tank Tab — Your Aquarium Headquarters

My Tank has up to nine views organised into two rows. Saltwater tanks skip the freshwater-only Breeding view.

Primary tabs (always visible):

Secondary tabs (tap the ··· button):


Setting Up Your Tank — The Details

Tank Settings

Go to My Tank → Settings (gear icon) and fill in:

Set water type before adding any hardware. The app builds your entire hardware and lab experience around it.

Hardware — Freshwater

Go to My Tank → Care and add each piece of equipment. Enter make and model wherever possible — the AI recognises specific product profiles.

Filter

Enter make and model (e.g. "Fluval 307", "Oase BioMaster 350"). The Filtration Lab calculates real-world GPH accounting for head pressure and media load, turnover rate, and biological capacity against your actual bioload.

Light

Enter make, model, and length (e.g. "Week Aqua R90 Pro", "Fluval Plant 3.0 36 inch"). The Lighting Lab calculates PAR at surface, mid-water, and substrate depths — and becomes significantly more accurate when you also set up a light schedule (see below).

Heater

Enter make, model, and wattage (e.g. "Eheim Jager 150W"). The Heater Lab calculates whether your wattage is sufficient for your room-to-tank temperature differential.

Wavemaker (if you run one)

Enter make, model, and flow rate. The app uses this to assess circulation coverage, dead spot risk, and flow compatibility with your residents.

You can add multiple units of any type — the Labs combine them. Two filters? Add both. Two heaters? Add both.

Hardware — Saltwater

Saltwater tanks run more hardware. Add every piece — each has its own Lab analysis.

Enter make and model wherever possible. For each piece, the Lab will analyse real-world performance — not the manufacturer's marketing spec.


Light Schedules

AquaLens models your daily lighting programme — not just the fixture, but exactly when it ramps up, peaks, and dims. This powers schedule-aware PAR analysis in the Lighting Lab.

Building a Schedule

  1. Go to My Tank → Care → [your light] → Light Schedule
  2. Tap Add Time Point
  3. Set the time (e.g. 08:00) and each channel's intensity (e.g. White 60%, Blue 40%)
  4. Choose the ramp to the next point: Linear (smooth fade) or Instant (hard cut)
  5. Add as many points as your programme needs: sunrise ramp, peak, afternoon fade, sunset, moonlight

Manual Entry First

Screenshot scan is still being validated, so most users should enter the schedule manually. The important part is capturing the real time points, channel intensities, and ramp style from your light's app.

AI Schedule Review

Once a schedule is set, tap AI Review to get:


The Nitrogen Cycle Tracker (new tanks)

If your tank is new, AquaLens shows a Nitrogen Cycle tracker on your tank home screen.

It tracks you through three phases:

  1. Ammonia spikeNitrosomonas bacteria are colonising your filter media
  2. Nitrite spikeNitrospira bacteria are catching up
  3. Cycle complete — Ammonia and nitrite both read zero; nitrate is detectable

Log your test results in the Journal every day. The tracker projects your completion date based on your actual bacterial conversion rate — not a generic estimate.

Alongside the tracker, AquaLens runs an AI Cycle Checkup automatically whenever something significant happens: a phase transition, a stall, unusually fast progress, or a livestock safety concern. You can also trigger it manually at any time from the tracker widget.

The checkup returns a structured analysis: where the cycle has been, where it currently is, where it's heading, up to four specific next actions, things to watch for, and a retest window. Confidence is rated high/medium/low based on how much logged test data it has to work from — another reason to log every day.

Fishless cycling with AquaLens:

Do not add livestock until the cycle tracker shows complete. This is the most important rule in the hobby.

The Journal — In Depth

The Journal is your evidence trail. Every parameter reading, every maintenance action, every observation creates the dataset your AI analyses are built from.

What gets auto-logged

What you log manually

Water tests — the most important log entries:

Maintenance:

Observations:

Water Story

After logging a water test, tap Water Story. Instead of reading individual numbers, you get a narrative interpretation of your full parameter panel: what the pattern means, what likely caused it, and what to do about it. It reads all parameters together as a system — not in isolation.

A pH reading of 6.8 means nothing without KH context. Water Story reads them as a pair.

Care Tasks and Custom Reminders

AquaLens tracks your maintenance schedule automatically and surfaces tasks as they come due.

Built-in tasks (auto-configured from your hardware and stocking data):

Creating custom reminders:

  1. Go to My Tank → Care → Custom Reminders
  2. Tap Add Reminder
  3. Set the task name, interval in days, and optional push notification time

Good candidates for custom reminders:

Completing any reminder — built-in or custom — logs it to your journal automatically.


AI Compatibility Check

The AI analyses your complete ecosystem for:

How to run it:

  1. Go to My Tank → Residents
  2. Tap Run AI Compatibility Check
  3. Review: overall ecosystem score, issues ranked by severity, specific species pairs flagged, recommended changes
The AI is deliberately critical. A warning about a German Ram in the wrong community is easier to act on before you buy it than after.

The Camera — Species Identification

Tap the AquaLens logo (centre of the nav bar) to open the camera.

Identifies:

What you get back:

Capture tips:


The Kitchen Lab — Scan Labels

In My Tank → Lab → Kitchen Lab, point the camera at any fertiliser bottle, supplement container, or fish food packaging.

The AI reads the guaranteed analysis or ingredient list and:

Any bottle you scan becomes a one-tap dosing preset. No manual entry.


The Labs — Freshwater

Navigate to My Tank → Lab.

Filtration Lab

Real-world filter performance against your specific bioload.

Lighting Lab

Whether your light delivers usable energy where your plants actually are.

Heater Lab

Whether your heater can maintain temperature against your room.

Nutrient Lab (planted tanks)

Exact dosing calculations for any fertiliser or dry compound.

  1. Enter your product (brand name or dry salt — e.g. "Tropica Specialised" or "KNO3")
  2. Set your target (e.g. "raise NO3 by 10 ppm")
  3. Get the exact dose in mL or grams for your tank volume
  4. Save as a named preset for one-tap future use

Supported methods:

Preset ideas: "Weekly Macro" · "Iron Monday" · "Post-Trim Recovery" · "Post-Water-Change Reset"

Maintenance Health Lab

System health estimate from your logs.

Growth Lab — Visual Comparison

Measures plant growth by comparing two photos.

  1. Tap Select Photos → choose Before and After
  2. Enter the subject name (e.g. "Monte Carlo carpet")
  3. Tap Run Comparison

Returns: growth percentage estimate, health score with trend direction, colour analysis (chlorosis, pearling, pigmentation), growth pattern (spread, runners, branching), problem indicators (algae, holes, melting), and specific recommendations.

Weekly photos from the same angle and lighting give the highest confidence comparisons.

Ghost Growth — Live Overlay

In your Gallery, tap any photo and select Ghost Growth. A live camera view overlays on that photo so you can see exactly how much your plants have grown since it was taken — no processing, just a real-time side-by-side.

Energy Lab (OPEX)

Running cost of your complete hardware setup.

Inventory Tracker

Consumable stock tracking so you never run out at the wrong time.


The Labs — Saltwater Additions

All freshwater labs apply. Saltwater adds these:

Skimmer Lab

Protein skimmer capacity vs your reef bioload.

Return Pump Lab

Actual sump turnover accounting for your plumbing.

Flow Lab

Total wavemaker circulation modelled for a reef context.

ATO Lab

Whether your auto top-off keeps pace with evaporation.

Reactor Lab

Reactor media performance and lifespan.

UV Lab

UV steriliser effectiveness validation.

ICP Analysis Lab (Pro — saltwater)

Import your ICP-OES test report from any external lab (Triton, ATI, Fauna Marin, etc.).


Analytics Tab

My Tank → Analytics turns your journal logs into charts.

Freshwater:

Saltwater adds:

What Analytics is for:

Use it to spot things you cannot see in daily readings — a nitrate baseline that's crept up 5 ppm over six weeks, an alkalinity that swings more than it should between water changes, a pH that's consistently lower than your target.

You're not looking for today's number. You're looking for the direction the trend is going.

Predictive Alerts (Pro)

Predictive Alerts go further than threshold notifications. Instead of alerting you when a parameter is at a danger level, they alert you when your trend data projects it will reach that level — giving you time to act before the problem exists.

Setting up an alert:

  1. Go to My Tank → Analytics → Predictive Alerts
  2. Choose a parameter and set your threshold (e.g. Nitrate: 40 ppm)
  3. Set the alert type:

Available parameters:

Alerts appear on your Home screen and as push notifications. Tap any alert to go directly to the relevant parameter chart.


Health Tab

My Tank → Health (Pro)

AI Diagnosis

Describe what you're seeing — the AI cross-references your recent water test data, stocking list, and journal history before suggesting any disease cause. Water quality accounts for the majority of fish illness; the app checks this first.

It returns likely causes ranked by probability, with treatment options, urgency level, and what to watch for next.

Treatment Tracking

Quarantine Log

Mortality Log


Reef Map (Saltwater) and Plant Map (Freshwater)

My Tank → Reef Map or Plant Map (Pro)

Reef Map

Visual coral placement planning built on photos of your actual tank.

Plant Map (freshwater)

Visual layout tool for planned aquascapes.


Breeding Tab (Freshwater, Pro)

My Tank → Breeding


AquaGuide — AI Chat

Tap the chat bubble icon (top right of your tank home screen) to open AquaGuide.

AquaGuide knows your tank: specs, hardware, residents, recent journal entries, and logged test results. Every answer is calibrated to your specific setup — not generic internet advice.

Examples of what to ask:

Freshwater:

Saltwater / Reef:

AquaGuide is your first port of call when something looks off. It doesn't replace testing and observation, but it's the fastest way to make sense of what you're seeing.


The Library — Species Reference

Browse 280+ species entries across freshwater and marine systems.

Each entry includes: name, images, parameter ranges, diet, compatibility, care difficulty, minimum tank size, and reef safety where applicable.

Search by name or keyword. Filter by type, difficulty, or water type. Add to your tank or wishlist directly from the species page.


Guides — Expert Knowledge Base

In-depth technical guides, organised by category:

You can also write custom guides — personal protocols, breeding notes, tank-specific routines. They live alongside the expert guides at the top of this tab.


Tank Pulse Widget

Add the Tank Pulse widget to your phone's home screen for an at-a-glance tank check without opening the app.

The widget shows your tank's hero photo, the next care task due, and a key metrics summary.

To set your hero photo: Open your Gallery, tap any photo, and select Use for Widget. It updates immediately.

Tapping the widget opens directly to your journal or care task list, depending on the quick action you choose.


The Hub — Community

The Hub tab connects you with other AquaLens keepers:


Part 3: Ongoing Use


Suggested Routine — Freshwater

Daily (2 min):

2–3× weekly (5 min):

Weekly (15–20 min):

Monthly (20–30 min):


Suggested Routine — Saltwater / Reef

Daily (5 min):

2–3× weekly (10 min):

Weekly (20–30 min):

Monthly (30–45 min):


Pro Features

AquaLens is free for core logging, identification, and basic analysis. Pro unlocks the advanced layer.

Free includes:

Pro unlocks:

You can trial Pro free. Pro features are clearly labelled throughout the app.


Pro Tips


Safety Notes

AquaLens is a decision-support tool — it augments your judgement, it doesn't replace it:


Setup Checklist — Freshwater

Follow these steps in order on your first session:

  1. ✅ Enter tank specs: volume, depth, water type, temperature target, room temperature
  2. ✅ Add hardware: filter, light, heater — and wavemaker if you run one
  3. ✅ Set up your light schedule manually from your light's app
  4. ✅ Add your residents with accurate quantities
  5. ✅ Create your baseline journal entry — first water test of the tank
  6. ✅ Run AI Compatibility Check
  7. ✅ Scan your fertiliser bottles in the Kitchen Lab and save dosing presets
  8. ✅ Set up at least one Predictive Alert (Nitrate, at your personal warning threshold)
  9. ✅ Create any custom reminders your routine needs (CO2 check, plant trim, etc.)
  10. ✅ Take your first tank photo and tap Use for Widget
  11. ✅ Add the Tank Pulse widget to your home screen

Setup Checklist — Saltwater / Reef

  1. ✅ Enter tank specs: volume, depth, sump volume, water type, temperature, room temperature
  2. ✅ Add all hardware: sump/filter, protein skimmer, return pump, wavemaker(s), ATO, heater, light, reactor, UV steriliser
  3. ✅ Set up your light schedule manually from your light's app
  4. ✅ Add all livestock: fish, corals, and invertebrates with accurate quantities
  5. ✅ Create your baseline journal entry — full parameter test: pH, NH3, NO2, NO3, salinity, Ca, Alk, Mg, PO4
  6. ✅ Run AI Compatibility Check
  7. ✅ Scan supplement and food bottles in the Kitchen Lab
  8. ✅ Set up Predictive Alerts: Alkalinity (low), Nitrate (high), Phosphate (high)
  9. ✅ Set up custom reminders: ICP test interval, reactor media check, UV bulb lifespan, wavemaker clean
  10. ✅ Take your first tank photo and tap Use for Widget
  11. ✅ Add the Tank Pulse widget to your home screen
  12. ✅ Open Reef Map and start planning your coral placement

Welcome to smarter fishkeeping.

Put this guide to work

AquaLens tracks your cycle, reads your test strips, and turns guides like this into reminders and next steps for your actual tank.

Get AquaLens Free