Humidorly Sign in

Guides

User's Guide

Humidorly watches the humidity and temperature in your humidors, warns you when something goes wrong, and keeps track of your cigars. This guide covers the iPhone app and the website. For first-time setup, see the Quick Start Guide.

How Humidorly works

Back to contents

Three parts work together:

  1. Sensors sit inside your humidors. Each one measures humidity and temperature and sends it to the Hub by Bluetooth.
  2. The Hub sits in the same room. It listens to the sensors and sends one reading per sensor per minute to Humidorly over the internet. If the internet drops, the Hub keeps the readings and sends them when it's back.
  3. The app and the website show your readings, send your alerts, and hold your cigar collection and journal. The website is app.humidorly.com. It has almost everything the app has. Wi-Fi setup needs the iPhone app, because it uses Bluetooth.

The app has five tabs: Home, Cigars, Journal, For You and You. Two buttons sit at the top right of every tab. The bell opens your alerts. The + opens a menu: Log a smoke, Add purchase, Scan a band, Log weigh-in, Add pack and Add a humidor.

Humidorly never changes what a sensor really read. Corrections from calibration are kept alongside, so your history is always honest.

Your account and household

Back to contents

Your account comes ready with your kit. You get a "Set your password" email, choose a password, and log in with the username the email gives you. Forgot it later? Tap Forgot password on the sign-in screen and we email you a link.

Your household is your private space. Its humidors, sensors, Hubs, cigars and alerts are shared by everyone in it. No other household can see them.

Adding people. The owner can add a partner or family member. Tap your name at the top of the You tab, then Invite code. The other person signs up with it. Each person gets their own login, journal, ratings, chat and taste. Only the owner can add or remove people, and only the owner can restart, update or reset a Hub.

Display choices are under You → Display:

Account settings, under You → Account, change your email or password, or log out. Delete my account is at the bottom of the You tab.

The Hub

Back to contents

The Hub is the small box that listens to your sensors. Keep it plugged in, in the same room as your humidors, out in the open. Walls, metal cabinets and microwaves weaken the signal.

Its page. Go to You → Devices and tap your Hub. Everyone in the household sees:

Owner controls on the same page:

Changing Wi-Fi. Stand near the Hub and tap You → Devices → Wi-Fi setup. Pick the new network and type its password. The website can't do this, because it needs Bluetooth. You can also plug in a network cable at any time.

Moving the Hub. Unplug it, move it, plug it back in. Readings taken while it was off are lost, but nothing else changes. Keep it within range of your sensors.

A second Hub. For humidors in another room, you can buy another Hub with its own sensors. Add it from the app with the same setup steps.

Reset kit. Puts a Hub and its own sensors back the way they arrived, for example before you move house. The owner does it from You → Devices → Reset kit, or Settings on the website. The Hub forgets its Wi-Fi. Its sensors leave their humidors and go back to their factory calibration. Your account, cigars, journal and past readings are all kept. Other Hubs keep working. Afterwards, set it up again in the iPhone app, near the Hub. Type a humidor's old name and the sensor goes back into it, with its history.

Sensors

Back to contents

Each sensor has a sticker number (1, 2, 3…) and lives in one humidor, shelf or cigar box at a time. All your sensors are listed under You → Devices → Sensors. Tap one to see its battery, signal, calibration and where it is.

Where to put it. Inside the humidor, among or beside the cigars. Keep it off the humidity pack, the water tray and the glass. In a humidor with shelves, one sensor per shelf gives the best picture. A shelf with no sensor borrows the nearest shelf's reading, and says where it came from: "from Drawer 2".

The room sensor. Leave one sensor out in the room, not in any humidor. Humidorly compares each humidor with the room. That's how it spots lid openings, scores how well each humidor seals, and forecasts your packs. Without one, Home says "No room sensor". To make a sensor the room sensor, open it and move it to The room.

Moving a sensor. Open the sensor and pick its new humidor or shelf. Its history stays with the humidor it was in. The new humidor's history starts from the move.

