Cigarette Book Guide

Everything Cigarette Book can do

This guide covers every feature: logging cigarettes, your smoke-free time and record, the week, calendar and chart, circles, Siri, widgets, Apple Watch, iPad, Mac and iCloud. The screenshots use a sample user, Alex, who has cut down from a pack a day, runs a circle at work and is in one with family.

  1. Log a cigaretteThe button at the bottom of Home
  2. Add the ones you forgotTap a day in the week
  3. Beat your recordThe ring on Home
  4. Start a circleCircles → +
  5. Invite peopleSend the link or show the QR code
Contents
  1. Your first launch
  2. Logging a cigarette
  3. A day's cigarettes
  4. Smoke-free time and the record
  5. The week and the calendar
  6. The chart
  7. Starting a circle
  8. Inviting people and approving them
  9. Joining someone's circle
  10. Inside a circle
  11. Leaving, removing and deleting
  12. Siri and Shortcuts
  13. Widgets and controls
  14. Apple Watch
  15. iPad and Mac
  16. iCloud and syncing
  17. Notifications
  18. Coming from the old Cigarette Book
  19. Every setting, explained
  20. Cigarette Plus
  21. Help and troubleshooting

Your first launch

There's nothing to set up and no account to make. Cigarette Book opens on Home, ready to log, and keeps everything in your own iCloud.

Home, with Log a Cigarette at the bottom.
Home, with Log a Cigarette at the bottom.
Circles, the people you're quitting with.
Circles, the people you're quitting with.
Settings, kept short.
Settings, kept short.

The three tabs

TabWhat it's for
HomeHow long since your last cigarette and your record, today and the last 30 days, this week, and the chart. Log a Cigarette is pinned at the bottom.
CirclesEvery circle you're in, each with its record holder, and circles you've asked to join. A red badge counts people asking to join yours.
SettingsCigarette Plus, names from Contacts, Siri and Shortcuts, and support. iCloud only shows here when something needs your attention.
Used the old Cigarette Book?Your cigarettes come across by themselves. See Coming from the old Cigarette Book.

Logging a cigarette

A cigarette is just a moment: the minute you smoked it. Logging one takes two taps.

Log a Cigarette, pinned above the tabs.
Log a Cigarette, pinned above the tabs.
Set to now. Tap Log Cigarette to save.
Set to now. Tap Log Cigarette to save.
  1. Tap Log a Cigarette at the bottom of Home. The date and time are already set to now.
  2. Tap Log Cigarette.

Smoked it a while ago? Change the Date or Time before saving; the note under them changes to "Logged for…" so you can check. Times still to come can't be picked.

One a minute

If a cigarette is already logged at the minute you've picked, Cigarette Book says so in orange and won't save another: nobody smokes two in one minute, so a second one is almost always the same cigarette logged twice. The same goes for your iPhone and Apple Watch: a cigarette logged on both, for the same minute, before they synced, ends up as one.

Without opening the appTap the + on a widget, use the Control Center button, press the Action Button, or say Log a cigarette in Cigarette Book.

A day's cigarettes

Tap any day up to today, in the week on Home or in the calendar, to see its cigarettes.

A day: each cigarette with the time since the one before.
A day: each cigarette with the time since the one before.
  • Each cigarette shows its time and how long it came after the one before, like "8h 26m since the last", even when that one was the day before.
  • The heading sums the day up: "3 cigarettes · longest gap 13h 08m".
  • A day with none says Smoke-free day.

Add one you forgot

Tap Add a Forgotten Cigarette. It opens on that day at the current time of day; set the time and save.

Delete one logged by mistake

Swipe the cigarette to the left and tap Delete (on a Mac, click the bin beside it, or right-click it). It goes from all your devices, and your smoke-free time and record are worked out again.

Smoke-free time and the record

The green card at the top of Home is the heart of the app.

On the way: 62% of the way to the record.
On the way: 62% of the way to the record.
A new record: the ring becomes a trophy.
A new record: the ring becomes a trophy.
  • Smoke-free for: how long since your last cigarette, like "1d 2h", with when that was: a time today, a weekday this week, or a date before that.
  • The ring fills toward your record, the longest you've ever gone between two cigarettes. The percentage in it is how far along you are.
  • The chip under it says what's left, like "16h 11m to beat your record". Before your second cigarette it says "Your record starts now".

