FAQ & guide

How to do it, step by step

Answers to the most common questions about Gurglee: creating tanks, logging readings, setting reminders and managing your data. Tap a question to open it.

Tanks

How do I create a tank?

Open the Tanks tab and tap “Add tank”. Give it a name (e.g. “Reef 300L”), pick the water type (freshwater, brackish, saltwater, reef) and — if you need it — add the setup features, such as Planted. Then save: Gurglee already suggests the right parameters and target ranges for that kind of aquarium, so you can start right away.

The water type is a single choice, features add to it: a heavily planted freshwater tank is “Freshwater” + “Planted”, not one instead of the other.

My tank is freshwater and heavily planted: which one do I pick?

Both. In the tank form the water type is a single choice (freshwater, brackish, saltwater, reef), while features are multi-select: turn on Planted and the tank stays freshwater and planted.

What you get: the Diet & nutrition section shows both plans (meals for the fish and plant fertilisation), and a new tank also tracks plant nutrients — phosphate, potassium, iron and CO₂ — with suggested ranges you can edit. They're Expert-level parameters, so they don't clutter the screen in Basic mode.

If the tank already exists, open it, tap Edit tank and turn on Planted: the plant parameters are added then (the ones you already track are left alone). And if you created the tank as “planted” with an earlier version of the app, the update converts it to “freshwater + planted” by itself: nothing is lost.

What is the tank's “start date” for?

It's the date the tank has been running since. You set it when you create the tank (or later, via Edit tank): if you don't change it, it defaults to today, so remember to correct it if you're logging a tank that's been running for a while.

It mainly helps the Tank doctor: the tank's age changes the hypotheses, because the same value or symptom reads differently in a freshly started tank (still cycling, unstable biology) versus a mature one. Setting the right date makes the diagnosis more accurate.

How does the guided cycle setup work?

When you create a new tank, Gurglee offers setup mode: a short wizard that walks you through the nitrogen cycle, the 4-8 weeks a tank needs to “mature” before it can host animals.

It explains the three stages (ammonia peak → nitrite peak → nitrate), asks a few questions about your tank (new or seeded water, with or without fish, live/dry rock or DSB for saltwater) and proposes the right reminders. The tank then shows a cycle card that reads your readings and tells you where you stand — celebrating milestones and telling you clearly when it's ready for its first guests. You can also start it later from the tank menu, and finish it whenever you like. The wizard, the cycle card and the milestones are free; the automatic reminders, the comparison chart (your cycle vs the typical curve) and the fishless ammonia-dose calculator are Premium.

How do I edit or delete a tank?

Open the tank from the Tanks tab, then use the top menu to edit it (name, water type, features such as “Planted”, aliases) or delete it. Deletion is a soft-delete: the tank disappears from the app but the removal still syncs, keeping your devices aligned.

What are tank aliases for?

Aliases are alternate names you use for a tank when speaking or typing (e.g. “reef”, “big marine”). When you log a reading in natural language, Gurglee uses the name and aliases to figure out which tank you mean, so you don't have to pick it every time.

How do I share a tank with someone else?

Open the tank, tap the menu at the top and choose “Share tank”. Pick what the person can do and send them the ready-made message that appears (WhatsApp, email, whatever you like): it has a link and, underneath, the invite code. Tapping the link opens Gurglee with the code already filled in — and if they don’t have the app yet, the link takes them to a page that tells them how to get it, on a phone or on a computer. The code, on the other hand, always works, even read out loud: they open Gurglee, Account → “I have an invite” and paste it. An invite is good for one person only and expires after a week.

  • Observer — sees everything (readings, charts, diary, livestock), changes nothing and gets no task reminders.
  • Collaborator — logs readings, ticks off and postpones tasks, writes in the diary. Cannot change the tank's setup.
  • Co-owner — does everything except delete the tank and manage the other members, which stay yours.

You can change someone's role or revoke access at any time from the same screen: revoking takes effect immediately and, the next time they connect, the tank's data disappears from their device. If they had logged something offline that had not gone up yet, those few entries stay with them — that is their work, not yours — and the app tells them they can delete it: it never reaches your tank either way.

Two things are never shared, not even with a Co-owner: expenses, which stay private, and data export, which stays with the tank's owner.

People you invite pay nothing. AI features stay tied to the plan of whoever uses them, not to the tank owner's plan.

A note on reminders: on a shared tank the reminder reaches whoever can act on it — Collaborator and Co-owner — and nobody knows whether someone else has already done it until you sync. Agree on who does what. Anyone who joins as an Observer gets no reminders at all: they could neither tick them off nor silence them. For the same reason their home page does not list the due tasks of the tank they are watching: they can still find them whenever they want, in the Tasks tab and on the tank's own page.