Its screen. Our sensors show the same corrected numbers as the app. If no one can see a sensor, turn its Screen switch off to save battery. It takes about 10 minutes to reach the sensor.

Batteries. You're told when a battery falls under 20%. Swap it, and the sensor carries on with its history and calibration.

A sensor you already own. Humidorly can also read these Bluetooth sensors: SensorPush HT.w and HTP.xw, Govee H5075, Inkbird IBS-TH2 and SwitchBot Meter Plus. Other models from those brands don't work yet. The owner taps Add a sensor on the Sensors page. The app lists sensors the Hub has heard in the last 10 minutes, with live readings. Breathe on yours to see which one it is, then pick where it goes. For SensorPush, turn it on once in the SensorPush app first. These sensors work like ours, but their own screens show their own numbers. SensorPush doesn't report its battery. Calibrate them when the app offers.

Humidors, shelves and cigar boxes

Back to contents

Humidorly keeps your cigars in three kinds of place:

Adding a humidor. Tap + → Add a humidor. One step per screen:

  1. Kind: electronic humidor, cabinet, desktop, travel, Tupperdor, tray, cooler or other.
  2. Model: type the make and model. If it's new to Humidorly, we look it up for you: shelves, size and upkeep chores. Tap I don't know the model to skip.
  3. Name and shelves. Rename, add or remove shelves.
  4. Seasoning: say whether it's new or dry and needs seasoning. See Seasoning a new humidor.
  5. Panel setting (electronic only): the humidity and temperature set on its own panel. Your limits follow it, and alerts say how far off it is.
  6. Chores: keep, change or drop each proposed chore, and add your own.
  7. Sensors: move sensors onto its shelves.
  8. Cigars: move cigars in from other humidors, shelf by shelf.
  9. Tidy up: old boxes left empty are offered for archiving. Their history is kept.

Limits. A shelf uses its own limits if you set them, else its humidor's, else the household's: 63–71% humidity and 60–72°F. Change them from the humidor's page.

Chores are reminders like "Change the water" or "Check the door seal". Each is due a set number of days after you last did it. The reminder comes at 9 AM with Done, Snooze (ask tomorrow) and Skip. If a humidor's humidity slides for about a day, you may get an early nudge: "The water may be low."

Cigar boxes. When you add cigars, tick It's a box. Give how many came in it, the box price and the box date. A box is sealed until the first cigar comes out. To box cigars you already have, tap Put in a box on a humidor or shelf. Moving a box moves all its cigars. A box with no sensor shows the reading of where it sits. When its last cigar leaves, choose to keep the empty box or put it away.

Archiving. A humidor with no cigars can be archived from its page. Its history is kept. Home shows Archived humidors at the bottom, where you can bring one back.

Humidor notes. Each humidor has a log of dated notes, by you or by the chat: "Swapped in 3 new 69% packs." Anyone in the household can add or delete one.

Home and your climate charts

Back to contents

Home answers one question: is every humidor in range? From the top:

Each card has a status:

StatusMeaning
In rangeAll is well
WarningOutside its limits right now, but not long enough for an alert
AlertAn alert is open for it
SilentNo reading for 30 minutes
ListeningThe Hub just came online and is waiting for this sensor's first reading

A humidor's page. Tap a card. The chart shows humidity and temperature over 24 hours, 7 days, 30 days or a year, with the room's line beside it. Small marks show lid openings. Below are its shelves, cigars, packs, chores and notes.

Lid openings. Humidorly spots when a lid was opened, by comparing the humidor with the room. Confirm or dismiss each one, or add one by hand. Openings never set off humidity alerts.

Steadiness is a score from 0 to 100. It says how little the room's humidity gets into the humidor. 100 means the room has no effect. It needs 3 days of readings.

Humidity packs

Back to contents

Two-way packs, like Boveda, keep a humidor at their rated humidity until they dry out.

Alerts

Back to contents

An alert tells you when something needs you. You get one message when it starts and one when it clears, with no repeats while a reading hovers near a limit. Every alert shows in Needs you on Home, and behind the bell, with its history.