When you pass your record, the card says New record!, the ring turns into a trophy, and the chip turns gold: "9h 50m past your old record of 1d 18h". A notification tells you at the moment it happens, even with the app closed.

The three tiles

TileWhat it counts
TodayCigarettes logged today.
Last 30 daysCigarettes in the last 30 days, today included.
RecordYour record, in gold. While you're setting a new one it says Record · live and counts on with you.

Times are shown as the two largest units: "45m", "5h 20m", "2d 4h".

The week and the calendar

Each day is a disc, coloured by how many you smoked, with the count underneath.

0Smoke-free 21–3 54–6 87–9 1210 or more 7Still to come
The calendar, opening on this month.
The calendar, opening on this month.
Scroll up for earlier months.
Scroll up for earlier months.

The week on Home

The week starts on the day your region uses. Swipe it sideways a week at a time; This Week brings you back. Today has a dark ring. Days before your first cigarette, and days to come, show no count.

The calendar

Tap the month's name or the calendar icon above the week. Months run down the screen, newest at the bottom, each with its total and daily average, like "October 2026 · 115 cigarettes · 3.7 a day". Scroll up for earlier months; tap Today to come back. Tap any day to open it.

Without Cigarette PlusThe week and the calendar go back six months, this one included. A line above the oldest month says earlier months are part of Cigarette Plus. Nothing is deleted; they come back when you subscribe.

The chart

Below the week, your cigarettes as bars: by day, week, month or year.

Day: the last week.
Day: the last week.
Week: six weeks at a time.
Week: six weeks at a time.
Month: six months.
Month: six months.
Year: since your first cigarette.
Year: since your first cigarette.
  • Pick Day, Week, Month or Year above the bars. Each bar has its count on top.
  • The heading totals the bars in view with the daily average, like "850 cigarettes · 5.4 a day", and the dates they cover.
  • Swipe the bars back, as far as your first cigarette. They rescale to the tallest in view once you stop.
  • Tap a bar for its own count and average; tap it again to let go.

Starting a circle

A circle is a group of people quitting together, ranked by their records. You can be in as many as you like, for free.

New Circle: give it a name.
New Circle: give it a name.
Your circles, each with its record holder.
Your circles, each with its record holder.
  1. Open Circles and tap + (or Create a Circle if you have none yet).
  2. Give it a name, like "Office Quitters", and tap Create.

The circle is made in your iCloud straight away, with its invite link and QR code ready. Creating one needs iCloud and the internet.

Who can see whatMembers see each other's iCloud name, smoke-free time and record. Never how many anyone smokes, or when. Everyone's full log stays in their own iCloud.

Inviting people and approving them

Anyone with your circle's link can ask to join. Nobody gets in until you approve them.

Invite People: the QR code and the link.
Invite People: the QR code and the link.
Requests show at the top of the circle.
Requests show at the top of the circle.
Approve, Decline or Block each one.
Approve, Decline or Block each one.

Invite

  1. Open the circle and tap the person button at the top, then Invite People.
  2. Tap Share Invite Link to send it in Messages, Mail or anywhere. In person, they can point their iPhone's Camera at the QR code.

It's the same link for everyone, and all it lets anyone do is ask.

Approve

When someone asks, you get a notification ("Leila Haddad wants to join your circle. Tap to review."), the Circles tab gets a red badge, and the circle shows 2 people want to join. Tap Review:

ButtonWhat happens
ApproveThey're in. They show as "Approved. Waiting for their phone to send their data." until their card arrives.
DeclineThey're turned down, and can ask again.
BlockThey're turned down and can't ask again.

Joining someone's circle

Tap the invite link you were sent, or scan the owner's QR code with your iPhone's Camera.

The invite: who invited you and what they'll see.
The invite: who invited you and what they'll see.
Request sent. The owner approves you.
Request sent. The owner approves you.
Waiting in your Circles until then.
Waiting in your Circles until then.
  1. Cigarette Book opens on the circle's name and who invited you, with what members will see of you.
  2. Tap Ask to Join.
  3. The circle shows in your Circles with a dashed border and Waiting. When the owner approves you, you're told ("You're in Night Shift Quitters"), and it opens up with everyone's ranking.

Changed your mind? Tap Cancel Request on the waiting circle.

Don't have Cigarette Book yet?The link opens a page that shows the circle and how to get the app. Install it, then tap the link again.

Inside a circle

The record holder sits on top in green and gold; everyone else is ranked below.