Don't mix it up with the “Tank care sheet”: that one is a sheet you send or print for whoever looks after the tank for a week, with no account and no way to change anything. This is real access, with their own account and role, for someone who cares for the tank alongside you.

Someone removed my access to a shared tank: what happens to the data?

The tank disappears from your device the next time you connect after the revoke. It is not the app being petty: that data belongs to whoever owns the tank, and without the share we have no claim to keep it here. Nothing changes on their aquarium — the deletion happens only here, it never goes back up.

There is one case where the tank stays in the list, marked “Access ended”: when you had logged something offline that had not gone up yet. Those entries are not the owner's data, they are your work, and we do not throw them away for you: they stay there until you have moved them where you need them, and then you delete them with the “Delete local data” button. They will never reach the tank of whoever revoked your access.

If they invite you again later, everything starts over: the data comes back down, and whatever was left pending can be retried from Account.

What is the “sample tank”, and how do I remove it?

It's a demo tank you can open on first launch, instead of starting from an empty app. It holds two months of readings across five parameters, one value out of range, some logged maintenance and a few catalogue species: it shows you what the app looks like once it's full, before you've entered anything.

The data is made up, and the tank is labelled “Sample” wherever it appears — in the list and in the detail header — so it can't be confused with your own.

It never leaves this device: it isn't synced to your account, it doesn't show up on your other phones, and it never reaches the Assistant or the Tank Doctor. For the same reason the Doctor won't diagnose it: that would be an opinion about numbers that don't exist.

To remove it: open it and tap “Throw the sample away” in the box at the top. It goes, along with all its made-up data, and your own tanks are untouched. When you create your first real tank the app asks you anyway — but you can keep it if it's useful for comparison.

Readings & input

How do I remember to test my parameters?

Open the parameter's card (tank → tap the parameter) and, under the title, tap “Remind me to test it”: pick how often — weekly is the starting suggestion — and it becomes a reminder like any other, with a phone notification and an entry among your due tasks.

If you don't know which frequency to pick, we suggest one: the same card shows “How often to test it”, with the pace that makes sense for your tank type — KH moves in days in a reef and in months in a freshwater tank — and one tap sets it. The suggestion also looks at your last reading: if a value is outside its range, instead of changing your pace forever it offers one extra check, just once, to see whether it is coming back.

You don't have to tick it off: when you log the reading the reminder moves forward by itself, because the app has already received the test. The log still records that it was done.

The same line shows how long it has been since you measured that parameter. If the reminder is overdue the line turns red and says by how many days; if you set no reminder there is no alarm at all — we don't invent a frequency you never chose.

You can also set a general check reminder without picking a parameter: any reading on that tank closes it. It's free, like every reminder.

How do I log a reading by typing the way I talk?

Go to the Measure tab and type naturally, e.g. “calcium 420 in the reef” or “kh 7.8”. Gurglee recognises parameter, value, unit and tank, converts to the reference unit and shows you its interpretation with a confidence score. Confirm with a tap and it's saved. Everything runs on-device, even offline.

Can I log readings by voice?

Yes. In the Measure tab tap the microphone icon and dictate the value (e.g. “nitrate twenty in the freshwater”). Voice recognition is the operating system's on-device engine; the recognised text goes through the same parser as typed input. It needs the microphone permission. Where dictation isn't available (e.g. Windows) the app tells you and you can type instead.

Why does Gurglee ask me to confirm the reading?

Short chemical symbols are ambiguous (e.g. mg can mean magnesium or milligram) and numbers can use commas or dots. That's why Gurglee always shows the interpretation — “Calcium · 420 ppm · Reef 300L” — with a confirm step: any parser mistake is fixed with a tap before saving.

How do I add a reading manually, without natural language?

Open a tank, pick the parameter and tap “Add reading”: choose value, unit and the measurement date/time (which can differ from now). Multiple readings per day are allowed. Each value is also converted to the parameter's reference unit for the charts.

Where do I see charts and trends?

Open a tank and tap a parameter: you'll see the trend chart with the target band highlighted, the analysis (min, average, max, last change) and the last 5 readings. The rest are one tap below, under “See all readings”, which opens the Reading history.

The tank dashboard shows at a glance how many parameters are balanced and which are out of range, with an alert when a value leaves the limits you set.

Where can I see every reading I've logged?

In the Reading history: all your readings together, grouped by day and, within a day, by parameter. You can get there from three places:

  • the Measure tab, via the “Reading history” card at the bottom (all tanks);
  • the tank menu, already filtered to that tank;
  • “See all readings” under a parameter's chart, already filtered to that tank and parameter.