AlertWhen it starts
Beetle riskAny humidor above 75°F. At once, even during a lid opening and in quiet hours
Humidity out of rangeOutside the humidor's limits for 15 minutes in a row
Temperature out of rangeOutside the humidor's limits for 15 minutes in a row
Sensor silentNo reading for 30 minutes
Hub silentNo word from the Hub for 30 minutes. Breaks through quiet hours
Low batteryUnder 20%
Pack dueA pack is forecast to be spent within 7 days
Calibration dueA sensor's last calibration is over 12 months old
Chore dueA chore reaches its due day
Hub running hot, storage nearly full, or update undoneSomething on the Hub needs a look. Owner only

Tests, seasoning, inspections and the freezer send their own one-time messages. Those are covered in their sections.

An alert clears once the reading is back inside the limit by a margin (1% humidity, or 1°F) for 15 minutes.

When alerts stay quiet. Lid openings never set off humidity alerts. A humidor being inspected holds its humidity alerts for 1 hour. A humidor being seasoned or tested holds its range alerts. Beetle risk always gets through.

Settings, under You → Alerts & notifications:

Push or round-up. To keep your phone quiet, only what needs you soon is pushed: beetle risk, a silent Hub or sensor, too wet, low battery, freezer steps, and humidity or temperature far out of range (5 points or more, or out for 6 hours). Everything else, and short spells just out of range, comes in one round-up a day (9 a.m. unless you change it), and only when there's something new. At most 3 pushes a day; after that they wait for the round-up. Beetle risk always pushes. A humidor that usually sits low, or whose low holding you marked "That's expected for this box", only pushes when it's far out. Home shows "2 humidors need a look" when their report card check-up has something to see.

Telegram. If you use Telegram, you can get alerts there too. Go to Notifications → Link Telegram, and send the code to the Humidorly bot.

Weekly email. Each week you get a summary of every humidor: its range and average, openings, steadiness, pack forecasts, sensor health and alerts. It goes to the email in You → Account → Email.

Calibrating sensors

Back to contents

Every sensor ships corrected. We test each one in a sealed salt box for at least 12 hours before it ships. A yearly salt-test check is optional. Sensors drift a little over time, so Humidorly reminds you once a year. The app walks you through it.

What you need. One of these:

How to do it.

  1. Go to You → Devices → Calibrate, or tap the reminder. Pick one sensor or several.
  2. Pick the kit or salt. Follow the steps on screen. The sensor must not touch the pack or the salt. Seal the bag or jar and keep it out of sun and drafts.
  3. Humidorly moves the sensors into a box called Calibration. It shows on Home: "Settling… about 14 hours left". The humidors they came from say "Sensor away for calibration" and raise no alerts.
  4. When every sensor has settled, you get "Your calibration is ready to review."
  5. The review shows each sensor's correction, such as "reads 4.2 low, +4.2". A sensor that disagrees with the others is flagged. Untick any you don't want to save.
  6. Choose when it applies: From now on, or back to the last calibration, which also corrects past readings.
  7. Tap Put them all back. Each sensor returns to the humidor it came from, and the Calibration box hides itself.

A correction over 5 points gets a warning. Over 10, it can't be saved. That sensor may be faulty, so contact support. Your original readings are always kept. Our sensors' screens show the corrected value within about 10 minutes.

Seasoning a new humidor

Back to contents

A new or dry wooden humidor soaks up water from its cedar lining before it can hold humidity. Seasoning fills the wood first, so it doesn't dry out your cigars.

  1. Mark the humidor as seasoning. Say yes to "needs seasoning" when you add it, or tap Season this box on its page. Give its lining and inside size.
  2. Humidorly estimates how much water the wood needs: "roughly 45 g" for a 100-count box. It's an estimate, and the screen says so.
  3. Put in 84% packs, or your normal packs if you'd rather go slowly. Weigh the packs every 3 days. Write a letter on each pack (A, B, C…); the weigh-in lists them by letter, so you don't mix them up. A bar shows how much water you've given so far.
  4. Humidorly tells you how it's going: "still drinking", "levelled off", or, if it needs help, "drying out" or "low for its packs" with what to do.
  5. It's done when the wood stops drinking. On 84% packs, that's when it holds 69% or more for 3 days: you get "Pull the 84s." On normal packs, it's when the humidity is flat and the packs lose about the same each time: you get "Start the hold test." A box on 72% packs settles in the mid 60s. That's normal.
  6. The hold test runs at least 3 days. A pass ends seasoning. If it sags, put the seasoning packs back.