Office Quitters, which Alex owns.
Office Quitters, which Alex owns.
Family, which Alex joined.
Family, which Alex joined.
  • Ranked by record: each person's longest time without a cigarette, counting the stretch they're on now. As someone's smoke-free time passes another person's record, they move up, live, without waiting for a sync.
  • Each row shows the rank, the name, how long they've been smoke-free and their record. You're outlined in green.
  • Joining: people you've approved whose phones haven't sent their card yet.
  • Pull down to fetch the latest cards; opening a circle fetches them too.

The person button at the top opens Circle Settings: requests (in your own circles), members, Invite People, and leaving or deleting.

Leaving, removing and deleting

Members, Invite People and Delete Circle.
Members, Invite People and Delete Circle.
  • Remove someone from your circle: swipe their name left in Circle Settings and tap Remove (on a Mac, click the bin beside it).
  • Leave a circle you joined: Circle Settings → Leave Circle. You can ask to join again with an invite link.
  • Delete your own circle: Circle Settings → Delete Circle. Everyone in it loses the circle.

None of these touch anyone's log.

Siri and Shortcuts

Five shortcuts are ready as soon as Cigarette Book is installed, on iPhone, iPad, Mac and Apple Watch. Settings → Siri & Shortcuts lists them.

Siri & Shortcuts in Settings.
Siri & Shortcuts in Settings.
ShortcutSayWhat it does
Log a CigaretteLog a cigarette in Cigarette BookLogs one now. In the Shortcuts app, give it a time for one smoked earlier.
Delete Last CigaretteUndo cigarette in Cigarette BookDeletes the last one logged, after asking.
Smoke-freeHow long have I been smoke-free in Cigarette BookYour smoke-free time and record.
Cigarettes TodayHow many cigarettes today in Cigarette BookToday's count and the last 30 days'.
Circle StandingWho's leading my circle in Cigarette BookWho has the record and where you stand. Your first circle, unless you name one.
How many cigarettes today in Cigarette Book
0 cigarettes today, 112 cigarettes in the last 30 days.
Who's leading Family in Cigarette Book
Aisha Khan leads Family, with a record of 9 days, 4 hours. You're number 3 of 4.

Give any of them your own phrase in the Shortcuts app, or run one from the Action Button, Back Tap or an automation. The Siri shortcut you made with the old Cigarette Book keeps working. Siri and Shortcuts are part of Cigarette Plus.

Widgets and controls

Long-press your Home Screen or Lock Screen, tap Edit, then Add Widget, and choose Cigarette Book.

WidgetWhereWhat it shows
Smoke-freeHome Screen (small), Lock Screen, Mac desktopThe time since your last cigarette and your record. On the Home Screen it's the green card, with a + that logs a cigarette there and then. On the Lock Screen: a ring filling toward the record, a line, or a card.
This WeekHome Screen (medium), Mac desktopSmoke-free, the record, today, a +, and the week's days.
CircleHome Screen, Lock Screen, Mac desktopA circle's record holder and where you stand; the medium size ranks the top four. Edit the widget to pick the circle.
Log a CigaretteControl Center, Lock Screen, Action ButtonOne tap, logged now.

Tapping a widget anywhere but its + opens the app. Widgets are part of Cigarette Plus; without it they show a lock and open the plans.

Apple Watch

Cigarette Book on your Watch syncs with iCloud by itself, so it works without your iPhone nearby.

Apple Watch: smoke-free 1d 2h, record 1d 18h
Apple Watch: today 0, last 30 days 112, and this week
Apple Watch: Log with Date Today and Time Now
Apple Watch: Circles with each record holder
Apple Watch: Settings
  • Home: your smoke-free time and record; turn the Digital Crown for today, the last 30 days and the week. Tap a day for its cigarettes, and swipe one to delete it.
  • The + logs a cigarette. Left alone, it's logged for the moment you tap Log Cigarette; tap Date or Time to pick another with the Crown.
  • Circles: swipe left for each circle's record holder and your place in it; tap one for everyone's ranking. Creating, inviting and approving are on your iPhone.
  • Complications: Smoke-free and Circle, for your watch face and the Smart Stack.

The Apple Watch app is part of Cigarette Plus.

iPad and Mac

Home on iPad