At the top you'll find filters for period (last 7, 30, 90 days, all time, or a custom date range), parameter (more than one at a time) and tank. The parameter chips only list the ones you have actually measured. Tap a row to open that reading and correct or delete it.

How do I change a parameter's target (min/max)?

Each tank has its own ranges: the same temperature can be 24–26 °C in a reef and 18–22 °C in a coldwater tank, and neither affects the other.

Two ways, same result: from the tank, go to manage parameters and set the target min and max and the preferred unit; or open the parameter (the card with the chart and recent readings) and tap the “target …” line under the title, the one with the pencil.

You can leave a field empty to set no limit on that side. When a reading falls outside the range, the tank flags it as “out of range”.

Which parameters can I track?

Gurglee ships a catalog of 19 parameters with their units and conversions: temperature, pH, ammonia, nitrite, nitrate, KH (alkalinity), GH (general hardness), TDS/conductivity, calcium, magnesium, phosphate, salinity, CO₂, iron, potassium, silicate, copper, dissolved oxygen and redox (ORP).

Each tank follows only what it needs: on creation Gurglee turns on the ones typical of its type (calcium, magnesium and salinity in a reef; GH in freshwater), and from the tank's parameter management you can switch the others on or off and change the ranges. Basic mode shows the essentials, Expert adds the advanced ones. Every parameter has its own what it is · how to measure it · typical values sheet, from the ⓘ icon.

How do I show my readings in a group or to a shop?

Open the tank, tap Tank menu and choose Parameter card. The app builds an image with the latest reading of every parameter you track and lets you share it wherever you like: WhatsApp, a Facebook group, a forum, stories, or saved to your gallery.

The card is meant to be read by someone who doesn't have the app: every value carries its unit, your tank's target range and an arrow showing whether it is rising or falling compared with the previous reading. Values outside the range are marked in words too, not only by colour. A reading older than two weeks shows its own date, so nobody mistakes it for today's.

Before sharing you can leave out the tank's name, its inhabitants or the target values: the choice is remembered for next time. Hiding the targets does not hide out-of-range values — those stay marked, because they are what people are about to answer about.

The preview you see is the image that gets shared. Only what you see there ends up in it: no account data, no location. It is free for everyone, shared tanks included.

Maintenance & reminders

How do I set a reminder or a maintenance task?

In the Activities tab tap “Add” and choose the kind: reminder, water change, fertilization, dosing or medication course. You can link a product and dose, set a recurrence (custom too) and, for medications, an end date. In the Note field you can add details that don't fit in the title (e.g. “siphon the right-hand side”, “double dose if nitrates are high”): you'll see them right on the activity card. When it's due you get a local notification on the device.

How do I mark an activity as done? And if I didn't do it?

In the Activities tab tap “Done” on the activity: the action is recorded in the log and a recurring activity automatically advances to its next due date (or turns off if it was one-off or at the end of its course).

If you did not do it, tap “⋯” next to “Done”:

  • Postpone — move the due date to tomorrow, in 3 days, in a week or to a date you pick. The recurrence stays the same: later occurrences start from the new date, and the notification is rescheduled automatically.
  • Skip this time — jump straight to the next due date. It is not written to the log, because the activity wasn't done: that keeps your maintenance history honest.

Either way, “Undo” in the message at the bottom puts everything back. The same actions are available on the home screen, in a tank's Activities page and in the Diet section.

Where do I see the maintenance I already did?

Under “Recent maintenance”: from the Activities tab (at the bottom of the list) or from a tank's Activities page via “See all”. It's a section of its own, kept apart from the activities still to do.

Entries are grouped by day and, within the day, by type (water change, maintenance, fertilization, medication, feeding, reminder). At the top you get filters by period (last 7, 30 or 90 days, all time, or a date range you pick), type (you can select more than one) and tank.

Tap a row to fix it (date, dose/liters, note) or delete it, just like in the log. All local and free.

Notifications aren't arriving: what should I check?

Due-date notifications are local (no server) and work on the native apps (Android/iOS). On web and Windows they're not available. On mobile, make sure you granted the app the notifications permission in your system settings and that the activity has a next due date set.

Honor/Huawei (MagicOS) — and typically Xiaomi, Oppo and similar — use aggressive battery management that can block or delay reminders even with the permission granted. In Settings → Battery → App launch find Gurglee, turn off automatic management and allow Auto-launch, Secondary launch and Run in background. Also allow Alarms & reminders (exact alarms) in Settings → Apps → Gurglee.

To verify right away, open Menu → Diagnostics and use the test notification: it arrives after about 10 seconds, even with the app in the background.