You can tap Mark it seasoned at any time. While seasoning, humidity range alerts are off. You're warned instead if it stays over 80% for 6 hours, which risks mold. You can move cigars in, but they may dry out or take on too much moisture.

Box tests and the report card

Back to contents

The report card grades every humidor that has a sensor, so you know which ones are good. Open it from any humidor's page: Report card → See all. Each humidor gets a grade from A to F on up to six things, plus an overall score:

QualityWhat it measures
SealHow slowly it loses moisture to the room
RecoveryHow fast it comes back after the lid is opened
SteadinessHow little the room's swings get inside
Water useGrams per day the packs lose
TemperatureHow much of the room's temperature swings reach inside
EvennessThe gap between top and bottom shelves

A missing grade says what it needs, such as "Log two weigh-ins". You can change how much each one counts.

What we see. Each humidor also gets a check-up: a short list of what the app notices, such as "Holding at 65.3%, 6.7 under its 72% packs", each marked Good, Watch or Act, with one thing to try. The Check-up column shows each humidor's most serious one; sort by it to see which need a look. A humidor's Report card page lists them all. The app checks every night; Refresh checks again now, once an hour.

Running a test. Tap Run a test on a humidor's page. While a test runs, that humidor raises no range alerts. Opening the lid spoils a seal or hold test.

Each result goes in the humidor's history, so you can tell whether a new seal helped.

Your cigars

Back to contents

The Cigars tab lists what you have, grouped by humidor and shelf. One search box covers your cigars and the whole catalog. Along the top: All, Ready, Wish list and Favorites. The ⋯ menu has sorting, finished purchases, browsing by brand, and a Collection summary with your total value and what's ready soon or running low.

Adding cigars. Tap + → Add purchase.

  1. Start typing the name and pick it. Or tap the camera and fit the band inside the frame. Humidorly tells you which cigar it is, then asks the size.
  2. Say how many, and where they go.
  3. Add the price, shop and date if you like. Bought a box? Tick It's a box and give the box price.

A cigar new to the catalog is looked up for you: its blend, strength, a tasting summary, and links to the sources. If the band match gets it wrong, tap Report a miss. Sending the photo helps it get better.

Ready to smoke. Each purchase rests for a set time before it's ready. Days out of range don't count. Set the default rest under You → Cigars → Rest and shops, or change it for one purchase.

Moving cigars. Open a purchase and tap Move. Move some or all, now or at an earlier date. Their history moves with them.

Where it's lived. Each purchase has a lifetime chart: the humidity and temperature it has lived in since you bought it, through every humidor. Moves, lid openings and alerts are marked. Tap Compare to lay up to three other cigars over it.

Photos. Add your own photos to a cigar. They stay private to your household. A photo you took yourself can be sent in to share with everyone. We check it first.

The journal

Back to contents

Smoking one. Tap Smoke one on a purchase. The count drops by one and a journal entry opens with the cigar, date, rest time and climate filled in. A rating out of 10, notes and a drink pairing are optional. You can type the notes, or talk them through. For a cigar you didn't own, like one at a lounge, use + → Log a smoke.

Each entry shows the cigar's climate right up to when you smoked it. That helps when one burned or drew badly. Entries can be edited or deleted later.

Friends. Under You → Friends, make an invite code and pass it on. Nothing is shared until you choose: single smokes, or your whole collection. Friends never see your climate, sensors, prices, or anything you didn't share. You can turn sharing off for everyone under You → Privacy & AI → Sharing.

Inspections: mold and beetles

Back to contents

Now and then, look over your cigars for mold and beetles, and fix counts that have drifted. Humidorly reminds you when each shelf is due, and keeps what you found in each cigar's history.