On iPad, Cigarette Book works as on iPhone, with the tabs at the top. On a Mac, the tabs are a sidebar and Home sits in a column in the window; move the week with the arrows beside it or a two-finger swipe, and press ⌘ R to refresh a circle, or ⌘ [ to go back to Circles. Widgets go on the Mac desktop.

iCloud and syncing

Your log syncs through your own iCloud account. Sign in to iCloud with the same Apple Account on each device; there's nothing else to set up.

  • Offline? Everything is saved on the device first. Cigarettes logged offline, and your card in each circle, go up as soon as you're back online.
  • Changes arrive by themselves: iCloud tells your other devices when something changes, and opening the app checks again.
  • Circles are kept in their owner's iCloud. Your log never leaves yours; only your card goes into each circle.

When iCloud needs attention

Settings shows an iCloud section only when something's wrong:

MessageWhat to do
Not Signed In to iCloudYour cigarettes are kept on the device and sync once you sign in to iCloud in the Settings app. Circles need iCloud.
iCloud Is UnavailableCheck iCloud in the Settings app. Everything syncs once it's back.
Data from Another iCloud AccountThe log on this device was synced with a different iCloud account. Tap Remove Data… to use this account's log; the other account's stays in its iCloud.
iCloud Storage Is FullFree up space or upgrade your iCloud storage. Until then your cigarettes stay on this device, you can't create circles, and members' updates can't reach the circles you own.

If a circle's owner runs out of iCloud storage, the circle says so ("Your updates can't reach this circle: Aisha's iCloud storage is full") until they free some up.

Notifications

Cigarette Book asks once, the first time there's something to tell you.

Cigarette Booknow
New record!

You've beaten your record of 1 day, 18 hours without a cigarette. Keep going.

Cigarette Booknow
Office Quitters

Leila Haddad wants to join your circle. Tap to review.

Cigarette Booknow
You're in Night Shift Quitters

Your circle can now see your smoke-free time and record.

Turned them off? Settings → Notifications → Allow in Settings. On Apple Watch they arrive from your iPhone.

Coming from the old Cigarette Book

Every cigarette the old app kept comes across by itself, once: the ones on your iPhone the first time the new app opens, and the ones in your iCloud the first time it syncs. Make sure you're signed in to the same iCloud account you used before. The old data is only read, never changed. The Siri shortcut you made to log a cigarette keeps working.

Every setting, explained

Settings on iPhone.
Settings on iPhone.
SettingWhat it does
iCloudOnly when something needs attention. See iCloud and syncing.
Cigarette PlusYour free week's end date, or Active, with See Plans and Manage Subscription.
ContactsUse Names from Contacts shows people in your circles with the names and photos you saved for them. Matching happens on your device; nothing from Contacts is uploaded.
NotificationsOnly when they're turned off: Allow in Settings.
Siri & ShortcutsEvery shortcut and what to say. See Siri and Shortcuts.
SupportEmail Support (with technical details attached), Message Us, the Website and the Privacy Policy.

Cigarette Plus

Keeping your record is free. Plus adds the conveniences.

FreeCigarette Plus
Logging, your smoke-free time and record, the week, calendar and chart for the last six months, and Circles, as many and as big as you like.The Apple Watch app and complications, widgets and the Control Center button, Siri and Shortcuts, and your whole history.

Everyone gets a free week of Plus from the day they first download, with nothing to sign up for. After it, it's $2.49 a year, or $9.99 once for life, and one purchase covers your Family Sharing group. Purchases belong to your Apple Account, so they come back on any device signed in with it; use Restore Purchases on the plans if one doesn't. Your record always counts your whole log, Plus or not.

Help and troubleshooting

A cigarette I logged on my Watch isn't on my iPhone

Check that both are signed in to the same iCloud account and online, then open Cigarette Book on the iPhone: opening it fetches what changed. If Settings shows an iCloud message, follow it.

It says a cigarette is already logged at this minute

Cigarette Book keeps one cigarette a minute. Pick another minute, or open the day to see the one that's there.

Someone's waiting to be let into my circle, but I see no request

Open the circle's settings: it reads the circle from iCloud fresh, so new requests show. Make sure you're online.

I asked to join, and nothing's happened

The owner has to approve you in their app. Your circle shows as Waiting until then, and you're told once you're in. You can cancel the request from Circles and ask again.

Someone in my circle shows as "Approved. Waiting for their phone…"

Their card comes once their phone has synced. Ask them to open Cigarette Book while online.

Still stuck? Settings → Support → Email Support attaches technical details that help us find the problem, never when you smoked or anyone's names. Or email [email protected]. More on Cigarette Book Support.