How do I manage the diet of fish, corals and plants?

Every tank has its own section (from the tank's ☰ menu) that adapts to what lives in it. For each half you get two things: an automatic tip summarising what your catalog-linked inhabitants need, and your own plan where you add food or fertilisers, days and doses.

The two halves coexist: if the tank is planted and also has fish, the section is called Diet & nutrition and shows both the meal plan and the fertilisation plan (macro/micro, iron, CO₂). A plants-only tank keeps just Nutrition, a tank with no plants just Diet. In reef/marine tanks with corals it reminds you that corals feed too (phyto and zooplankton, coral food, target feeding for LPS). It all works like any other activity — recurrence, reminders and “Done” in the diary — free and offline.

I'm going on holiday: how do I leave instructions for whoever looks after the tank?

Open the tank, tap Tank menu and choose Care sheet. You set when you leave and when you are back; the app builds the sheet with everything falling due in those days, day by day: what to do, with which product, how much, at what time.

Repeating activities are expanded: if you feed daily, every meal is on the sheet, not just the first one. Anything already overdue when you leave shows at the top of the first day, flagged “overdue”, and a course of medication that ends mid-period ends on the sheet too.

You can add the name of your stand-in, an emergency contact and free notes — contact and notes are remembered for next time. The sheet already carries a things not to do section (don't overfeed, don't change the water, don't switch off filter and lights), written for someone who knows nothing about aquariums.

Then Share opens WhatsApp, mail and the rest; Print gives you the PDF for the fridge. It's free for everyone.

Livestock & species

How do I add fish, corals or plants to a tank?

Open the tank and go to Livestock to add fish, corals, invertebrates or plants. You can start from the species catalog, which includes reference sheets (needs, feeding, habitat). Corals are split into sections — soft, LPS, SPS, zoanthids, mushrooms and sponges — so you find what you need faster. This way you track who lives in each tank. Can't find the species in the catalog? From the search, when there are no results, tap Add manually: you create a free entry with the name you like (without a catalog sheet). First, though, check it isn't already there under another trade or scientific name.

At the top of the list you get the summary: individuals (how many animals are actually there, adding up the quantities) and species (how many different species). They are two separate numbers, so two “Neon” entries bought at different times still count as 1 species. Livestock marked as deceased is counted separately, as “no longer in tank”.

What are the wishlist and compatibility check?

The wishlist is the list of species you'd like to add. The compatibility check helps you tell whether a species suits your tank and its current inhabitants, before you buy it.

The same check follows you while you add an inhabitant, at three points. Open the catalog from a tank and every species already carries its verdict for that tank, with the reason in brief (“60 L / 200 L”, “Saltwater”): the problem shows up before you pick it. In the inhabitant form you get the full list of findings, and the confirm button turns into “Add anyway”. A full-screen warning appears only for serious cases, such as a marine fish in a freshwater tank.

It is always a warning, not a ban: you can go ahead regardless (a quarantine tank, a juvenile waiting for a bigger tank, or simply because you know what you're doing). The check is based on the catalog, so it doesn't appear for free entries added by hand.

How do I track an inhabitant's growth over time?

Open the inhabitant (from the tank's Livestock section, pencil icon) and scroll to Growth. Tap “Add measurement”, enter the size in cm, the date and an optional note. Gurglee shows a mini chart of the trend plus a few stats (latest, change, average). You can log several measurements over time, edit or delete them. It's free, works offline and is included in your data backup.

Tools

How do I use the dosing calculators?

From the menu (top icon) open the Calculators: water change (with an automatic suggestion of how much to change, sump included), salt, KH and calcium. Enter the required data and Gurglee tells you how much to dose. They're all free and work offline.

How do I see what happens before a water change?

Open a tank, tap a parameter (say Nitrate) and scroll to the “What if…” card. Pick how much to change — 10, 20, 30 or 50% — and read where the value lands: “40 ppm → ~28 ppm”, with the litres for your own tank volume and whether the prediction sits inside the range you set.

It starts from your own last reading, so there is nothing to copy by hand: that is the difference from the Calculators, which stay in the menu for sums about a tank that isn't yours. The card also names the single action that would be enough to get back in range (“to reach 25 ppm you need a change of about 37.5%”) and “Schedule it” turns that into a ready-filled activity.

For alkalinity, calcium and salinity you can switch to the Dose tab: type the grams and see where you end up, overshoot included, before dissolving the extra gram. Grams and litres need the tank volume: if you haven't set it, the card says so.

On some values no prediction appears, and that is not a bug: pH is logarithmic and held by KH and CO₂, while CO₂ and oxygen go back into balance with the air within hours. A number there would be precise and wrong, so Gurglee would rather tell you why it stays quiet. And it is a theoretical estimate in any case: always test after the job.

At the bottom of the card there is “Several actions in a row”, part of the Premium plan: several changes in sequence and, above all, how much the value climbs back in between — estimated from your own readings, and printed next to the number (“about 2 ppm a day, from 5 of your readings over 10 days”). That is the difference that matters: three 25% changes are not one 75% change, and sometimes the answer is that this route never gets there — worth knowing before doing three changes for nothing. If your readings aren't enough to estimate the rise, the screen says so instead of pretending it is zero.

How do I manage products, inventory and expenses?

From the menu open Products (stock of food, fertilizers, medications, equipment, shared across tanks) and Expenses to track costs. You can link an Amazon item to a product: from there you reopen and rebuy it in one tap with “Restock”.

Where do I jot down observations and notes?

Use Notes & journal to record observations, important changes or ideas. It's your logbook: optional title and free text, all saved on the device.

What is the “Tank doctor”?

It's an AI-assisted diagnosis (Premium feature): from the tank menu open Tank doctor, describe the problem in your own words (e.g. “green hair algae on the glass for two weeks” or “the fish breathes fast at the surface”) and the AI replies with hypotheses ranked by likelihood, useful questions and concrete steps. It's a chat: if the doctor asks questions you can reply and refine the diagnosis, and the conversation is saved on your device.

What sets it apart from a generic AI is that Gurglee knows your tank's history: it automatically attaches a summary of your data (recent parameters, out-of-range values, activities) so the advice fits your case. It's opt-in with a dedicated consent and off by default (you can revoke it from your account) and it only answers about fishkeeping (it is not a general-purpose assistant). It is not a vet: these are hypotheses to verify; for serious illness consult an expert.

Transparency (AI Act): answers are AI-generated and labelled “AI-generated” — you are interacting with an AI system, not a person. At the top you can see how many diagnoses you've made today (e.g. “Today 3/15”: an anti-abuse cap, not a quota); if the service is temporarily unavailable you can tap “Retry”.

All conversations are saved on your device: open “Past diagnoses” to review previous ones or start a new chat without losing the old, and long-press a message (or tap the copy icon) to copy it.

How do I avoid repeating how my tank is set up to the Doctor every time?

Fill in the Sheet: in the “Tank Doctor” tap the Sheet section and write down once what the app cannot know by itself — how the tank is set up (substrate, filter, lights, CO₂, skimmer), which water you use and the values of the incoming water, your real routine of water changes and fertilising, how you feed, and above all the history: when it started, diseases and treatments already done, problems that keep returning. The Doctor re-reads it on every diagnosis.

At the top of the sheet there is “What I already know about this tank”: that's the data the app sends by itself (parameters with their latest value, inhabitants, due tasks). No need to repeat it — it's also there to show you what gets sent.

Two things to know. The sheet has a consent of its own, separate from the Doctor's, because it is the only thing that leaves written in your own words: until you turn it on the sheet stays on your device and is sent to nobody (the screen tells you so). And the fields have a character limit: that's not stinginess — a longer context slows every answer down, so two precise lines beat half a page.

If the tank is shared, every member can read the sheet; the owner and Co-owners can change it.

What is the “AI assistant” and how is it different from the “Tank doctor”?

The AI assistant (a Premium feature) is the Assistant tab at the bottom of the screen: ask it anything about fishkeeping in general — “how often should I change the water in a reef?”, “what light do SPS need?”, “how do I pick a filter?” — and it answers in plain words, with a few practical tips and follow-up questions you can tap.

How it differs from the Tank doctor: the assistant answers in general, the doctor diagnoses your tank. If something is wrong in there — algae, sick fish, odd readings — go to the Tank doctor (from the tank menu, or from the button inside the assistant): it reads that tank's recent parameters, out-of-range values, inhabitants and activities, and suggests hypotheses ranked by likelihood.

What gets sent: your question and, at most, your tanks' profile (name, type, volume, age) — never your readings or logbook, which only the doctor needs. It uses the same consent as the doctor (opt-in, off by default, revocable from your account) and only answers about fishkeeping.

One daily limit: assistant and doctor share the same anti-abuse counter — the one shown at the top (“Today 3/15”) is the total of both, not two separate allowances.

Transparency (AI Act): wherever the “AI” mark appears in the app, artificial intelligence is involved, and answers are labelled “AI-generated”. They are general guidance to verify. For questions about how the app works, these FAQ answer for free, without using AI.

Can I try the AI without subscribing?

Yes: your first 2 questions are free, with no subscription and no card. They cover the AI Assistant and the Tank Doctor together — two tries in total, not two per feature — and they don't reset the next day: they're there to show you how they work on your own tank data before you decide.

How many are left is shown in the badge at the top of both screens. You still need an account (the count belongs to it, not to the phone) and the consent to send data to the AI features, which is asked the first time.

The Assistant's ready-made answers — the most common questions, already written inside the app — don't use up tries: they call no model and work offline too.

Once the two tries are gone, the AI stays available with Premium, which has a daily usage limit shared between the two features.

The AI assistant is slow: can it be sped up? And do the “ready answers” use up my limit?

Ready answers are the lightning-bolt suggestions in the Assistant tab when the chat is empty (and in the full list under “More ready answers”). They cover the most common fishkeeping questions — how often to change water, how long cycling takes, why you have algae, how much to feed — with the answer already written by us: it appears instantly, works offline and does not use your daily limit, because no artificial intelligence is queried. For the same reason they aren't labelled “AI-generated”: no model wrote them.

If you type your own question, the AI generates the answer and it now appears as it is written, instead of making you wait at a still screen for the whole thing: you start reading after about a second. In the web version of the app the text arrives all at once at the end, but the timing is the same.

If it still feels slow: the wait depends on external AI services, which are busier at some times than others. A short, precise question costs less than a long one, and for problems in your tank the Tank doctor is the better route anyway — it starts from your data instead of making you describe it.

How do I keep track of live food cultures (brine shrimp, microworms…)?

Open the Tools menu from the home screen and choose Breeding. The Cultures tab lists the types Gurglee knows — brine shrimp, microworms, grindal worms, moina, fruit flies, phytoplankton, copepods, infusoria — each with its own guide: what you need, how to start it, how long it takes and the mistakes that kill it. The guides are readable on any plan, offline too.

To keep the log, tap “New culture”, pick the type, name your container and, if you like, say which tanks it feeds. From there you start a batch: the app knows when it will be ready and marks it “ready today”. When you use it you tap Harvest; if the culture went bad, you mark it failed — that is what makes the success rate honest.

Why batches rather than just the culture: people who hatch brine shrimp start a new one every day, staggered, because nauplii must be fed fresh. The daily question is not “how is the culture doing” but “which batch do I harvest today”, and Gurglee points you at the oldest of the ready ones.

The batch log, timings and yields are part of the Premium plan.

Can I follow a spawning or my coral frags?

Yes, in the other two tabs of Breeding. Unlike cultures, broods and frags live inside a real tank: you pick the tank where it is happening.

Breeding. You record the spawning with species, date and (optionally) the parents, chosen from that tank's livestock, then move the milestones forward as you see them: hatching, free swimming, closing the brood. You can update the survivor count whenever you like — the number is always shown with the date of the last count, because “41” tells you nothing if you don't know when. If you have a live food culture you can link it to the brood: that is what you are weaning the fry on.

Frags. You record the cut with the mother colony (from the tank's corals), the quantity and your plan: keep, trade or sell. When the frag attaches you mark it, and from there you can promote it to livestock with one tap: it becomes an entry in the tank's Livestock with the mother colony recorded, and from that moment it counts towards bioload like any other coral. Promotion is deliberate — twenty frags promoted at once would make a perfectly healthy tank look overstocked.

Both are part of the Premium plan.

Can I hook up my sensors and have readings arrive on their own?

Yes, with Premium: in the menu, under Tools → “API and integrations”, switch the API on and create yourself a key. From there your setup — Home Assistant, Node-RED, an ESP running ESPHome, an aquarium controller, a script on a Raspberry Pi — can send Gurglee a tank, a parameter and a value with a plain HTTP call. The readings show up in the app at the next sync, and in the history they are marked as having come from the API.

It is not a ready-made SmartLife or Tuya integration, and that is not modesty: those services want a commercial contract for production use, and reading your sensors would mean us holding your credentials. The bit that connects your sensor to Gurglee is yours to write — it is not much, and the guide on the site has ready-made examples to copy.

There are two limits, so the history does not fill up with numbers that say nothing: temperature accepts one reading every hour, every other parameter one a day. The screen also has a “Try the call” button that sends a real request without storing anything: it tells you straight away that you mistyped the tank's name, instead of leaving you to wonder why nothing happens.

You see the key only once, when you create it: the server keeps just a fingerprint. Lose it and you revoke it and make another; and if you want to stop everything at once, switching the toggle off is enough.

Can I have the AI's answers read aloud?

Yes. At the bottom of every Assistant and Tank doctor answer there is Listen: tap it and your phone reads the answer out. The same button stops it. It is most useful when your hands are in the tank and you cannot read the screen.

It uses your phone's own voice, the one the system already uses elsewhere: it works offline and the answer's text never leaves your device.

If the button is missing, your device has no voice installed for the app's language. On Android you add one from the system settings, under Text-to-speech (the exact name varies by phone), by downloading the language you need.

One thing to know: with TalkBack or VoiceOver running the button is hidden, because the screen reader already reads the answer and the two voices would overlap.

Data, account & sync

How do I turn on syncing across devices?

Open the Account section (profile icon) and sign in with email and password, with Google, or — on iPhone and iPad — with Sign in with Apple. With an account you can start cloud sync. For your first 14 days after signing up it is automatic for everyone: whatever you log goes up on its own. After that, on the Free plan it becomes manual (“Sync now”), while on Premium it stays automatic in the background. Your local data remains the source of truth, so the app works in full even with no connection.

Why doesn't syncing start by itself any more?

Because your first 14 days since signing up are over — that is the period when it is automatic for everyone. Nothing is broken and nothing is lost: your data is safe on the device, exactly where it has always been, and the app keeps working in full.

From here you have two options: tap “Sync now” whenever you want to send it to the server — the button is in the strip at the top of the tanks screen and in Account, and it stays free forever — or move to Premium, which makes syncing work by itself in the background again.

The strip only appears when something is actually waiting: if you do not see it, everything is already on the server.

I signed in but I can't see my tanks: are they gone?

No. Right after signing in this device is still empty: your account data has to come down from the server first. Until that first sync succeeds, Gurglee doesn't say “no tanks” but “Data not downloaded yet”, with a Sync now button right below.

On the Free plan syncing is manual: that button (or “Sync now” in the Account section) is what downloads your tanks. On Premium it starts on its own right after sign-in. If you're offline nothing comes down: try again once you're back online. Your data stays safe on the server in the meantime.

How do I sign out of an account? And what happens to my data?

On launch Gurglee asks whether you want to sign in, create an account or continue without an account. To leave, open Account and tap Sign out: that account's data is removed from this device and you're back at the start page. That's the point: if you then sign in with a different account, you don't find the previous one's data mixed in.

Nothing is lost: the data stays on the server and comes back on your next sign-in with the same account. If there are changes not synced yet we tell you first, and you can pick “Sync and sign out”.

I signed in with Apple and my email looks odd (@privaterelay.appleid.com): is something wrong?

No, that's expected. If you pick “Hide My Email” during Sign in with Apple, Apple creates a forwarding address for you, like ftn2tk9wzw@privaterelay.appleid.com: that's all we see, while messages still land in your real inbox. It exists so you don't have to hand your personal address to every app.

Two things worth knowing: that account has no password (you always sign in with the Apple button, so “Forgot password” doesn't apply), and if you sign in sometimes with Apple and sometimes with Google those are two different accounts for us, each with its own tanks. You can stop the forwarding any time from Settings → your name → Sign in with Apple on your iPhone.

Can I export or back up my data?

Full export (CSV + JSON backup) and import/restore without duplicates are part of the Premium plan. They let you take your data with you or restore it on a new device.

What does the Premium plan include?

Everything that runs on the device is free forever. Premium adds the features that cost us to run: automatic background multi-device sync, full export/import, the automatic reminders of the guided cycle setup and the AI features (Assistant, Tank doctor and the reading interpretation the parser can't handle); on Android it also removes the ads. Advanced trend analysis and the photo album are still coming. You can still download and use the whole Free plan with no account.

It's on sale: €2.99/month or €19.99/year, from the Android app through Google Play. How to subscribe — renewal, cancelling, restoring purchases — is explained in “How do I subscribe to Premium?”.

If Premium was gifted to you (testers, friends, support), you'll see it in the Account card: there's nothing to pay and nothing to renew, and if the gift has an end date it's written there.

How do I subscribe to Premium? Renewal, cancelling and restoring purchases

Premium is on sale. Here's everything worth knowing before and after buying: where to buy it, how it renews, how to cancel.

Where to buy. From the Android app, through Google Play: open Account → Premium (or tap “Get Premium” on a Premium feature) and pick a plan — €2.99/month or €19.99/year. On iPhone, web and Windows you can't buy it, but Premium bought on Android works everywhere: just sign in with the same account.

A Gurglee account is required: you can't subscribe while signed out. If you open the plans without signing in you still see the prices (knowing the cost is fair enough), but both plans stay locked and there's a Sign in button that takes you to sign-in and brings you back — the plans unlock by themselves. The same applies to Restore purchases. There's a reason: the subscription is tied to your account, not to the phone, and that's what lets it follow you across devices and survive a new phone. A payment made with no account would have nobody to attribute it to, and it would take support to untangle.

Renewal. It renews automatically at the end of each period (monthly or yearly) until you cancel; Google Play handles the payment, we never see your card details. The Account card always shows status and date: “renews on …” or “active until …, then it ends”.

Cancelling. From Account → Manage subscription (it opens your Google Play subscriptions), or straight from Play Store → profile menu → Payments and subscriptions → Subscriptions. Cancelling does not remove Premium immediately: it stays active until the end of the period you already paid for. You don't need to uninstall the app — and uninstalling does not cancel anything.

When it actually ends. At the end of the period you paid for. We keep a small margin — up to two days — so that a delay on our side never costs you Premium you paid for: a store notification arriving late, a phone left offline. It's a technical margin, not an extension of the subscription. After a renewal or a cancellation the app can take up to an hour to notice the change; if you're in a hurry, sign out and back in.

Billing problems. If your card expires or a payment fails, Google retries for a while (grace period): during those days you stay Premium and the app says so plainly, so you can update your payment method without losing anything.

Restoring purchases. New phone, reinstalled app, or Premium not showing? Sign in with the same account and tap Account → Restore purchases. If you bought with a different Google Play account, the restore won't find it: get in touch.

Refunds. They are handled by Google Play (Play Store → Order history → Report a problem). Once a refund is granted, Premium switches off.

Gifted Premium (testers, friends, support): there is nothing to pay and nothing to cancel, and if it has an end date it is shown in the Account card.

Launch code (3 months free). If you received a promo code: open the Play Store → profile menu → Payments and subscriptions → Redeem code, paste it and confirm. Premium switches on right away in the app (if you don't see it, sign out and back in). ⚠️ When the 3 months end the subscription continues as a paid one at the price of the plan shown during redemption: if you don't want to carry on, cancel before it expires — you'll stay Premium until the last free day, with nothing charged. The date is in Account.

General

Does Gurglee work offline? Where is my data stored?

Yes: Gurglee is offline-first. Your aquarium data is stored on the device and that's the source of truth. No account is required to use it. The cloud is optional and only needed if you want to sync across multiple devices.

What's the difference between Basic and Expert level?

Your level filters how much you see: Basic shows the essential parameters for beginners, Expert adds the advanced ones. Change it whenever you like: no data is lost, only what's displayed changes.

Where to change it: open Menu at the top (the grid icon) — the level is the first thing in the sheet — or go to Account. Whichever one is active is always written under the app name, top left.

How do I change the app language?

Gurglee is available in Italian and English. On first launch it follows the device language; you can change it from the account settings. Both the interface and the parameter names and guide change accordingly.

Where can I see what's new in each update?

Under Account → App info → “What's new”: you'll find the release notes for the latest Gurglee updates, newest first, so you know what changed or improved in each version.

Is there a tutorial? How do I replay it?

Yes. On first launch Gurglee shows a short run of cards explaining how the app is laid out: where you create a tank, what the four bottom tabs are for, and where the AI lives. You can skip it at any point with the button in the top right.

Two helpers stay behind afterwards. At the top of the tank list you'll find “First steps”, a small checklist that ticks itself off as you create your first tank, log your first reading, set a reminder and try the Assistant; it disappears once complete, or you can close it with the ✕. And the first time you reach a spot that isn't obvious — the tank menu, the dictation microphone — a callout points it out: “Got it” closes it, “Skip” turns them all off.

To replay it: Tools menu (the grid icon at the top) → Tutorial, or Account → Replay the tutorial. It starts again from the first card and the callouts come back.

When an important new feature ships, the tutorial updates itself: instead of replaying the whole run you'll just get the callout for what's new, with a “New” tag next to the title.

Where do I download Gurglee?

Android: Gurglee is on the Google Play Storeplay.google.com/store/apps/details?id=app.gurglee. It's free, and you don't need an account to start: the Free plan runs entirely on your phone.

iPhone and iPad: Gurglee is on the App Storeapps.apple.com/app/id6795946757. Same deal: free, and it works without an account too.

On any other device (computer, tablet) you can use Gurglee straight from your browser at app.gurglee.app, with nothing to install. From a phone browser you can also add it to your Home screen (“install app”): it then opens full-screen like a regular app.

Windows: the native version is on the way. In the meantime the web version does everything, with two OS-related exceptions: reminder notifications and voice dictation only work in the native apps.

Your data moves between devices only if you sign in with an account: without one it stays on the device where you entered it (see the entry about accounts and syncing).

Can't find the answer? Write to us at gurglee.app@gmail.com: we update this page often based on your questions.