When it's due. By default, every 30 days. A new humidor is due every 14 days for its first 60 days. New cigars get a first look after 7 days. You're asked sooner when there's a reason:

Change any of this under You → Inspections → Inspection timing. A humidor can have its own timing from its Inspections page. The 75°F beetle alert can never be turned off.

Doing one.

  1. Tap Start on the reminder, or Inspect on a humidor or shelf. On a shelf it opens straight to that shelf, so you can pull it out and put it back fast.
  2. Each row is one purchase or cigar box, with its count. Look, count, and tick the box. Fix a count with − and +.
  3. Tap a row for Note, Mold or Beetles. More has Cracked wrapper, Soft and Dry.
  4. The last row is the shelf itself. Check the humidity pack (Fine, Spent or Replaced, or weigh it), and flag mold on the wood, a musty smell, beetle dust or water drops.
  5. Tap All good to tick every row you haven't flagged. A clean shelf takes two taps.
  6. If anything changed, a summary asks why each count changed: smoked, given away, thrown away, miscounted or don't know. Tap Confirm.

You can also tap the mic and say what you see: "The Olivas all look good, one Padrón has mold." It fills in the rows for you to confirm. Humidity alerts for that humidor wait 1 hour while you inspect. The inspection works with no signal and sends when you're back online.

Mold or plume? Plume is not mold, but check closely. It's flat, even, sparkly dust that brushes off as powder with no stain. Mold is fuzzy or stains the wrapper. Not sure? Take a photo and tap Check this photo. When you flag mold, the app shows what to do: brush it off away from the humidor, throw away stained ones, check its neighbors, and turn the humidity down 2 or 3 points. You're reminded to look again after 3 and 7 days.

Beetles. Small round holes or fine dust mean beetles. Bag the whole shelf now, since eggs don't show. Humidorly then walks you through freezing:

  1. Seal the cigars in freezer bags with little air.
  2. Freezer, 3 days, at 0°F (−18°C) or colder. 4 days for a whole cigar box.
  3. Fridge, 1 day.
  4. Counter, 1 day, still bagged, so no water forms on the wrappers.
  5. Put them back.

You're reminded at each step. While they freeze, vacuum the empty humidor and wipe it with half propylene glycol, half distilled water. Frozen cigars don't count as ready. You'll be asked to check again after 14 and 45 days.

For You and your taste

Back to contents

The For You tab suggests cigars that fit your taste. Each person in the household has their own.

Each pick has a one-line reason, like "Cedar, cocoa and cream, which you like". Tap it to see where that came from. Thumbs up keeps a pick. Thumbs down removes it at once. Tap Refresh for new picks.

Getting started. The first time, rate about 15 cigars you know: Loved, OK, Didn't like or Never tried. Suggestions start from there.

My palate shows what Humidorly has learned about your taste, in plain sentences: "You love cedar and cocoa." Each one links to the smokes, ratings or chats it came from. Edit or delete any of them. Delete everything clears what it learned, but keeps your smokes and ratings.

Nudges. You may get a short message when a new release fits your taste, or a cigar finishes resting. At most one a day. Snooze or silence each kind.

Guest sampler. Friends coming over? Pick 2 to 8 ready cigars, and Humidorly lines them up from mild to full. Share the link or QR code. Each guest sees a short card for each cigar on their phone, with no login. It shows nothing personal: no prices, ratings or humidor names. The link ends after 3 days.

Taste matching is off unless you turn it on, under You → Privacy & AI. It suggests cigars rated highly by people with taste like yours. Only ratings are pooled, never names or notes, and no one is ever named.

Chat and voice

Back to contents

You can talk to Humidorly about your cigars and humidors, by typing or out loud. Tap the mic at the top of Home or For You to start a voice chat. The typed chat is under For You → Chats.

It knows your collection, journal, ratings and taste, and every humidor's history. Ask things like:

It can make changes for you: log a smoke, add cigars to a humidor, move cigars, fix a past smoke, add to your wish list, or start a seal, recovery or hold test. It always shows the change first. Nothing is saved until you tap Confirm or say yes.

