Note: this document is still a work in progress.

Birday LTS

This repository is based on the 2.1.0 release of https://github.com/m-i-n-a-r/birday. You can see the content of the original README at the bottom of this page.
Why isn’t it a direct fork? Because after the changes i made, I couldn’t for the life of me find a way to have it marked as a fork in a way that wasn’t excrutiatingly cumbersome. Heck, it took me long enough to even figure out how to upload everything. Thus, it’ll probably be archived and replaced when the next stable version is released.

Why does it exist?

The original author, @m-i-n-a-r is frequently very busy and rarely updates the app, which means users and some translators won’t see it in their language for a very long time. This repo hopes to make Birday more accessible to users, easier to test for translators, and maybe help the original author keep it up to date by updating it with the latest translations from the upstream master.

Installation

There are several ways to do this, let’s start with the most convenient.

F-Droid

As far as I can tell, @Poussinou took on the responsibility to maintain Birday on F-Droid. Considering how F-Droid works, updates are likely contingent on m-i-n-a-r’s publishing of releases. We’d have to contact Poussinou directly to make this version available there, but i personally couldn’t find any contact information.

Play Store

As for Google Play, I’ll try to convince m-i-n-a-r to periodically push out updates to the Play Store so you can:

Sideloading

If neither prove to be viable options, or the version you need isn’t available yet, you can head over to the Releases and tap on the APK to download it to your phone. Navigate to it in your file manager and tap it. You may be prompted to allow installing apps from foreign sources and a see a security warning from Play Services (which you can safely ignore, it’s just appearing because the app is unsigned).
Important!
If you already installed Birday from another source, you’ll need to uninstall it first. Before doing so, make sure to make a backup from the app’s settings menu and move it somewhere safe, also write down the values of any settings you wish to keep, because all of this data will be removed in the installation process.

Contributing

The main objective here is to make sure all translation related changes in the original repository are also carried over to this one.

You can help in several ways:

• If you are contributing translations to Birday, make sure you also open a pull request here, it would be particularly helpful to others if you also link to the upstream pull request.
• If someone doesn’t do the above, you can do it for them.
• You can also help by just using the app in different languages and sending feedback.

Improving this documentation would also be of great help!
Depending on your level of expertise, you might need some help. Feel free to reach out in the Issues tab, or take a look at these resources:

• Translation guide (If your language has special rules regarding plurals, (eg. in Croatian: 0-1 godina, 2-4 godine…) take a look at this)
• How to build the app (Particularly useful if you’re impatient for the next release!)
• Pull requests

Original README:

Birday

An open source app to remember birthdays and events without having to open Facebook, set alarms or rely on Google Calendar.

Introduction

This is an open source app to remember birthdays in a fast, light and beautiful way. No less, no more. I had this idea considering that Google Calendar doesn’t display an automatic notification the day of the birthday, and sometimes i need to remember a birthday for a person who is not in my Contacts. Also, adding too much birthdays to the calendar makes it messy and i prefer to manage them separately. The main focus of this app is being easy to use, clean and lightweight. I’m always glad to add features, but only important and really useful features!

Translations (guide and info below)

Features

• Notification the day of the event (with selectable time)
• Additional notification up to 7 days before the event
• Fetch the existing birthdays from the contacts app, images included!
• Easily backup and restore your saved events!
• insert an event manually, just specifying a name, an optional surnamen an image and a date (with optional year)
• Choose your favorite events to see detailed information about them and a countdown for each one
• Tap on an event to see every possible detail and the available actions
• The birthdays are also automagically backed up in cloud by Google Play Services when the app is installed from Play Store
• A set of stats (zodiac, average age and much more) when more than 5 events are inserted, plus an animated counter
• Easily delete, modify and share the saved events!
• Each favorite event has a note field
• Easily hide the top cards to display the list in fullscreen
• A nice searchbar, to quickly search a person in the saved events
• Quick apps launcher
• Light and dark themes (Android 10 dark mode supported)
• Selectable accent (no app restart needed, 12 choices)
• Shimmer effect (it can be disabled) and confetti, because why not
• Name first or surname first choice
• Notification only for favorite events
• Hide and show images
• Dark and light minimal widget
• Beautiful animations (and animated notification icon)
• Multiwindow / freeform full support
• Animated splashscreen and app intro, dynamic layouts and more
• Small and optimized apk size
• Many languages available!

Screenshots

Download

The app is available through Google Play and F-Droid

Credits and contributions

Birday uses some open source libraries, just a few:

• Material Dialogs
• Konfetti
• App Intro
• Shimmer

Currently, Birday supports the languages in the above table. If you want to translate the app in any other language or update an existing translation, just contact me or send a pull request: you’ll be quoted both on Github and in the Play Store description. For a detailed guide on how to translate the app, refer to the Wiki

This app was written during my free time as a training. It was first published on May 1, 2020. Many good devs helped me understanding the best practices and they taught me a lot of useful tricks. A special thank to every contributor here and on Reddit. and God bless Stack Overflow.

GitHub

View Github