A small, open-source Android app that remembers birthdays and helps you wish people a happy birthday, by SMS (fully automatic), or Signal / Molly / WhatsApp (prefilled, one tap).
Inspired by Birday.
- Import birthdays from your phone's contacts, or add them by hand (birth year optional)
- A list sorted by whose birthday is next, showing the age they're turning
- Choose what happens on each person's birthday:
- Remind me: a notification, nothing is sent
- Auto SMS: Wishday sends the text itself at your chosen time
- Signal: a notification that opens Signal with the message already typed; you tap send
- A default message template with
{name},{fullname}and{age}placeholders, plus per-person overrides - An optional reminder 1–14 days ahead
- Star important people and give them their own early gift reminder (3 days to 1 month ahead), with gift ideas shown in the reminder
- Stats: birthdays by month, big birthdays coming up, birthday twins, star signs and more
- Color themes (Sunset, Ocean, Forest, Berry, Midnight, or your wallpaper's colors) with light, dark or system mode
- English and Spanish
- Failed texts are retried automatically (up to 3 more times, 15 minutes apart), and you're told whether each one really went out
- Export and import birthdays as CSV, for backups, moving phones, spreadsheets, or bringing them in from another app
- Import a Birday backup directly, to switch over in one step
- Match people to your contacts by name, reviewing each match with a quick yes/no swipe, and optionally save their birthdays into your contacts
- Quick add, plus one-tap buttons on the next birthday to message them on Signal or Molly, text, call or share
- People born on Feb 29 are celebrated on Feb 28 in non-leap years
- No internet permission, no accounts, no tracking. Everything stays on the device.
Signal has no public API, and other apps can't send messages through it. Wishday does the closest thing it can: it opens Signal's smsto: handler so the right chat opens with the draft filled in. If that handler isn't available, it falls back to Signal's share sheet, where you pick the contact.
If you want fully automatic Signal sending, the usual route is signal-cli linked as a secondary device on an always-on machine. Adding that as an optional backend is a good candidate for a future contribution.
Automatic SMS needs the SEND_SMS permission. Google Play only allows that permission for apps set as the device's default SMS app. Wishday is meant for F-Droid and GitHub releases, where that restriction doesn't apply. Store metadata is in fastlane/metadata/android.
That's READ_PHONE_STATE, which Android requires to list the SIM cards in a dual-SIM phone. Wishday asks for it only when you open the SIM picker in Settings, and uses it only to show which SIM sends your texts. It never reads your phone number, IMEI or call state. If you don't pick a SIM, it's never requested, and texts go out on the phone's default SIM for SMS.
| Piece | File |
|---|---|
| Room database of people | data/Person.kt, data/PersonDao.kt |
| Date math and message templating | birthday/Birthdays.kt |
| Contact import | contacts/ContactImporter.kt |
| Contact matching and birthday writing | contacts/ContactMatcher.kt, contacts/ContactWriter.kt |
| SMS sending | messaging/SmsSender.kt |
| SMS results and retries | messaging/SmsResultReceiver.kt, work/SmsRetryWorker.kt |
| CSV export and import | backup/BirthdayCsv.kt |
| Birday backup import | backup/BirdayBackup.kt |
| Opening Signal | messaging/SignalLauncher.kt |
| Daily check (WorkManager) | work/BirthdayWorker.kt |
| Compose UI | ui/ |
Once a day, at the send time you choose (9:00 by default), BirthdayWorker checks who has a birthday. It sends SMS, posts the Signal prompts and reminders, records that each person was greeted that year, and schedules the next run. If the phone was off at the send time, the check runs the next time the app is opened that day. People are never greeted twice in one year.
./gradlew assembleDebug # app/build/outputs/apk/debug/app-debug.apk
./gradlew testDebugUnitTest # unit testsRequires Android 8.0 (API 26) or newer.
Made by Daniel Stuckless.