Humidor help. Name a humidor, and the chat looks at up to 90 days of its readings, the room, pack weights, tests and notes. It tells you which numbers it used. It also writes useful facts into the humidor's notes, like "Swapped in 3 new 69% packs", with Undo. If something new happened, like a finished test, it tells you once.

What it remembers. When it learns something about your taste, it shows a "Noted" line with Undo. Past chats are kept until you delete them.

AI is optional. Turn it off under You → Privacy & AI. Your humidors, alerts, cigars and journal all work without it. You lose the chat, voice, band matching, cigar research and smoke tags.

Settings at a glance

Back to contents

Everything below is on the You tab in the app. On the website, most of it is under Settings.

GroupSettingWhat it does
TopYour nameYour household and its members, and invite codes
TopFriendsAdd friends and choose what they see
AccountEmail, Change password, Log outYour login. The email gets password resets and the weekly summary
DisplayTemperature°F or °C
DisplayHide Cuban cigarsKeep Cuban cigars out of search, picks and band matches
Alerts & notificationsAlert rulesLimits, how long before an alert starts, the beetle limit
Alerts & notificationsQuiet hoursHold alerts overnight
Alerts & notificationsNotificationsPhone, Telegram, nudges and the weekly email
InspectionsInspection timingHow often humidors are due a look
CigarsRest and shopsThe default rest before cigars are ready, and your saved shops
Privacy & AISharingTurn sharing with friends on or off
Privacy & AITaste matchingSuggestions from people with taste like yours
Privacy & AIAI and band photosTurn AI on or off, and whether matched band photos help improve matching
Privacy & AIVoiceVoice chat choices
DevicesYour HubHealth, updates, restart
DevicesSensors, CalibrateYour sensors, adding one, calibrating
DevicesWi-Fi setup, The Hub's light, Reset kitHub setup and help
BottomDelete my accountRemoves your login

Troubleshooting

Back to contents

ProblemWhat to do
The phone can't find the HubCheck it's plugged in and the light is on. Turn on Bluetooth and keep the phone close. Try again.
"Turn on Bluetooth"Turn on Bluetooth, and allow it for Humidorly in the iPhone's Settings.
Wrong Wi-Fi password (2 blinks)Type it again.
The Hub can't see the network (2 blinks)Move the Hub closer to the router, or check the network isn't hidden.
No internet, or a hotel-style sign-in page (3 blinks)Pick another network, or plug in a network cable.
Humidorly isn't answering (4 blinks)Nothing to do. We've been told. Try again later.
Updating (long, short)Wait for the light to stop, then try again.
"Only the owner's phone can re-run Wi-Fi setup"Ask the household's owner to do it from their phone.
You changed your Wi-FiOnce the Hub has been offline for 2 minutes, it offers setup again. Run Wi-Fi setup near the Hub.
Every sensor shows SilentCheck the Hub first. If its light isn't steady, it's offline.
One sensor shows SilentMove it or the Hub closer. Thick wood, glass and metal shorten the range. Check its battery.
"Listening for Sensor 1…" during setupNormal for the first few minutes. Pull its battery tab and keep it near the Hub.
Readings look wrongCalibrate the sensor. See Calibrating sensors.
Too many humidity alertsWiden the humidor's limits, or make alerts wait longer under Alert rules.
No alerts on the phoneCheck You → Notifications and the iPhone's notification settings. Check quiet hours.

The Hub keeps readings it couldn't send while the internet was down. It catches up once it's back.

Help codes. After 3 failed setup tries, the app shows a short code like W2-7K3QXA, and a Contact support button. Put the code in your email. It tells us exactly which step failed.

Privacy and support

Back to contents

Your data is your household's. No other household sees your humidors, cigars, journal or alerts. Our staff who prepare kits and help customers see only setup and health details, never your cigars, journal, notes or chats.

The full privacy policy has the details.

Deleting your account. Tap Delete my account at the bottom of the You tab. If you're the owner and others share your household, pick who takes over. The steps are also on the Delete your account page.

Contact us.

The Android app is in early testing. Email us if you'd like to try it.